Pterohost docs

Иконка сервера Minecraft: server-icon.png

Как создать и установить иконку server-icon.png 64x64 для Minecraft-сервера: формат, размещение, обновление кэша и решение частых проблем.

Кратко: Иконка сервера - файл server-icon.png размером строго 64x64 пикселей в корне сервера. Поместите PNG туда же, где лежит server.properties, перезапустите сервер - иконка появится в списке серверов лаунчера. Если клиент не показывает обновлённую иконку - удалите сервер из списка и добавьте заново (сброс кэша).

Иконка сервера Minecraft: server-icon.png

Иконка сервера - небольшое изображение 64x64 пикселей, которое игроки видят в списке мультиплеер-серверов рядом с MOTD и счётчиком онлайна. Это первое, на что обращает внимание потенциальный игрок при выборе сервера, и при этом один из самых простых элементов оформления. В 2026 году требования к иконке не изменились со времён Minecraft 1.7.2 - те же 64x64 PNG в корне сервера. Зато инструменты для создания и управления иконками стали значительно удобнее: от онлайн-редакторов пикселей до плагинов с анимацией. В этой статье - полный цикл: создание, размещение, проверка, обновление кэша и решение нестандартных ситуаций.

Pterohost - игровой хостинг с NVMe SSD, DDoS-защитой L4+L7 и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Требования к файлу server-icon.png

Minecraft проверяет иконку при старте сервера и применяет жёсткие ограничения. Если хотя бы одно условие не соблюдено - иконка просто не загрузится и сервер покажет стандартный знак вопроса.

ПараметрТребование
Имя файлаserver-icon.png (строчные, точно)
ФорматPNG (JPEG и GIF не поддерживаются)
Ширина64 пикселя
Высота64 пикселя
Цветовой режимRGB или RGBA (с прозрачностью)
РасположениеКорень папки сервера
Максимальный размер файла~250 KB (практически без ограничений)

Важно про имя файла: регистр букв имеет значение на Linux-серверах. Файл Server-Icon.PNG или server_icon.png работать не будет - только точное написание server-icon.png.

Важно про размер: сервер не масштабирует изображение самостоятельно. Картинка 128x128 или 32x32 будет проигнорирована. Только строго 64x64.

Почему именно 64x64?

Формат фиксирован с ранних версий Minecraft и закодирован в протоколе. Клиент принимает иконку в виде Base64-строки внутри ответа на ping-запрос, и ожидает именно 64x64 PNG. Изменить это ограничение без модификации клиента невозможно.

Как создать иконку 64x64

Вариант 1: онлайн-редакторы

Для быстрого создания пиксельной иконки подходит Piskel (piskelapp.com) или Lospec Pixel Editor (lospec.com/pixel-editor). Оба работают в браузере без установки.

Порядок действий в Piskel:

  1. Создайте новый спрайт: File -> New Sprite.
  2. Установите размер 64x64.
  3. Нарисуйте иконку (логотип, буква, пиксельный персонаж).
  4. Экспортируйте: Export -> PNG -> Download.

Вариант 2: Photoshop / GIMP

Если у вас готовый логотип большего размера:

  1. Откройте исходное изображение.
  2. Измените размер холста до 64x64 (Image -> Scale Image в GIMP или Image -> Image Size в Photoshop).
  3. Используйте алгоритм масштабирования Lanczos (GIMP) или Bicubic Sharper (Photoshop) для наилучшего качества при уменьшении.
  4. Сохраните как PNG: в GIMP - File -> Export As -> .png, в Photoshop - File -> Save As -> PNG.

Совет по качеству: уменьшайте с кратных размеров - 128x128 -> 64x64 или 256x256 -> 64x64 даёт лучший результат, чем, например, 200x150 -> 64x64.

Вариант 3: ImageMagick на сервере

Если нужно конвертировать изображение прямо на хостинге через SSH:

# Установка (Debian/Ubuntu)
apt-get install imagemagick -y

# Масштабирование любого изображения до 64x64
convert original-logo.png -resize 64x64! server-icon.png

Флаг ! после 64x64 игнорирует соотношение сторон и принудительно растягивает до точного размера. Если нужно сохранить пропорции с полями:

convert original-logo.png -resize 64x64 -background transparent -gravity center -extent 64x64 server-icon.png

Вариант 4: Python (PIL/Pillow)

from PIL import Image

img = Image.open("original.png")
img = img.resize((64, 64), Image.LANCZOS)
img.save("server-icon.png", "PNG")

Размещение файла в корне сервера

Структура папки сервера

