ChatColor

Что такое ChatColor и зачем он нужен?

На любом сервере Майнкрафт чат - главный способ общения. Но стандартные цвета быстро надоедают, а игроки хотят выделяться. ChatColor - это плагин для Bukkit/Spigot/Paper, который даёт полный контроль над цветом и стилем сообщений. Больше никаких скучных серых строчек: можно использовать классические цвета Minecraft, hex-коды (аж 16 миллионов оттенков), радужные и градиентные эффекты, а также модификаторы вроде жирного, курсива, зачёркнутого или даже "запутанного" текста.

Плагин идеально подходит для серверов с донатом - можно выдавать доступ к определённым цветам как привилегию. Администраторы могут задавать групповые цвета, чтобы, например, модераторы всегда писали синим, а администраторы - красным.

Особенности ChatColor

• 16 миллионов цветов - любые hex-коды в формате #RRGGBB.
• Режимы цвета - legacy (стандартные &-коды), hex, радуга (✨) и градиенты (gradient).
• Все модификаторы - жирный (bold), курсив (italic), подчёркнутый, зачёркнутый, obfuscated (мелькающие символы).
• MySQL и MariaDB - синхронизация цветов между несколькими серверами (например, на прокси).
• Настройка из консоли - легко добавить как награду за донат.
• Гибкие разрешения - можно ограничить доступ к отдельным цветам, модификаторам, GUI и командам.
• Свои цвета (custom colors) - создавайте и сохраняйте любимые комбинации в конфиге.
• Групповые цвета - автоматически назначать цвет игрокам по группе (через permission).
• Полностью настраиваемые сообщения и GUI - меняйте текст, раскладку меню как угодно.
• Множество настроек - можно изменить команду, таймаут подтверждения, поведение при входе и т.д.

Команды

Основная команда - /chatcolor (или та, которую вы зададите в настройках).

• /chatcolor [игрок] <цвет/сброс> [модификаторы] - изменить цвет себе или другому игроку.
• /chatcolor gui - открыть графический интерфейс выбора цвета.
• /chatcolor available - показать, какие цвета и модификаторы доступны.
• /chatcolor <add/remove> <модификатор> - добавить или убрать модификатор (например, bold).

Админские команды

• /chatcolor reload - перезагрузить конфиги.
• /chatcolor reset - сбросить конфиг на стандартный (осторожно).
• /chatcolor set <настройка> <значение> - изменить любую настройку из списка ниже.
• /chatcolor confirm - подтвердить изменение настройки.
• /chatcolor group <add/remove/list> [имя] [цвет] - управление групповыми цветами.
• /chatcolor custom <add/remove/list> [имя] [цвет] - управление пользовательскими цветами.

Разрешения (Permissions)

• chatcolor.* - все права (кроме custom-цветов).
• chatcolor.use - использовать /chatcolor и справку.
• chatcolor.use-color-codes - использовать &-коды в чате.
• chatcolor.use-hex-codes - использовать hex-цвета.
• chatcolor.special - радуга и градиенты.
• chatcolor.gui - открывать GUI.
• chatcolor.color.<цвет> - доступ к конкретному цвету (например, chatcolor.color.a).
• chatcolor.modifier.<модификатор> - доступ к модификатору (например, chatcolor.modifier.l).
• chatcolor.change.self - менять свой цвет.
• chatcolor.change.* - менять цвет любому.
• chatcolor.admin - все админские команды.
• chatcolor.group.<имя> - назначить групповой цвет.
• chatcolor.custom.<имя> - дать доступ к пользовательскому цвету.

Настройки (Settings)

Все настройки находятся в config.yml. Вот основные:

• command-name - изменить базовую команду (например, cc).
• color-override - переопределять ли &-коды в сообщениях.
• confirm-timeout - время на подтверждение (в секундах).
• default-color - цвет по умолчанию для новых игроков.
• join-message - показывать ли игроку его цвет при входе.
• notify-others - уведомлять ли, если кто-то изменил цвет игрока.
• auto-save - автосохранение каждые 5 минут (на случай краша).
• save-interval - интервал автосохранения.
• command-opens-gui - если true, то /chatcolor открывает GUI вместо показа текущего цвета.

Цвета и модификаторы

Стандартные цвета Minecraft (legacy)

Код	Название
0	black
1	dark.blue
2	green
3	dark.aqua
4	red
5	purple
6	gold
7	grey
8	dark.grey
9	blue
a	light.green
b	aqua
c	light.red
d	magenta
e	yellow
f	white

Hex-цвета

Формат: &#RRGGBB (например, &#ff0000 для красного).

Модификаторы

Код	Название
k	obfuscated
l	bold
m	strikethrough
n	underlined
o	italic

PlaceholderAPI

ChatColor поддерживает плейсхолдеры для отображения цвета игрока. Например:

• %cc_full_color% - полный цвет (цвет + модификаторы).
• %cc_color% - только цвет.
• %cc_color_name% - имя цвета.
• %cc_modifiers% - модификаторы.
• %cc_group% - имя группы.

Полный список плейсхолдеров есть в конфиге, но некоторые пока работают с ограничениями.

GUI и настройка интерфейса

Файл gui.yml позволяет полностью настроить меню выбора цвета. Можно создать несколько страниц: для обычных цветов, для hex, для пользовательских. В комплекте идут три готовых примера.

Важно знать

• Плагин не требует установки на клиент - всё работает на стороне сервера.
• Для корректного отображения цветов у игроков должен быть установлен ванильный клиент (или клиент с поддержкой hex-цветов, например, через мод).
• Если вы используете Paper, рекомендуем отключить встроенную цветную обработку чата, чтобы избежать конфликтов.
• На больших серверах с MySQL база данных позволит синхронизировать цвета между прокси-серверами.

ChatColor - это must-have для любого сервера, где ценят кастомизацию и хотят дать игрокам возможность выразить себя. Установив его, вы сразу заметите, как чат становится ярче и живее.