Community Leaders

Мод Community Leaders для Minecraft Fabric предоставляет администраторам серверов мощный инструмент для распределенного управления сообществом. Система позволяет передавать полномочия по приглашению и модерации доверенным лидерам сообществ, таким как стримеры, контент-мейкеры и организаторы сообществ.

Иерархическая система управления

Мод реализует трехуровневую структуру управления:

• Администраторы сервера — предоставляют права на приглашение доверенным лидерам
• Лидеры сообществ — управляют собственными участниками и назначают модераторов
• Модераторы — помогают лидерам в управлении сообществом с делегированными правами

Такая система позволяет администраторам эффективно масштабировать управление сообществом, передавая часть полномочий проверенным лидерам при сохранении общего контроля.

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

Делегирование управления

Система позволяет администраторам предоставлять разрешение communityleaders.invite доверенным лидерам сообществ. Лидеры получают автономию в приглашении и управлении своими участниками, что способствует естественному росту сервера без необходимости постоянного вмешательства администрации.

Управление сообществами

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

Система модерации

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

Инструменты администратора

Администраторы получают доступ к визуализации структуры сообществ через команду /cl tree, мониторинг целостности данных и автоматическую синхронизацию с системой разрешений LuckPerms. Все сообщения и команды могут быть кастомизированы под бренд сервера.

Технические требования

• Minecraft: Версия 1.20.1
• Fabric Loader: Версия 0.16.14+
• Fabric API: Версия 0.92.6+1.20.1
• LuckPerms: Версия 5.4+ (обязательно для управления разрешениями)

Установка и настройка

1. Установите Fabric Loader и загрузите LuckPerms для Fabric
2. Поместите файл CommunityLeaders-1.x.x.jar и LuckPerms в папку mods/
3. При первом запуске сервера мод автоматически настроится, создав конфигурационные файлы в config/communityleaders/

Настройка групп в LuckPerms

# Создание групп лидеров сообществ
/lp creategroup streamer
/lp creategroup trusted_streamer

# Базовые разрешения для лидеров
/lp group streamer permission set communityleaders.invite true
/lp group streamer permission set communityleaders.ban true
/lp group streamer permission set communityleaders.moderator true

# Премиум-лидеры получают дополнительные права
/lp group trusted_streamer parent add streamer
/lp group trusted_streamer permission set communityleaders.tree true
/lp group trusted_streamer permission set communityleaders.unlimited true

# Назначение лидерства доверенным участникам
/lp user <streamer_name> parent add streamer
/lp user <premium_creator> parent add trusted_streamer

Доступные разрешения

Основные права

• communityleaders.invite — приглашение игроков через /cl invite, удаление приглашений и просмотр списка
• communityleaders.ban — бан приглашенных игроков через /cl ban
• communityleaders.moderator — управление модераторами через /cl mod add/remove/list
• communityleaders.tree — просмотр полной структуры сообществ через /cl tree
• communityleaders.unlimited — отключение лимитов приглашений

Типовые комбинации прав

• Базовый лидер: invite + ban
• Продвинутый лидер: добавляется moderator
• Премиум-лидер: добавляются tree + unlimited
• Администратор: все права или wildcard communityleaders.*

Конфигурация сервера

Файл config/communityleaders/config.yml позволяет настроить:

# Конфигурация Community Leaders
# Настройки административной системы делегирования

# Настройки команд
command:
  alias: "cl"  # Алиас для команды /communityleaders

# Ограничения управления сообществами
limits:
  max_invitations_per_leader: 10  # Лимит приглашений на лидера (-1 для отключения)

# Брендинг сервера - кастомизация всех сообщений
messages:
  invite_success: "Добро пожаловать в наше сообщество! '%player%' приглашен своим лидером."
  ban_reason: "Нарушение правил сообщества - забанен лидером сообщества."

Использование для лидеров сообществ

Основные команды управления

Лидеры используют команды /communityleaders или /cl (настраиваемый алиас):

• Приглашение и управление участниками:

  • /cl invite <игрок> — пригласить участника
  • /cl uninvite <игрок> — удалить приглашение
  • /cl ban <игрок> — забанить участника
  • /cl list — просмотреть список приглашенных

• Делегирование модерации:

  • /cl mod add <игрок> — назначить модератора
  • /cl mod remove <игрок> — снять модератора
  • /cl mod list — список модераторов

• Обзор сообщества:

  • /cl tree — просмотр структуры сообществ

Процесс модерации

1. Лидер приглашает участников через /cl invite
2. Лидер назначает доверенных участников модераторами через /cl mod add
3. Модераторы управляют сообществом лидера с теми же командами
4. Все действия отслеживаются как действия лидера для административного контроля

Административные инструменты

Мониторинг развития сообществ

Администраторы могут отслеживать структуру сообществ через команду /cl tree.

Хранение данных и резервное копирование

Мод хранит данные в JSON файлах для удобного администрирования:

• config/communityleaders/config.yml — конфигурация сервера
• config/communityleaders/invites.json — отношения приглашений
• config/communityleaders/moderators.json — структура модерации

Совет администратора: Регулярно создавайте резервные копии этих файлов для сохранения структуры сообществ.

Управление целостностью данных

Система автоматически поддерживает целостность данных:

• Синхронизация разрешений: при потере прав лидерами их сообщества автоматически очищаются
• Валидация модерации: модераторы, получающие права лидера, автоматически управляются системой
• Обновления в реальном времени: изменения через LuckPerms немедленно отражаются в структуре сообществ
• Проверка при запуске: полная проверка согласованности при каждом перезапуске сервера

Решение проблем

Частые проблемы настройки

1. Предупреждение "LuckPerms не найден":

   • Убедитесь, что LuckPerms загружается до Community Leaders
   • Проверьте правильность настройки LuckPerms

2. Лидеры не могут использовать команды:

   • Проверьте назначение разрешений в LuckPerms: /lp user <лидер> permission check communityleaders.invite
   • Убедитесь в правильности наследования групп: /lp user <лидер> info

3. Проблемы интеграции с вайтлистом:

   • Включите вайтлист сервера для лучших результатов: /whitelist on
   • Мод автоматически управляет записями вайтлиста для приглашенных игроков