Player Roles - управление ролями на сервере Fabric

Player Roles - это мод для Minecraft (Fabric), который позволяет раздавать игрокам разрешения через роли, как в Discord. Всё настраивается в JSON-файле, который можно менять на лету без перезапуска сервера. Если вы администрируете сервер и хотите тонко управлять правами, но не хотите ставить громоздкие плагины - этот мод для вас.

Как это работает

Роли и их права описываются в файле config/roles.json. Каждая роль имеет уровень (level) и набор переопределений (overrides). Чем выше уровень, тем приоритетнее роль. Есть базовая роль everyone, которая есть у всех игроков по умолчанию - её нельзя удалить. Остальные роли накладываются поверх неё.

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

{
  "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"
      }
    }
  }
}

Здесь админу разрешены все команды, он виден в чате с красным жирным именем и суффиксом *, а обычные игроки могут только help. Если у игрока несколько ролей, применяется роль с наибольшим уровнем.

Типы переопределений

Мод поддерживает несколько видов настроек, которые меняют поведение игры для игроков с определённой ролью.

Команды (commands)

Позволяет разрешать или запрещать команды по регулярным выражениям. Например:

• ".*": "allow" - все команды разрешены.
• "gamemode (spectator|adventure)": "allow" - только режимы наблюдателя и приключений.
• Можно также использовать "hidden", чтобы команда работала, но не отображалась в подсказках.

Оформление имени (name_decoration)

Меняет цвет, стиль, префикс и суффикс имени игрока в чате и списке игроков. Пример:

"name_decoration": {
  "prefix": {"text": "[Prefix] ", "color": "green"},
  "suffix": {"text": "-Suffix"},
  "style": ["#ff0000", "bold", "underline"],
  "contexts": ["chat", "tab_list"]
}

Контексты определяют, где применять: chat (чат) и tab_list (список игроков). По умолчанию - везде. Приоритет ниже, чем у цветов командной таблички.

Тип чата (chat_type)

Заменяет оформление сообщений в чате для игроков с ролью. Интегрируется с ванильным реестром minecraft:chat_type, который можно менять через датапак. Например:

"chat_type": "minecraft:say_command"

Можно создавать свои типы чата через датапак в data/<namespace>/chat_type/<name>.json.

Уровень прав (permission_level)

Устанавливает ванильный уровень прав (0-4). Полезно для совместимости с другими модами и ванильными функциями, которые не поддерживаются напрямую.

Мут (mute)

Просто запрещает игроку писать в чат. Указывается как "mute": true.

Обратная связь команд (command_feedback)

По умолчанию операторы видят глобальные уведомления о выполнении команд другими игроками. Эта опция включает такие уведомления для выбранных ролей.

Селекторы сущностей (entity_selectors)

Обычно селекторы вроде @e доступны только с уровнем прав 2+. Эта опция даёт возможность использовать их игрокам с ролью.

Дополнительные настройки

Можно применить роль к командным блокам или исполнителям функций через конфиг:

{
  "commands": {
    "apply": {
      "command_block": true,
      "function": true
    },
    "overrides": {}
  }
}

Также одна роль может наследовать переопределения другой через includes:

{
  "foo": {
    "includes": ["bar"],
    "overrides": {
      "commands": {
        ".*": "allow"
      }
    }
  },
  "bar": {
    "overrides": {
      "name_decoration": {
        "style": "red"
      }
    }
  }
}

Здесь роль foo унаследует красное оформление имени от bar.

Команды в игре

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

• /role assign <игрок> <роль> - назначить роль.
• /role remove <игрок> <роль> - снять роль.
• /role list <игрок> - показать все роли игрока.
• /role reload - перезагрузить roles.json без перезапуска сервера.

Зачем это нужно

Если у вас сервер с разными привилегиями - донатерами, модераторами, админами - мод Player Roles даёт гибкую и лёгкую систему без лишних зависимостей. Всё хранится в одном JSON, легко правится и быстро применяется. На слабом железе не грузит сервер, так как работает на уровне Fabric API.

Скачайте мод Player Roles и настройте удобное управление правами на своём сервере Minecraft!