viaStyle

viaStyle

Серверный мод на Fabric для Minecraft 1.21.10. Заменяет ванильную систему чата на многоканальную, добавляет оформление списка игроков (tab), индивидуальные цвета ников, личные сообщения, упоминания, social spy и опциональные интеграции с LuckPerms, BlockBot, Carpet, PAPI и BanHammer. Клиентский мод не требуется.

Требования

• Minecraft 1.21.10
• Fabric Loader >= 0.16.12
• Fabric API Опциональные зависимости (определяются автоматически при запуске):
• LuckPerms — отображение префикса/суффикса, сортировка в tab по весу, проверки прав
• PlaceholderAPI (PAPI) — использование токенов %placeholder% в строках формата
• BlockBot — мост в Discord
• fabric-carpet — интеграция с событиями Scarpet и определение HUD-логгера
• melius-vanish (DrexHD) — скрытые игроки не показываются в подсказках и списке игроков

Установка

1. Поместите `viastyle-+mc1.21.10.jarв папкуmods/` сервера.
2. Запустите сервер. Конфиг по умолчанию создастся в config/viaStyle/viaStyle.toml.
3. Отредактируйте конфиг по необходимости, затем выполните /via reload в игре или перезапустите сервер.

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

Все настройки находятся в config/viaStyle/viaStyle.toml. Файл в читаемом формате TOML. Отсутствующие ключи заполняются значениями по умолчанию при следующей загрузке. Все настройки также можно менять на лету через панель /via admin.

[local]

[global]

[staff]

[timestamp]

[integrations]

[blockbot]

[pm]

[nickcolor]

[tablist]

[mentions]

[language]

[joinleave]

| leave_format | &c- &r{name} | Формат сообщения при выходе игрока | | first_join_format | &6+ &r{name} &6joined for the first time! | Показывается только при первом входе |

[console]

Токены форматирования

Большинство строк форматирования поддерживают следующие токены:

Устаревшие цветовые коды & и hex-цвета (&#RRGGBB) поддерживаются во всех строках форматирования. Теги в стиле MiniMessage (`, , <gr:#ff0000:#ffaa00>`) поддерживаются в значениях цвета ника и в строках форматирования viaSuper.

Возможности

Каналы чата

Локальный чат виден только в пределах настроенного радиуса. Глобальный чат доходит до каждого игрока. Чат персонала доступен только игрокам с правом viastyle.staff. Активный канал по умолчанию можно переключать для каждого игрока командой /chatmode. Если включён noone_heard, отправитель получает личное уведомление, когда рядом никого не было.

Личные сообщения

`/msg (алиасы/m, /w) отправляет личное сообщение. /reply(алиас/r`) отвечает последнему, кто вам написал. Игнорируемые игроки не могут отправлять ЛС. Исчезнувшие игроки исключаются из подсказок.

@Упоминания

Введите @PlayerName в любом сообщении, чтобы выделить его и проиграть звук на клиенте получателя. Используется частичное совпадение — @via совпадает с viaMeowts. Если установлен BlockBot, ввод @MinecraftName в игре может преобразоваться в ID пользователя Discord, чтобы Discord отображал это как настоящий пинг. Соответствие можно настроить вручную в discord_mention_mappings или заполнить автоматически из входящих сообщений Discord.

Система игнорирования

`/ignore ` переключает игнорирование. Сообщения и ЛС игнорируемого игрока молча отбрасываются. Состояние сохраняется между перезапусками.

Social Spy

/socialspy (требует viastyle.socialspy) перехватывает личные сообщения на всём сервере. Персонал может следить за локальным чатом и чатом персонала с любого расстояния.

Цвета ников

Игроки задают цвет через `/nickcolor . Принимаются именованные цвета, hex-коды (#rrggbb) и синтаксис градиента (#ff0000:#ffaa00). Хранится в config/viaStyle/nickcolors.json. Цвет применяется к чату, списку игроков и плавающему нику TextDisplay. Администраторы могут задать или сбросить цвет любого игрока через /nickcolor <colour|reset>. nametag_mode = displayотображает ники как сущности TextDisplay (полный RGB).nametag_mode = team` использует команды скорборда (16 ванильных цветов, лучшая совместимость).

Список игроков

viaStyle отправляет каждому игроку свой заголовок и подвал каждый тик. Шаблоны лежат в config/viaStyle/tablist.json. Игроки с активными логгерами Carpet HUD (/log tps, /log mobcaps и т. д.) автоматически исключаются из обновлений. Порядок сортировки в списке управляется sort_mode и использует вес LuckPerms, если он доступен.

Сообщения о входе / выходе

Ванильные сообщения о входе и выходе заменяются настроенными форматами. Отдельный формат транслируется при самом первом входе игрока.

viaSuper

/viasuper [text] отправляет эффектное объявление в виде заголовка/подзаголовка. Короткие слова отображаются как крупный заголовок; более длинные слова (длина >= viaSuperSubtitleLength) отображаются как подзаголовок. Форматирование MiniMessage и градиенты поддерживаются в viaSuperTitleFormat и viaSuperSubtitleFormat.

Мост в Discord (BlockBot)

Если установлен BlockBot, viaStyle передаёт чат Minecraft в Discord через ChatMessageEvent с sendRelayMessage в качестве запасного варианта. Оба пакета API BlockBot — современный и устаревший — определяются автоматически через рефлексию. Установите passthrough = true (по умолчанию), чтобы BlockBot сам обрабатывал форматирование из Discord в Minecraft. Установите passthrough = false, чтобы использовать discord_format из viaStyle.

BanHammer

Когда загружен BanHammer, игроки, пытающиеся писать в чат во время бана, получают стандартное сообщение BanHammer.

Интеграция с Carpet / Scarpet

Установите useScarpetEvents = true, чтобы viaStyle вызывал событие PLAYER_MESSAGE из Carpet для каждого обрабатываемого сообщения. Скрипты Scarpet могут перехватывать, изменять или отменять сообщения. Определение логгеров Carpet HUD работает независимо от этой настройки.

Команды

Права

Скрипты Scarpet

Включите use_scarpet_events = true в конфиге. viaStyle вызывает событие PLAYER_MESSAGE из Carpet для каждого сообщения. Скрипт может вернуть 'cancel', чтобы подавить сообщение, или вернуть изменённую строку, чтобы заменить содержимое. tools/scarpet_generator.py генерирует следующие шаблоны:

| viastyle_discord.sc | Ретрансляция очереди файлов для внешних Discord-ботов | | viastyle_welcome.sc | MOTD при входе | | viastyle_commands.sc | Команды в чате с префиксом # (#help, #roll, #tps) | | viastyle_stats.sc | Счётчик сообщений и слов для каждого игрока |

python tools/scarpet_generator.py --all --out /path/to/scripts

Скопируйте сгенерированные файлы .sc в `/scripts/и загрузите через/script load `.

Лицензия

MIT. См. LICENSE.