ChatFormatter

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

Зависимости

Для работы ChatFormatter обязательно нужны два плагина:

• PlaceholderAPI - для подстановки плейсхолдеров (например, уровень, здоровье, группа)
• Vault - для привязки к экономике и пермишенам, а также для определения ранга игрока

Без них плагин не запустится, так что убедитесь, что они установлены.

Основные возможности

• Поддержка PlaceholderAPI - можете использовать любые плейсхолдеры из PAPI в формате чата.
• MiniMessages - современная система форматирования с поддержкой градиентов, теней, кликов, ховеров и кастомных цветов. При этом сохраняется обратная совместимость с цветами через & (Legacy Colors).
• Система шаблонов (Templates) - позволяет создавать сложные конструкции один раз и использовать их как короткий плейсхолдер, сохраняя конфиг чистым.
• Кастомные плейсхолдеры - можете задать свои сокращения для часто используемых фрагментов (например, {admin} вместо длинного текста с цветами).
• Разрешения на цвета и декорации - каждое форматирование (жирный, курсив, подчеркнутый, цвет, градиент) можно ограничить отдельным правом, что удобно для привилегий.

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

В таблице ниже перечислены все права, которые контролируют доступ к тегам MiniMessages и цветам.

Право	Доступ
chatformatter.decorations.*	<bold>, <italic>, <underlined>, <strikethrough>, <obfuscated>, &l, &o, &n, &m, &k
chatformatter.decorations.bold	<bold>, <b>, &l
chatformatter.decorations.italic	<italic>, <i>, <em>, &o
chatformatter.decorations.underlined	<underlined>, &n
chatformatter.decorations.strikethrough	<strikethrough>, <st>, &m
chatformatter.decorations.obfuscated	<obfuscated>, <obf>, &k
chatformatter.reset	<reset>, &r
chatformatter.newline	<newline>, <br>
chatformatter.shadow	<shadow>
chatformatter.gradient	<gradient>
chatformatter.✨	<✨>
chatformatter.✨	<✨>
chatformatter.transition	<transition>
chatformatter.hover	<hover>
chatformatter.click	<click>
chatformatter.insertion	<insertion>
chatformatter.color.*	Все цвета: <red>, <blue>, <#a568a9>, &c, &#a568a9 и т.д.
chatformatter.color.black	<black>, &0
chatformatter.color.dark_blue	<dark_blue>, &1
chatformatter.color.dark_green	<dark_green>, &2
chatformatter.color.dark_aqua	<dark_aqua>, &3
chatformatter.color.dark_red	<dark_red>, &4
chatformatter.color.dark_purple	<dark_purple>, &5
chatformatter.color.gold	<gold>, &6
chatformatter.color.gray	<gray>, &7
chatformatter.color.dark_gray	<dark_gray>, &8
chatformatter.color.blue	<blue>, &9
chatformatter.color.green	<green>, &a
chatformatter.color.aqua	<aqua>, &b
chatformatter.color.red	<red>, &c
chatformatter.color.light_purple	<light_purple>, &d
chatformatter.color.yellow	<yellow>, &e
chatformatter.color.white	<white>, &f
chatformatter.score	<score>
chatformatter.selector	<selector>
chatformatter.font	<font>
chatformatter.translatable	<lang>
chatformatter.keybind	<key>
chatformatter.nbt	<nbt>
chatformatter.reload	/chatformatter reload
chatformatter.receiveupdates	Получать уведомления о новых версиях

Важно: Каждое право на цвет или декорацию даёт доступ как к устаревшему коду (например, &f), так и к соответствующему тегу MiniMessage (например, <white>).

Пример конфигурации (config.yml)

