ChatFormatMod (Чатформатмод)

Мод для серверов Майнкрафт, который задаёт оформление сообщений по правам игроков, добавляет никнеймы, теги, ранги и профили. Он рассчитан на работу вместе с ChatMod и позволяет администраторам управлять внешним видом чата через YAML-файлы.

Возможности

• В formats.yml можно создать несколько стилей чата: применяется первый стиль, право на который есть у игрока. Стиль с пустым правом служит вариантом по умолчанию.
• Форматы поддерживают цвета, шестнадцатеричные цвета, текст при наведении, кликабельные действия, предметы, спрайты, упоминания и заполнители ChatMod и PlaceholderAPI.
• Игроки выбирают косметический тег через меню /tags; доступ к каждому тегу задаётся отдельным правом в tags.yml.
• Ранги из custom_ranks.yml добавляют префикс и суффикс. В форматах доступны %custom_rank%, %prefix% и %suffix%.
• В профиле можно создать произвольные поля, например страну или стиль игры. Значения выбираются из списка либо вводятся в чат и выводятся через %profile:fieldId%.
• Ссылки в сообщениях автоматически превращаются в оформленные кликабельные ссылки.
• Можно задать собственные сообщения о входе и выходе игрока, включая отдельное сообщение для первого входа.
• Данные никнеймов, тегов, рангов и профилей доступны другим модам через заполнители PlaceholderAPI, в том числе для списка игроков, табло и надписей над головой.

Как пользоваться

• /nickname <ник> или /nick <ник> — установить свой никнейм.
• /nickname reset — убрать свой никнейм.
• /nickname <ник> <игрок> — изменить никнейм другого игрока.
• /nickname reset <игрок> — убрать никнейм другого игрока.
• /tags — открыть выбор косметического тега.
• /profile — открыть свой профиль.
• /profile <игрок> — посмотреть профиль другого игрока.
• /chatformat reload или /cf reload — перечитать конфиги.
• /chatformat debug <игрок> — показать активный стиль, никнейм, тег и ранг игрока.

Никнейм не может состоять только из кодов форматирования. Одинаковые видимые никнеймы считаются занятыми независимо от регистра и цветов.

Настройки

Файлы находятся в config/chatformatmod/:

• chatformatmod.yml — общие параметры, ссылки и сообщения о входе и выходе;
• formats.yml — стили чата по правам;
• custom_ranks.yml — префиксы и суффиксы рангов;
• tags.yml — косметические теги;
• profile_fields.yml — поля профилей;
• messages.yml — системные сообщения.

После изменения конфигов используйте /chatformat reload. Данные игроков хранятся в <world>/chatformatmod_playerdata.json.

Требования и совместимость

Требуются Fabric API, LuckPerms для стилей по правам и Fabric Permissions API. ChatMod рекомендуется: без него мод работает с обычным текстом, но без эффектов наведения и кликабельных действий. Placeholder API нужна для заполнителей и интеграции со сторонними модами.