server/
├── server-icon.png        <- сюда кладём иконку
├── server.properties
├── bukkit.yml             <- (если Spigot/Paper)
├── spigot.yml             <- (если Spigot/Paper)
├── paper.yml              <- (если Paper)
├── plugins/
├── world/
├── world_nether/
├── world_the_end/
└── server.jar

Иконка должна быть в той же папке, что и server.properties. Это корень - не в папке plugins/, не в world/, не где-то ещё.

Загрузка через панель Pterodactyl

Если хостинг работает на базе Pterodactyl (или совместимой панели):

  1. Откройте файловый менеджер сервера в панели.
  2. Убедитесь, что находитесь в корневой директории (обычно /home/container/ или просто /).
  3. Нажмите Upload и выберите файл server-icon.png.
  4. Проверьте, что файл появился в списке рядом с server.properties.

Загрузка через FTP/SFTP

# Через sftp-клиент (например, sftp)
sftp user@your-server-ip
sftp> cd /path/to/minecraft
sftp> put server-icon.png
sftp> ls -la server-icon.png   # проверка
sftp> exit

Или через FileZilla: подключитесь по SFTP, перейдите в корень сервера, перетащите файл.

Перезапуск сервера и проверка иконки

После загрузки файла сервер нужно перезапустить - иконка считывается только при старте.

Как проверить, что иконка загружена

В логах сервера при успешной загрузке иконки нет отдельного сообщения - сервер просто молча применяет её. Признак проблемы - строка в логах:

[WARN] Failed to load server icon

Если такой строки нет - иконка загружена корректно.

Дополнительная проверка через консоль сервера не требуется. Просто зайдите в лаунчер, обновите список серверов и проверьте визуально.

Быстрая проверка размера файла (Linux)

# Проверить размеры PNG без сторонних утилит
python3 -c "
import struct, zlib
with open('server-icon.png','rb') as f:
    f.read(8)  # PNG signature
    f.read(4)  # chunk length
    f.read(4)  # IHDR
    w = struct.unpack('>I', f.read(4))[0]
    h = struct.unpack('>I', f.read(4))[0]
    print(f'Size: {w}x{h}')
"

Или через ImageMagick:

identify server-icon.png
# Вывод: server-icon.png PNG 64x64 64x64+0+0 8-bit sRGB 3.5KB 0.000u 0:00.000

Обновление кэша иконки на стороне клиента

Minecraft-лаунчер кэширует иконки серверов локально. Если вы заменили иконку на сервере и перезапустили его, клиент может продолжать показывать старую иконку до обновления кэша.

Способ 1: удалить и добавить сервер заново

  1. Откройте меню Multiplayer в лаунчере.
  2. Выберите сервер, нажмите Delete (или Edit -> удалить).
  3. Добавьте сервер заново (Add Server), введите IP.
  4. При следующем ping клиент получит свежую иконку.

Способ 2: очистить кэш серверов вручную

Кэш иконок хранится в файлах внутри папки Minecraft:

  • Windows: %AppData%\.minecraft\server-resource-packs\ и %AppData%\.minecraft\saves\ (для серверных иконок - в %AppData%\.minecraft\)
  • Linux: ~/.minecraft/
  • macOS: ~/Library/Application Support/minecraft/

Конкретно иконки серверов закэшированы в JSON-файле %AppData%\.minecraft\servers.dat (бинарный NBT-формат). Проще всего удалить конкретный сервер и добавить заново.

Способ 3: подождать

Minecraft периодически обновляет кэш при каждом обновлении статуса сервера. После замены иконки и перезапуска сервера кэш обновится автоматически в течение нескольких минут - просто обновляйте список серверов (кнопка Refresh).

Анимированная иконка через плагины

Стандартный Minecraft не поддерживает анимацию иконки. Для динамической смены иконок нужны специальные плагины для Paper/Spigot.

AdvancedServerList

AdvancedServerList - плагин для Paper/Spigot 1.19+, позволяет настраивать иконку, MOTD, количество игроков и другие элементы списка серверов.

Установка:

  1. Скачайте актуальную версию с Modrinth (modrinth.com/plugin/advancedserverlist).
  2. Поместите JAR в папку plugins/.
  3. Перезапустите сервер.
  4. Конфигурация создаётся в plugins/AdvancedServerList/profiles/.

Пример конфигурации с несколькими иконками (plugins/AdvancedServerList/profiles/default.yml):

profiles:
  - favicon:
      - "default/icon1.png"
      - "default/icon2.png"
      - "default/icon3.png"
    motd:
      - "<gradient:green:aqua>Мой сервер"
      - "Онлайн: <players>"

Иконки для плагина хранятся в plugins/AdvancedServerList/favicons/default/ как PNG-файлы 64x64. Плагин циклически переключает их при каждом ping-запросе.

ServerListPlus (устаревший, но работает)

