- Документация
- https://modrinth.com/plugin/image-emojis
Image Emojis: Emojis in chat, также называемый ImageEmojis, — серверный плагин для Paper, который добавляет пользовательские эмодзи в чат и подсказки при наборе. Он автоматически формирует ресурс-пак из подготовленных изображений. В метаданных указаны категории социальных функций, хранения и служебных инструментов, участник MrQuackDuck и лицензия MIT. Клиентская модификация не требуется, однако отображение изображений связано с получением сгенерированного ресурс-пака.
Администратор помещает изображения в каталог плагина, а ImageEmojis при запуске или перезагрузке формирует ресурс-пак. Эмодзи используются через текстовые обозначения, подсказки и внутриигровой список.
Основные сценарии:
• реакции и собственные символы сообщества;
• тематический набор для проекта или сезона;
• подсказки при вводе;
• обновление без клиентского мода.
Плагин не редактирует изображения: качество и читаемость PNG готовят заранее.
Допустим PNG с максимальным разрешением 256 × 256 пикселей. Имена должны быть в нижнем регистре и без специальных символов, включая круглые и квадратные скобки, амперсанд и знак степени.
Чек-лист:
• сохранить файл как .png;
• не превышать 256 × 256;
• использовать короткое строчное имя;
• исключить пробелы, скобки и специальные знаки;
• проверить читаемость на разных фонах;
• начать с одного тестового изображения.
Минимальная ширина, цветовой профиль и предел размера в байтах в источнике не заданы.
Платформы проекта — Paper и Purpur. Подтверждённые версии Minecraft начинаются с 1.19.4 и включают перечисленные выпуски 1.20, 1.21, а также 26.1, 26.1.1, 26.1.2 и 26.2. Официальное описание указывает Paper 1.19.4 и новее, но сборку выбирают по конкретному релизу.
В выборке представлены:
• ImageEmojis-1.7.2.jar, версия 1.7.2, 4 701 466 байт;
• ImageEmojis-1.6.jar, версия 1.6, 4 699 726 байт.
Обязательные project dependencies не указаны. Это не доказывает совместимость с Bukkit, Spigot или любым форком: заявлены только Paper и Purpur.
JAR помещают в папку plugins остановленного Paper или Purpur, затем проверяют журнал. Для автоматической выдачи указывают IP в конфигурации и открывают TCP-порт; по умолчанию назван 5000.
Последовательность:
• Сохранить сервер и остановить процесс.
• Скопировать подходящий JAR в plugins.
• Запустить сервер для создания данных.
• Поместить тестовый PNG в ./plugins/ImageEmojis/emojis/.
• Указать адрес и настроить доступ к порту.
• Перезапустить сервер и проверить генерацию.
• Подключиться обычным игроком.
Сначала используют один файл с простым именем, чтобы отделить сетевую проблему от ошибки изображения.
Подтверждены команды:
• /emojis list открывает книгу с эмодзи;
• /emojis update получает актуальный ресурс-пак; альтернатива — повторный вход;
• /emojis reload перечитывает плагин и генерирует пак из ./plugins/ImageEmojis/emojis/.
Псевдонимы — /ie и /imageemojis. imageemojis.admin разрешает reload и по умолчанию предназначено операторам; imageemojis.use, imageemojis.update и imageemojis.list управляют остальными действиями и заявлены включёнными по умолчанию.
Reload выдают ограниченно: после перегенерации подключённым игрокам может потребоваться обновление пакета.
Для подсказок заявлены четыре режима, но в доступном фрагменте раскрыты только три:
• NONE отключает подсказки;
• TEMPLATES предлагает шаблоны обозначений и указан как режим по умолчанию;
• ACTUAL предлагает фактические эмодзи, однако продолжение описания обрезано.
Четвёртый режим не назван, поэтому его поведение не следует додумывать. Если эмодзи работают, а подсказок нет, проверяют выбранный режим и imageemojis.use.
Нужно проверить весь путь: генерацию, сетевую выдачу, получение пакета и отображение.
Контрольный список:
• в журнале нет ошибки ImageEmojis;
• тестовый PNG принят без сообщения о неверном имени или формате;
• ресурс-пак создаётся после запуска или /emojis reload;
• игрок получает актуальную версию после входа или /emojis update;
• /emojis list показывает добавленный элемент;
• обозначение эмодзи отображается в чате как ожидается;
• подсказки соответствуют выбранному режиму;
• пользователь без административного права не выполняет reload;
• результат сохраняется после полного рестарта.
Проверку повторяют извне: локальная работа не подтверждает доступность порта из сети.
Работа зависит от JAR, изображений, адреса и сетевого порта. Сбой любого звена может выглядеть как отсутствующий эмодзи.
Следует учитывать:
• максимальное разрешение — 256 × 256;
• поддерживается PNG;
• имена должны быть строчными и без указанных специальных символов;
• заявлены только Paper и Purpur;
• полный перечень режимов подсказок в источнике обрезан;
• поведение с другими плагинами чата не подтверждено;
• динамический запуск предоставленных JAR не выполнялся.
PNG проверяют до загрузки, а сетевой порт не открывают шире необходимого.
Перед обновлением сохраняют JAR, каталог ImageEmojis, изображения, конфигурацию, адрес, порт и разрешения. Новую версию проверяют на копии.
Порядок:
• Сверить новый файл по размеру и хешу.
• Остановить сервер.
• Создать резервную копию.
• Заменить JAR без одновременной массовой смены изображений.
• Запустить сервер и проверить генерацию.
• Подключиться извне и обновить ресурс-пак.
• Проверить список, чат, подсказки и права.
• Только затем добавить новые эмодзи.
Для отката возвращают прежний JAR и совместимую копию данных. Точное имя генерируемого файла в источнике не указано, поэтому удалять неизвестные элементы вручную не следует.
Плагин не запускается. Проверяют Paper или Purpur, версию Minecraft, Java и целостность JAR.
PNG не добавляется. Проверяют формат, пиксели, регистр и специальные символы, затем пробуют простой файл.
Пак не приходит. Проверяют IP, TCP-порт, межсетевой экран и внешний доступ.
Виден старый набор. Используют /emojis update или повторный вход и проверяют успешность reload.
Нет подсказок. Сверяют режим, imageemojis.use и версию плагина. Нельзя опираться на неизвестный четвёртый режим из обрезанного описания.
Reload доступен лишним игрокам. Проверяют imageemojis.admin, операторский статус и систему прав сервера.
Для версии 1.7.2 указан SHA-1 cf3638e7df66914d049cf1bd99c58b47729f408f, для 1.6 — 2f4b489df5d994423c611a6750c9ae73a41260d0; также опубликованы SHA-512. Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся.
При локализации по MIT сохраняют название проекта, авторство MrQuackDuck и сведения о лицензии.
Нет. Плагин серверный. Но для показа пользовательских изображений клиент должен получить сформированный ресурс-пак.
В предоставленной документации указан PNG с максимальным разрешением 256 × 256 пикселей.
После изменения набора требуется перегенерация, а подключённому игроку — обновление ресурс-пака или повторный вход.
В метаданных заявлены Paper и Purpur. Оснований обещать работу на Spigot нет.
Он указан как значение по умолчанию для встроенной схемы выдачи. Возможность и способ изменения нужно проверять в конфигурации конкретной версии.
Назначение и принцип работы
Администратор помещает изображения в каталог плагина, а ImageEmojis при запуске или перезагрузке формирует ресурс-пак. Эмодзи используются через текстовые обозначения, подсказки и внутриигровой список.
Основные сценарии:
• реакции и собственные символы сообщества;
• тематический набор для проекта или сезона;
• подсказки при вводе;
• обновление без клиентского мода.
Плагин не редактирует изображения: качество и читаемость PNG готовят заранее.
Скриншоты и внешний вид
Требования к изображениям
Допустим PNG с максимальным разрешением 256 × 256 пикселей. Имена должны быть в нижнем регистре и без специальных символов, включая круглые и квадратные скобки, амперсанд и знак степени.
Чек-лист:
• сохранить файл как .png;
• не превышать 256 × 256;
• использовать короткое строчное имя;
• исключить пробелы, скобки и специальные знаки;
• проверить читаемость на разных фонах;
• начать с одного тестового изображения.
Минимальная ширина, цветовой профиль и предел размера в байтах в источнике не заданы.
Совместимость
Платформы проекта — Paper и Purpur. Подтверждённые версии Minecraft начинаются с 1.19.4 и включают перечисленные выпуски 1.20, 1.21, а также 26.1, 26.1.1, 26.1.2 и 26.2. Официальное описание указывает Paper 1.19.4 и новее, но сборку выбирают по конкретному релизу.
В выборке представлены:
• ImageEmojis-1.7.2.jar, версия 1.7.2, 4 701 466 байт;
• ImageEmojis-1.6.jar, версия 1.6, 4 699 726 байт.
Обязательные project dependencies не указаны. Это не доказывает совместимость с Bukkit, Spigot или любым форком: заявлены только Paper и Purpur.
Установка и первичная настройка
JAR помещают в папку plugins остановленного Paper или Purpur, затем проверяют журнал. Для автоматической выдачи указывают IP в конфигурации и открывают TCP-порт; по умолчанию назван 5000.
Последовательность:
• Сохранить сервер и остановить процесс.
• Скопировать подходящий JAR в plugins.
• Запустить сервер для создания данных.
• Поместить тестовый PNG в ./plugins/ImageEmojis/emojis/.
• Указать адрес и настроить доступ к порту.
• Перезапустить сервер и проверить генерацию.
• Подключиться обычным игроком.
Сначала используют один файл с простым именем, чтобы отделить сетевую проблему от ошибки изображения.
Команды и разрешения
Подтверждены команды:
• /emojis list открывает книгу с эмодзи;
• /emojis update получает актуальный ресурс-пак; альтернатива — повторный вход;
• /emojis reload перечитывает плагин и генерирует пак из ./plugins/ImageEmojis/emojis/.
Псевдонимы — /ie и /imageemojis. imageemojis.admin разрешает reload и по умолчанию предназначено операторам; imageemojis.use, imageemojis.update и imageemojis.list управляют остальными действиями и заявлены включёнными по умолчанию.
Reload выдают ограниченно: после перегенерации подключённым игрокам может потребоваться обновление пакета.
Подсказки в чате
Для подсказок заявлены четыре режима, но в доступном фрагменте раскрыты только три:
• NONE отключает подсказки;
• TEMPLATES предлагает шаблоны обозначений и указан как режим по умолчанию;
• ACTUAL предлагает фактические эмодзи, однако продолжение описания обрезано.
Четвёртый режим не назван, поэтому его поведение не следует додумывать. Если эмодзи работают, а подсказок нет, проверяют выбранный режим и imageemojis.use.
Проверка результата
Нужно проверить весь путь: генерацию, сетевую выдачу, получение пакета и отображение.
Контрольный список:
• в журнале нет ошибки ImageEmojis;
• тестовый PNG принят без сообщения о неверном имени или формате;
• ресурс-пак создаётся после запуска или /emojis reload;
• игрок получает актуальную версию после входа или /emojis update;
• /emojis list показывает добавленный элемент;
• обозначение эмодзи отображается в чате как ожидается;
• подсказки соответствуют выбранному режиму;
• пользователь без административного права не выполняет reload;
• результат сохраняется после полного рестарта.
Проверку повторяют извне: локальная работа не подтверждает доступность порта из сети.
Ограничения и безопасность
Работа зависит от JAR, изображений, адреса и сетевого порта. Сбой любого звена может выглядеть как отсутствующий эмодзи.
Следует учитывать:
• максимальное разрешение — 256 × 256;
• поддерживается PNG;
• имена должны быть строчными и без указанных специальных символов;
• заявлены только Paper и Purpur;
• полный перечень режимов подсказок в источнике обрезан;
• поведение с другими плагинами чата не подтверждено;
• динамический запуск предоставленных JAR не выполнялся.
PNG проверяют до загрузки, а сетевой порт не открывают шире необходимого.
Обновление и откат
Перед обновлением сохраняют JAR, каталог ImageEmojis, изображения, конфигурацию, адрес, порт и разрешения. Новую версию проверяют на копии.
Порядок:
• Сверить новый файл по размеру и хешу.
• Остановить сервер.
• Создать резервную копию.
• Заменить JAR без одновременной массовой смены изображений.
• Запустить сервер и проверить генерацию.
• Подключиться извне и обновить ресурс-пак.
• Проверить список, чат, подсказки и права.
• Только затем добавить новые эмодзи.
Для отката возвращают прежний JAR и совместимую копию данных. Точное имя генерируемого файла в источнике не указано, поэтому удалять неизвестные элементы вручную не следует.
Диагностика
Плагин не запускается. Проверяют Paper или Purpur, версию Minecraft, Java и целостность JAR.
PNG не добавляется. Проверяют формат, пиксели, регистр и специальные символы, затем пробуют простой файл.
Пак не приходит. Проверяют IP, TCP-порт, межсетевой экран и внешний доступ.
Виден старый набор. Используют /emojis update или повторный вход и проверяют успешность reload.
Нет подсказок. Сверяют режим, imageemojis.use и версию плагина. Нельзя опираться на неизвестный четвёртый режим из обрезанного описания.
Reload доступен лишним игрокам. Проверяют imageemojis.admin, операторский статус и систему прав сервера.
Файлы, проверка и лицензия
Для версии 1.7.2 указан SHA-1 cf3638e7df66914d049cf1bd99c58b47729f408f, для 1.6 — 2f4b489df5d994423c611a6750c9ae73a41260d0; также опубликованы SHA-512. Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся.
При локализации по MIT сохраняют название проекта, авторство MrQuackDuck и сведения о лицензии.
FAQ
Нужен ли клиентский мод?
Нет. Плагин серверный. Но для показа пользовательских изображений клиент должен получить сформированный ресурс-пак.
Какой формат изображения поддерживается?
В предоставленной документации указан PNG с максимальным разрешением 256 × 256 пикселей.
Почему новый эмодзи не виден сразу?
После изменения набора требуется перегенерация, а подключённому игроку — обновление ресурс-пака или повторный вход.
Можно ли использовать ImageEmojis на Spigot?
В метаданных заявлены Paper и Purpur. Оснований обещать работу на Spigot нет.
Обязателен ли порт 5000?
Он указан как значение по умолчанию для встроенной схемы выдачи. Возможность и способ изменения нужно проверять в конфигурации конкретной версии.
