Command Controls

Command Controls

Полный контроль над тем, какие команды видят и могут использовать ваши игроки!

Command Controls — мощный мод для управления сервером, позволяющий настраивать доступ к командам в зависимости от ранга игрока — с бесшовной интеграцией с LuckPerms.

✨ Возможности

🔒 Полный контроль над командами

• Скрытие команд из автодополнения — игроки видят только то, что им разрешено использовать
• Блокировка выполнения несанкционированных команд
• Права на основе рангов — настраивайте разные команды для разных групп игроков

🔗 Интеграция с LuckPerms

• Автоматически определяет группы игроков из LuckPerms
• Команды мгновенно синхронизируются при смене ранга игрока
• Команда настройки в один клик: /commandcontrols luckperms-setup

🎮 Совместимость с модами

• Работает с ванильными командами И командами модов
• Совместим с модами, использующими стандартные проверки прав Minecraft (hasPermissionLevel)
• Примеры: Create, WorldEdit, Carpet Mod, Essential Commands и т.д.
• Клиентская фильтрация для модов вроде Xaero's Minimap, Litematica и т.д.

⚠️ Примечание: Моды с собственными системами прав (например, Impactor) требуют настройки прав напрямую в LuckPerms, а не через этот мод.

📦 Установка

Сервер (обязательно)

1. Установите Fabric Loader и Fabric API
2. Поместите JAR-файл мода в папку mods
3. (Рекомендуется) Установите LuckPerms для прав на основе рангов

Клиент (опционально)

Установите на клиентах, чтобы также скрывать команды клиентских модов.

⚙️ Конфигурация

Отредактируйте config/commandcontrols/commands.json:

{
  "rank_hierarchy": ["default", "premium", "vip", "vip+", "moderator", "admin", "owner"],
  "bypass_commands": ["help"],
  "commands": {
    "all_ranks": ["help", "msg", "me", "seed", "list"],
    "vip": ["nick", "hat", "fly"],
    "moderator": ["kick", "tp", "teleport", "clear", "spectate"],
    "admin": ["ban", "give", "gamemode", "time", "weather", "effect", "summon"],
    "owner": ["stop", "op", "deop", "whitelist", "luckperms", "reload"]
  }
}

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

• rank_hierarchy — ранги от низшего к высшему (высшие ранги наследуют команды низших)
• all_ranks — команды, доступные всем
• [rank] — команды для этого конкретного ранга и выше

🎯 Настройка LuckPerms

Автоматически (рекомендуется)

Просто выполните от имени OP:

/commandcontrols luckperms-setup

Это автоматически настроит LuckPerms для всех ваших рангов!

Резервный вариант (без LuckPerms)

Без LuckPerms мод использует ванильные уровни OP:

• OP 4 → owner
• OP 3 → admin
• OP 2 → moderator
• Все остальные → default

📋 Команды

Все команды требуют OP level 4

🔧 Технические детали

• Переопределяет права команд через рефлексию (аналогично Player Roles)
• Перехватывает пакеты дерева команд для фильтрации видимости
• Отслеживает контекст выполнения команд для проверки прав
• Слушает события LuckPerms для мгновенной синхронизации при смене ранга

📝 Требования

• Minecraft 1.20.1
• Fabric Loader 0.14.21+
• Fabric API
• fabric-permissions-api (включён/встроен)

Опционально

• LuckPerms — для прав по рангам

❓ FAQ

В: Работает ли это с командами модов?
О: Да, для модов, которые используют стандартную проверку Minecraft hasPermissionLevel() (большинство модов). Модам с собственной системой прав (например, Impactor, использующий Cloud Commands) нужно задавать права напрямую в LuckPerms.

В: Нужно ли игрокам устанавливать мод?
О: Нет, серверная версия работает нормально. Но установка на клиентах также скрывает клиентские команды модов.

В: Команды видны, но не выполняются?
О: Убедитесь, что команда есть в вашем конфиге и у игрока правильная группа в LuckPerms.