Player Roles для Fabric

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

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

Система работает через конфигурационный файл JSON, расположенный в директории конфигурации (<root>/config/roles.json). Этот файл можно редактировать и перезагружать прямо во время работы сервера, что удобно для быстрого тестирования и настройки.

Пример конфигурации

{
  "admin": {
    "level": 100,
    "overrides": {
      "name_decoration": {
        "style": ["red", "bold"],
        "suffix": {"text": ""}
      },
      "permission_level": 4,
      "command_feedback": true,
      "commands": {
        ".": "allow"
      }
    }
  },
  "spectator": {
    "level": 10,
    "overrides": {
      "commands": {
        "gamemode (spectator|adventure)": "allow"
      }
    }
  },
  "mute": {
    "level": 1,
    "overrides": {
      "mute": true
    }
  },
  "everyone": {
    "overrides": {
      "commands": {
        "help": "allow",
        ".*": "deny"
      }
    }
  }
}

В этом примере определены четыре роли: admin, spectator, mute и everyone. Роль everyone является базовой и автоматически назначается всем игрокам, ее нельзя удалить. Остальные роли действуют как дополнительные настройки поверх базовой роли.

Типы настроек

Управление командами

Настройка commands позволяет контролировать, какие команды могут использовать игроки. Вы можете задавать регулярные выражения для сопоставления команд и определять стратегии обработки:

• allow - разрешить использование команды
• deny - запретить использование команды
• hidden - разрешить команду, но скрыть ее из подсказок

Оформление имен

С помощью name_decoration можно изменять отображение имен игроков в чате и списке игроков. Доступны следующие параметры:

• style - стиль текста (цвет, жирный, подчеркнутый)
• prefix - текст перед именем
• suffix - текст после имени
• contexts - где применять оформление (chat, tab_list)

Типы чата

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

Дополнительные возможности

• permission_level - устанавливает уровень разрешений ванильной системы
• mute - блокирует возможность писать в чат
• command_feedback - включает уведомления о выполнении команд
• entity_selectors - разрешает использование селекторов сущностей

Расширенные функции

Роли могут наследовать настройки от других ролей через параметр includes. Также можно применять роли к командным блокам и исполнителям функций.

Управление в игре

Для управления ролями используется команда /role:

• /role assign <игрок> <роль> - назначить роль
• /role remove <игрок> <роль> - удалить роль
• /role list <игрок> - показать роли игрока
• /role reload - перезагрузить конфигурацию

Система автоматически разрешает конфликты между ролями, выбирая настройки из роли с наивысшим уровнем.