#    ____ _           _   _____      ChatFormatter       _   _            
#   / ___| |__   __ _| |_|  ___|__  _ __ _ __ ___   __ _| |_| |_ ___ _ __ 
#  | |   | '_ \ / _` | __| |_ / _ \| '__| '_ ` _ \ / _` | __| __/ _ \ '__|
#  | |___| | | | (_| | |_|  _| (_) | |  | | | | | | (_| | |_| ||  __/ |   
#   \____|_| |_|\__,_|\__|_|  \___/|_|  |_| |_| |_|\__,_|\__|\__\___|_|   

# Хотите получать уведомления о новых версиях ChatFormatter?
receiveUpdates: true

# Формат чата для рангов (Vault). Поддерживает MiniMessages и Legacy Colors.

# Примеры использования:
# 
# Всплывающая подсказка (hover):
# Одна строка: <hover:show_text:'<red>test'>TEST
# Несколько строк: <hover:show_text:'<red>test'>Test<newline>Test2</hover>
# 
# Кликабельное сообщение:
# Открыть URL: <click:open_url:'https://example.com'>TEST</click>
# Выполнить команду: <click:run_command:/say hello>Click</click>
# Подставить команду в чат: <click:suggest_command:'/msg {displayname}'>...</click>
# 
# RGB и градиенты:
# <color:#ff00ee>Пример сообщения</color>
# <gradient:#ff00ee:#f79459>Пример градиента</gradient>
# 
# Встроенные плейсхолдеры: <displayname>, <name>, <message>
# 
defaultFormat: "{displayname} " {message}"

# Разные форматы для разных рангов.
# Имя ранга должно точно совпадать с названием в вашей системе прав.
format:
  default: "{member} &7$hoverName({displayname}) &8" <gradient:#d4d4d4:white>{message} "
  vip: "{vip} &f$hoverName({displayname}) <dark_gray>" <gradient:#ffd270:white>{message}"
  mod: "{mod} &f$hoverName({displayname}) <dark_gray>" <gradient:#a3ff9e:white>{message}"
  admin: "{admin} &f$hoverName({displayname}) <dark_gray>" <gradient:#bac8ff:white><b>{message}"
  owner: "{owner} &f$hoverName({displayname}) <dark_gray>" <gradient:#ff9195:white><b>{message}"

# Плейсхолдеры - сокращения для часто используемых фрагментов.
# Можно использовать PAPI плейсхолдеры.
placeholders:
  {displayname}: "<displayname>"
  {name}: "<name>"
  {message}: "<message>"
  {member}: "<#6e6764>Member"
  {vip}: "<gold>VIP"
  {mod}: "<b><#00c900>Mod</b>"
  {admin}: "<b><#6e86ff>Admin</b>"
  {owner}: "<b><gradient:#c40000:#e04b4b>Owner</b>"
  {rankDescription}: "<dark_gray>Ранг: <white>%vault_group%"
  {joinDate}: "<dark_gray>Дата захода: <white>%player_first_join_date%"
  {health}: "<dark_gray>Здоровье: <red>%player_health%"
  {lvl}: "<dark_gray>Уровень: <gold>%player_level%"
  {privateMessage}: "<gradient:#36ff39:#75ff75><i>Кликните, чтобы написать ЛС</i></gradient>"

# Шаблоны - для опытных пользователей.
# Позволяют сократить длинные конструкции и держать конфиг чистым.
templates:
  - "$hoverName($name) -> '<hover:show_text:'<dark_gray>Имя: <white>$name<br><br>{rankDescription}<br>{joinDate}<br>{health}<br>{lvl}<br><br>{privateMessage}'><click:suggest_command:'/msg {displayname} '>{displayname}</click></hover>'"

Итог

ChatFormatter - это мощный и гибкий инструмент для оформления чата на сервере Minecraft. Он подходит как для небольших проектов, так и для крупных сеток с кучей рангов и привилегий. Благодаря поддержке MiniMessages и PAPI вы сможете сделать чат информативным, красивым и удобным для игроков. Единственный минус - потребуется настроить конфиг под себя, но примеры выше помогут разобраться. Скачайте ChatFormatter и преобразите общение на вашем сервере!