ServerListPlus - более старый плагин, поддерживает Paper/Spigot вплоть до версии 1.20. Конфигурация в plugins/ServerListPlus/ServerListPlus.yml.

Пример настройки ротации иконок:

Default:
  Favicon:
    - "favicons/icon1.png"
    - "favicons/icon2.png"
  MOTD:
    - "§aДобро пожаловать!"

Иконки хранятся в plugins/ServerListPlus/favicons/.

Рекомендация на 2026 год: для серверов на Paper 1.19+ предпочтительнее AdvancedServerList - он активно поддерживается и совместим с современными версиями Paper.

Частые проблемы и решения

Проблема 1: иконка не отображается

Симптомы: в списке серверов показывается знак вопроса вместо иконки.

Диагностика:

# Проверить наличие файла
ls -la /path/to/server/server-icon.png

# Проверить размер через file
file server-icon.png
# Должно быть: PNG image data, 64 x 64, ...

# Проверить на ошибки в логах сервера
grep -i "icon" logs/latest.log

Частые причины:

  • Файл называется Server-Icon.png вместо server-icon.png (регистр).
  • Файл в формате JPEG с расширением .png - проверьте через file server-icon.png.
  • Размер не 64x64 - сконвертируйте через ImageMagick.
  • Файл лежит в подпапке, а не в корне сервера.

Проблема 2: иконка размытая или пикселированная

Причина: масштабирование с неправильного исходного размера.

Решение: создайте иконку изначально в 64x64 или масштабируйте вниз с кратного размера (128x128, 256x256).

# Масштабирование с сохранением чёткости
convert source.png -resize 64x64 -filter Lanczos server-icon.png

Проблема 3: иконка не обновляется после замены

Причина: кэш на стороне клиента или сервер не был перезапущен.

Решение:

  1. Убедитесь, что сервер перезапущен после замены файла.
  2. На стороне клиента - удалите сервер из списка и добавьте заново.

Проблема 4: иконка отображается у одних игроков и не отображается у других

Причина: разные клиенты имеют разный кэш.

Решение: это нормально при первоначальной загрузке или замене иконки. Через несколько ping-циклов все клиенты синхронизируются.

Проблема 5: JPEG-файл переименован в PNG

Частая ошибка - скачать JPEG логотип, переименовать в server-icon.png и ожидать, что заработает. Minecraft проверяет реальный формат файла, а не расширение.

file server-icon.png
# НЕПРАВИЛЬНО: server-icon.png: JPEG image data, ...
# ПРАВИЛЬНО: server-icon.png: PNG image data, 64 x 64, ...

Конвертация из JPEG в PNG:

convert server-icon.jpg -resize 64x64 server-icon.png

Проблема 6: иконка не работает на Proxy (BungeeCord/Velocity)

На прокси-серверах (BungeeCord, Velocity) иконку нужно помещать в корень папки прокси, а не backend-серверов. Клиент запрашивает иконку от прокси при отображении в списке серверов.

bungeecord/
├── server-icon.png    <- здесь, для BungeeCord
├── config.yml
├── plugins/
└── ...

Для Velocity:

velocity/
├── server-icon.png    <- здесь, для Velocity
├── velocity.toml
├── plugins/
└── ...

Чеклист: быстрая установка иконки

[ ] Создан PNG-файл размером строго 64x64 пикселей
[ ] Файл сохранён с именем server-icon.png (строчными буквами)
[ ] Файл загружен в корень сервера (рядом с server.properties)
[ ] Сервер перезапущен
[ ] В логах отсутствует строка "Failed to load server icon"
[ ] В лаунчере сервер удалён и добавлен заново (сброс кэша клиента)
[ ] Иконка отображается в списке серверов

Связанные материалы

Если вы настраиваете внешний вид сервера, обратите внимание на настройку MOTD и форматирование сообщений - текстовое описание рядом с иконкой. Для общей настройки производительности и параметров сервера читайте оптимизацию Minecraft-сервера. Если планируете добавить экономику и плагины - начните с Vault и экономики.

Заключение

Иконка сервера Minecraft - простой, но важный элемент узнаваемости. Единственное техническое требование - PNG 64x64 в корне сервера с именем server-icon.png. Создайте иконку в Piskel или GIMP, загрузите на сервер, перезапустите - и готово. Если иконка не появляется, первым делом проверьте имя файла (регистр) и точный размер через file server-icon.png или identify. Для анимированных иконок на современных Paper-серверах используйте плагин AdvancedServerList. Помните про кэш на стороне клиента - после замены иконки удалите сервер из списка лаунчера и добавьте заново.

Pterohost - игровой хостинг для Minecraft с мгновенным запуском, NVMe SSD и защитой от DDoS-атак. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг