Image Emojis

Image Emojis - плагин для серверов на Paper (1.19.4+), который приносит в чат кастомные эмодзи. Если ванильный чат в Minecraft кажется пресным, а смайликов в виде текста уже не хватает - это решение. Плагин сам генерирует ресурспак с эмодзи, раздаёт его игрокам и поддерживает автодополнение при вводе. Всё, что нужно - положить картинки в нужную папку и настроить пару полей в конфиге.

Возможности

• Автоматическая генерация ресурспака - при запуске плагина или перезагрузке он сам собирает ресурспак из ваших изображений и хостит его через встроенный HTTP-сервер. Игроки получают его автоматически.
• Автодополнение в чате - когда игрок начинает вводить текст, ему подсказываются шаблоны эмодзи (например :clueless:) или уже готовые UTF-8 символы. Можно выбрать режим: только шаблоны, только символы, оба или отключить.
• Замена эмодзи везде - эмодзи работают не только в чате, но и на табличках, в названиях предметов на наковальне и даже в командах. Всё настраивается отдельно.
• Интеграция с Discord - если на сервере стоит DiscordSRV, эмодзи будут корректно отображаться и в Discord, и в игре. Достаточно, чтобы имена совпадали.
• Слияние с серверным ресурспаком - можно объединить сгенерированный архив с вашим основным ресурспаком, чтобы не было конфликтов.
• Гибкие права - через imageemojis.use, imageemojis.admin и другие разрешения контролируется, кто может видеть эмодзи, пользоваться командами и т.д.

Команды и разрешения

• /emojis list - открывает книгу со всеми добавленными эмодзи.
• /emojis update - обновляет ресурспак на клиенте, если админ перезагрузил плагин во время игры (можно просто перезайти).
• /emojis reload - перезагружает плагин и генерирует ресурспак заново. Алиасы: /ie, /imageemojis.

Права:

• imageemojis.admin (по умолчанию у операторов) - доступ к /emojis reload.
• imageemojis.use (по умолчанию true) - использование эмодзи и команды /emojis.
• imageemojis.update (по умолчанию true) - /emojis update.
• imageemojis.list (по умолчанию true) - /emojis list.

Конфигурация

Первым делом в config.yml нужно указать публичный IP сервера (serverIp) и открыть TCP-порт (по умолчанию 5000). Без этого игроки не смогут скачать ресурспак. Остальные настройки можно менять под себя:

• enforcementPolicy - политика загрузки ресурспака: NONE (вручную), OPTIONAL (можно отказаться) или REQUIRED (обязателен).
• suggestionMode - режим подсказок: NONE, TEMPLATES (по умолчанию), ACTUAL, BOTH.
• templateFormat - формат шаблона, по умолчанию :<emoji>:.
• mergeWithServerResourcePack - объединение с серверным ресурспаком.
• replaceInAnvils, replaceOnSigns, replaceInCommands - где заменять шаблоны на эмодзи.
• extendedUnicodeRange - если эмодзи больше 500, может потребоваться расширенный диапазон (сбросит старые коды).

Пример конфига по умолчанию:

serverIp: "127.0.0.1"
webServerPort: 5000
enforcementPolicy: "OPTIONAL"
replaceInAnvils: true
replaceOnSigns: true
replaceInCommands: true
suggestionMode: "TEMPLATES"
templateFormat: ":<emoji>:"
mergeWithServerResourcePack: false
mergeServerResourcePackName: "serverResourcePack.zip"
extendedUnicodeRange: false
messages:
  "resource-pack-description": "&nImage Emojis"
  "only-players": "&cOnly players can use this command!"
  ...

Установка

1. Скачайте последнюю версию плагина.
2. Поместите .jar в папку plugins вашего сервера.
3. Перезапустите сервер или выполните reload.
4. Отредактируйте plugins/ImageEmojis/config.yml: укажите публичный IP и откройте порт 5000.
5. Выполните /emojis reload.

После этого плагин готов к работе. Просто кладите свои .png-картинки (до 256x256) в папку ../ImageEmojis/emojis/, перезагружайте плагин - и игроки видят новые эмодзи. Имена файлов должны быть только с маленькими буквами и без спецсимволов.

Важно: если вы используете ресурспак в server.properties, отключите его - Image Emojis сам раздаёт ресурспак.