Player Roles

Мод Player Roles для Minecraft — управление правами доступа и ролями игроков

Мод Player Roles для Fabric позволяет администраторам серверов Minecraft гибко управлять правами доступа игроков, используя систему, аналогичную ролям в Discord. Мод не меняет игровую механику, а лишь накладывает ограничения и настройки на основе назначенных ролей. Основной инструмент — команда /role, которая позволяет назначать роли, менять их конфигурацию в реальном времени и управлять списком участников. Настройки хранятся в файле roles.json, где можно задать уровень прав, цвет имени, доступ к командам, режим молчания и другие параметры.

Система управления ролями и правами доступа для серверов Minecraft на загрузчике Fabric. Мод реализует аналог ролевой системы, знакомой пользователям Discord, позволяя администраторам гибко настраивать поведение игроков без необходимости перезапуска сервера. Все изменения применяются динамически через конфигурационный файл, что обеспечивает быструю итерацию при разработке серверных правил.

Ядро системы построено на концепции переопределений (Overrides). Мод не заменяет базовые настройки игры, а накладывает их поверх стандартных прав по умолчанию. Каждая роль в конфигурации определяет набор параметров, которые активируются для игроков, получивших эту роль. При наличии нескольких ролей у одного игрока, система автоматически разрешает конфликты, выбирая настройки у роли с более высоким уровнем приоритета (permission level).

Управление командами осуществляется через регулярные выражения, сопоставляемые с именами команд. Для каждого совпадения можно задать стратегию: разрешить использование (allow), запретить (deny) или скрыть команду из подсказок (hidden). Это позволяет создавать сложные правила доступа, например, разрешить игрокам с ролью «Спектейтор» только команды смены режима игры, а всем остальным игрокам запретить доступ к большинству команд, кроме базовой помощи.

Внешний вид игроков на сервере можно кастомизировать с помощью декораций имен. Для каждой роли можно задать префикс и суффикс текста, а также стилизацию шрифта (жирный, курсив, подчеркивание) и цвет. Эти настройки применяются в чате и списке игроков (tab list). Важно отметить, что приоритет декораций имен ниже, чем цветов команд командных досок (scoreboard teams), что позволяет администраторам сохранять читаемость чата при использовании системных цветов.

Мод интегрируется с системой типов чата Minecraft, позволяя менять стиль сообщений игроков. Например, сообщения от администраторов могут отображаться как системные уведомления (say_command), выделяясь на фоне обычного чата. Для создания уникальных стилей сообщений можно использовать пользовательские datapacks, определяя новые типы чата, которые затем вызываются в конфигурации модов.

Управление правами доступа к функциям сервера осуществляется через настройку уровня разрешений (permission level). Это критически важно для взаимодействия с другими модами и ванильными функциями, требующими прав оператора или администратора. Мод также предоставляет возможность разрешить использование селекторов сущностей (entity_selectors) для игроков с низким уровнем прав, что обычно запрещено в ванильном Minecraft.

Для повышения удобства администрирования мод поддерживает наследование настроек. Роль может включать в себя конфигурацию другой роли с помощью ключа includes, а затем добавлять свои собственные переопределения. Это позволяет создавать иерархию ролей: например, роль «Менеджер» может наследовать все настройки «Сотрудника», но добавлять к ним доступ к дополнительным командам управления.

Применение ролей к командным блокам и исполнителям функций также настраивается через конфигурацию. Это позволяет создавать сложные игровые механики, где доступ к определенным командам или функциям зависит от роли игрока, запускающего блок. Например, можно настроить так, чтобы только игроки с ролью «Администратор» могли активировать блоки, открывающие секретные зоны.

Для применения изменений после редактирования файла конфигурации необходимо использовать команду:

```/role reload```

Основные команды управления:
- `/role assign <Игрок> <Роль>` — назначает роль игроку.
- `/role remove <Игрок> <Роль>` — удаляет роль у игрока.
- `/role list <Игрок>` — выводит список всех назначенных ролей.
- `/role reload` — перезагружает конфигурацию без перезапуска сервера.

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

Пример конфигурации роли «Спектейтор» с ограниченным доступом к командам:

```json
"spectator": {
  "level": 10,
  "overrides": {
    "commands": {
      "gamemode (spectator|adventure)": "allow"
    }
  }
}
```

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Dynamic FPS — похожий мод
• Fzzy Config — похожий мод
• Cherished Worlds — похожий мод

Автор: NucleoidMC · Лицензия: MIT