TownyHerochatLink: автоматическая интеграция Towny и Herochat
Если вы управляете сервером Minecraft с экономическими и политическими механиками, то наверняка знакомы с плагинами Towny и Herochat. Первый отвечает за создание городов и наций, а второй — за гибкую систему чат-каналов. Однако их совместная работа часто требовала ручной настройки групп и каналов под каждое поселение. TownyHerochatLink решает эту проблему, полностью автоматизируя процесс. Плагин самостоятельно создаёт группы, назначает права и управляет чат-комнатами, привязанными к городам и нациям.
Как работает TownyHerochatLink
Принцип действия прост: как только в Towny появляется новый город, плагин генерирует для него отдельную группу с префиксом t: и соответствующий канал в Herochat. Для наций используется префикс n:. Игроки автоматически добавляются в нужную группу и получают разрешения на чтение и отправку сообщений в канале своего города или нации. При удалении поселения или нации плагин корректно удаляет связанные группу и канал, не оставляя мусора в конфигурациях.
Никнеймы каналов формируются из первых четырёх букв названия города или нации в верхнем регистре. Если возникает дубликат, к имени добавляется порядковый номер, начиная с 1. Это позволяет избежать конфликтов и сохраняет читаемость списка каналов.
Зависимости и совместимость
Для работы TownyHerochatLink необходимы три основных компонента: Towny, Herochat и Vault. Последний выступает мостом для взаимодействия с плагинами прав. Из-за ограничений Vault (отсутствие нативного метода удаления групп) разработчику пришлось вручную добавлять поддержку конкретных систем разрешений. На данный момент плагин совместим со следующими решениями:
- zPermissions
- Essentials GroupManager
- Другие плагины добавляются по запросам сообщества
Если вы используете менее популярный менеджер прав, автор готов рассмотреть его интеграцию в приоритетном порядке — достаточно оставить запрос в комментариях к моду. Кстати, для тех, кто ценит удобство и не хочет вручную отслеживать совместимость, лаунчер foxygame.net предлагает готовые сборки с автоматической проверкой зависимостей: вы просто выбираете нужный плагин из каталога, а лаунчер сам подгружает все необходимые библиотеки, избавляя от головной боли с конфликтами версий.
Команды и права
Плагин добавляет всего одну команду, но она критически важна при первоначальной настройке:
- /thcrefresh (алиас /thcr) — запускает синхронизацию. При первом включении плагин просканирует все существующие города и нации и убедится, что для каждого создан корректный канал. Это особенно полезно, если вы устанавливаете TownyHerochatLink на уже развитый сервер с десятками поселений.
Для выполнения команды требуется право thcl.refresh. Выдайте его администраторам или доверенным модераторам, чтобы они могли перезапустить синхронизацию после массовых изменений в структуре городов.
Гибкая конфигурация
Настройки плагина хранятся в файле config.yml и позволяют тонко управлять поведением. Вот ключевые параметры:
- createFor — раздельные флаги для городов (towns) и наций (nations). Можно отключить создание каналов для одного из типов объединений.
- createIn — указывает мир, в котором будут действовать каналы (например, casual_world).
- nations/towns — настройки цвета и формата ника для каждого типа канала. Цвет задаётся стандартными кодами (GOLD, AQUA и т.д.), а формат использует угловые скобки вместо фигурных, чтобы избежать конфликтов с синтаксисом YAML.
- permissions — список прав, которые автоматически выдаются игроку при вступлении в город или нацию. По умолчанию это herochat.autojoin, herochat.join, herochat.leave, herochat.speak и herochat.focus. К каждому праву автоматически добавляется суффикс с названием канала, обеспечивая изоляцию чатов.
Пример дефолтного конфига демонстрирует, как легко адаптировать плагин под стиль вашего сервера. Вы можете изменить цвета под тематику фракций или добавить дополнительные разрешения, если используете кастомные механики Herochat.
Известные нюансы и планы развития
Как и любой активно развивающийся проект, TownyHerochatLink имеет несколько задокументированных особенностей. При удалении города или нации в консоли может появиться ошибка о том, что группа или канал не существуют. Это ложное срабатывание, вызванное порядком обработки событий Towny — фактически группа и канал уже удалены, и сообщение можно игнорировать.
Другое ограничение касается названий городов: они не должны содержать неалфавитно-цифровые символы, например точки (herpderp2.0). Это связано с внутренней логикой формирования имён групп и каналов. Разработчик рекомендует придерживаться буквенно-цифровых наименований, чтобы избежать проблем.
В будущем ожидается расширение списка поддерживаемых плагинов разрешений и, возможно, добавление графического интерфейса для управления связями. Автор активно собирает обратную связь, поэтому любые предложения по улучшению приветствуются.
Заключение
TownyHerochatLink — это незаменимый инструмент для администраторов, которые хотят оживить социальное взаимодействие на сервере. Он избавляет от рутины ручного создания групп и каналов, поддерживает порядок в конфигурациях и делает коммуникацию между жителями городов и членами наций по-настоящему бесшовной. Благодаря минималистичному набору команд и прозрачной настройке плагин легко встраивается даже в сложные сборки с десятками модов. Установите его, запустите /thcrefresh — и ваши игроки сразу ощутят разницу, получив личное пространство для обсуждения городских дел и дипломатии.