- Для версий
- 1.21.✘
- 26.✘
- Исходный код
- https://github.com/cosmo-jar/Image-Display
- Зависимости
- ProtocolLib, PlaceholderAPI
Где это можно использовать?
Преобразуйте любое изображение в сетку текстур голов игроков на основе MineSkin и используйте его в чате, заголовках, TAB, префиксах и суффиксах, неймтегах, голограммах, скорбордах и других местах...Image Display отлично подходит для логотипов сервера, иконок, декоративных элементов, визуального оформления донатов, голограмм, брендинга лобби и других элементов интерфейса, не требуя от игроков установки ресурспака.
Возможности
- Отображение изображений без использования ресурспака.
- Автоматическое преобразование изображений PNG/JPG/JPEG/WEBP в компоненты из голов игроков. Вам не нужно вручную обрезать изображения — плагин сделает это автоматически.
- Не нужно разбираться с ресурс-паками или искать специальные символы (glyphs): просто загрузите изображение и используйте один плейсхолдер.
- Используйте изображения через простой плейсхолдер:
Код:
%imagedisplay_<название_вашей_картинки>%- Работает в любом чате благодаря замене компонентов через ProtocolLib.
- Использует локальный JSON-кэш изображений после генерации.
- Поддерживает управление доступом через права (permissions).
- Позволяет задать текст-заглушку для неподдерживаемых клиентов.
- Мульти-пул API ключей: поддерживает до 10 ключей MineSkin в конфигурации с автоматической балансировкой и выбором по аргументу
--apikey - Босс-бар в реальном времени с отображением процентов, счетчиков тайлов и статуса очереди Mojang
- Мгновенная отмена запущенных задач с помощью
/imagedisplay cancel
Важно
Клиенты версии ниже 1.21.9 не смогут видеть такие изображения. Для них можно указать текст-заглушку в конфигурации.Как добавить и использовать любое изображение?
1. Загрузите изображение
Поместите файл изображения в папку: Путь к картинкам:
plugins/ImageDisplay/pictures/⚠️ Размер изображения должен быть кратен 8 пикселям.
Примеры допустимых размеров:
Разрешения:
40x8 (рекомендую для префиксов)
16x16
32x32
64x8
64x64
80x8
96x8
128x64
128x128
256x128- Как правильно подобрать разрешение: используйте высоту в 8 пикселей для однострочного текста (чат, префиксы, табуляция), так как высота символов в шрифтах Minecraft составляет 8 пикселей. Более высокие изображения будут отображаться в несколько строк.
- Совет: рисуйте изображения в стиле пиксель-арта 1:1 с высотой 8 пикселей, чтобы иконки были четкими, без размытия!
2. Укажите API-ключ MineSkin в настройках плагина
Получить ключ можно бесплатно:MineSkin - Skin Signature Generator
Вставьте свой ключ (или ключи) в config.yml. Вы можете добавить несколько ключей, чтобы одновременно генерировать несколько картинок в обход лимитов одного ключа.
Секция в конфиге плагина:
ImageDisplay:
mineskin-api-keys:
1: "your_primary_api_key"
2: "optional_second_api_key"3. Сгенерируйте данные изображения
Выполните команду: Команда для генерации картинки:
/imagedisplay generate <image.png> [optional_custom_id] [--apikey <slot>]4. Смотрите статус в босс баре и дождитесь завершения генерации
После успешной генерации появится сообщение в чате. Также можно проверить консоль сервера. Вы можете отменить генерацию написав:/imagedisplay cancel5. Используйте плейсхолдер
Используйте сгенерированный плейсхолдер в любом поддерживаемом месте: Пример плейсхолдера:
%imagedisplay_НазваниеКартинки%Права доступа
Для каждого сгенерированного изображения автоматически создаётся отдельное право доступа: Код:
imagedisplay_<id> Код:
%imagedisplay_logo%требует наличие права:
Код:
imagedisplay_logoСейчас эта проверка применяется только тогда, когда игрок пытается использовать плейсхолдеры Image Display в чате. В будущем планируется расширение системы прав доступа.
Необходимые плагины
Image Display требует наличие:- PlaceholderAPI — для работы плейсхолдеров.
- ProtocolLib — для отображения изображений и определения версии клиента.
- ViaVersion — необязателен. используется как второй плагин для определения версии клиента.
Как это работает?
Image Display берёт изображение, разбивает его на фрагменты размером 8×8 пикселей, отправляет эти фрагменты в MineSkin и получает подписанные текстуры голов игроков.После этого результат сохраняется в локальные JSON-файлы кэша. После генерации серверу больше не требуется обрабатывать исходное изображение — плейсхолдер просто отображает уже сохранённые компоненты голов.
Плагин спроектирован так, чтобы не создавать нагрузки во время работы сервера.
Проверено и работает с плагинами
- TAB
- Chatty
- ChatEx
- Citizens
- FancyNPC
- DeluxeHub
- LuckPerms
- EssentialsX
- EssentialsX Chat
- FancyHolograms
- LPC-Minimessage
- DecentHolograms
Примечания
- Если вы используете плагин TAB и в нём включена стандартная поддержка MiniMessage-компонентов, отображение изображений в префиксах и суффиксах работать не будет.
Секция в конфиге плагина TAB:
components:
minimessage-support: falseПосле этого выполните команду:
Код:
/tab reload- Поддерживается пользовательские локализации включая русскую.
- Рекомендуемые шрифты: Minecraftia, Press Start 2P или любые шрифты в пиксельном стиле. Советую использовать обычные шрифты без сглаживания и рисовать писксель арт 1 к 1 для чёткого отображения
