MyColorName

Простой плагин для платформы Paper, дающий пользователям возможность индивидуально настраивать цвет своего имени в игровых интерфейсах.

MyColorName предоставляет функционал для персонализации отображения никнеймов. Плагин позволяет игрокам выбирать цвет имени, который будет отображаться в сообщениях чата и списке Tab. Основное преимущество проекта заключается в использовании нативных диалоговых окон Minecraft, поддерживаемых платформой Paper.

Интерфейс выбора цветов реализован через стандартные диалоги игры. Если клиент или сервер не могут корректно отобразить диалоговое окно, система автоматически переключается на текстовое сообщение с помощью. Внутриигровые уведомления автоматически меняют язык (английский или французский) в зависимости от настроек клиента пользователя.

Для взаимодействия с плагином используются следующие команды:

/mycolorname
/mycolorname <color>
/mycolorname list
/mycolorname reset
/mycolorname set <player> <color>
/mycolorname all <color>
/mycolorname help

Основные функции команд:

• /mycolorname — открывает диалоговое окно выбора цвета (для игроков).
• /mycolorname — устанавливает выбранный цвет напрямую (например, /mycolorname red).
• /mycolorname list — выводит список доступных цветов.
• /mycolorname reset — сбрасывает текущий цвет никнейма до стандартного.
• /mycolorname set — позволяет администраторам изменить цвет другого игрока.
• /mycolorname all — устанавливает единый цвет для всех игроков, находящихся в сети.

Большинство прав по умолчанию разрешены (true), за исключением прав администратора, которые по умолчанию требуют статуса оператора (op).

Настройки хранятся в файле plugins/MyColorName/config.yml.

allowed-colors:
  - black
  - dark_blue
  - dark_green
  - dark_aqua
  - dark_red
  - dark_purple
  - gold
  - gray
  - dark_gray
  - blue
  - green
  - aqua
  - red
  - light_purple
  - yellow
  - white
respect-existing-list-name: true

Параметры конфигурации:

• allowed-colors — список цветов, доступных в диалоге, командах и автодополнении.
• respect-existing-list-name — если установлено в значение true, плагин перекрашивает существующее имя в Tab, заданное другим плагином, вместо замены текста. Если false — используется исходное имя игрока.

Проект разработан как минимально интрузивное решение:

• не имеет зависимостей от сторонних плагинов
• использует нативные API Paper/Adventure
• перекрашивает текущий рендерер чата без изменения полного формата
• восстанавливает никнеймы в списке Tab при выключении сервера

Благодаря таким особенностям плагин совместим с EssentialsX в большинстве случаев.