Skip to main content

Групи прав

Групи визначають, які команди гравець бачить в автодоповненні. Гравець потрапляє до групи через право commandguard.tab.<назваГрупи>. Група default діє на всіх без винятку.

Як це працює​

  1. Групи описуються в config.yml у секції tab:.
  2. Гравцю видається право commandguard.tab.<група> (наприклад, через LuckPerms чи будь-який плагін прав).
  3. Плагін обирає групу з найвищим пріоритетом серед тих, що є у гравця.

Базовий приклад​

tab:
  default:
    priority: 0
    commands:
      - "/spawn"
      - "/help"
  vip:
    priority: 1
    extends: default      # успадковує /spawn і /help
    commands:
      - "/home"
      - "/tpa"
  admin:
    priority: 2
    extends: vip
    commands:
      - "/gamemode"
      - "/tp"

Видати гравцю групу vip (приклад із LuckPerms):

/lp user <гравець> permission set commandguard.tab.vip true
зауваження

commandguard.tab.<група> — це звичайне право Bukkit. LuckPerms тут лише приклад; підійде будь-яка система прав.

Пріоритет і злиття​

  • Якщо у гравця одна група — використовується вона.
  • Якщо груп кілька — виграє та, що має найвищий пріоритет.
  • Якщо дві групи мають однаковий пріоритет — їхні списки команд об'єднуються.

Наслідування (extends)​

extends додає команди іншої групи до поточної, без повторення:

tab:
  moderator:
    priority: 3
    extends: vip        # отримує всі команди vip
    commands:
      - "/ban"
      - "/mute"

Наслідування рекурсивне: moderator → vip → default.

Групи для окремих серверів (servers) — тільки проксі​

На проксі групу можна обмежити конкретними бекенд-серверами через servers:

tab:
  survival-admin:
    priority: 2
    servers:
      - survival
      - survival2
    commands:
      - "/gamemode"

Така група діє лише коли гравець на сервері survival або survival2. Якщо servers не вказано — група діє на всіх серверах.

Режим білого списку​

За замовчуванням commands у config.yml — це чорний список (заблоковані). Якщо увімкнути whitelist, усе навпаки: дозволені лише перелічені команди.

use_commands_as_whitelist: true
commands:
  - "/spawn"
  - "/msg"

Тепер працюють лише /spawn і /msg, решта блокується.

Захист від spy-клієнтів​

CommandGuard фільтрує сирі пакети TAB_COMPLETE, тож чит-клієнти не можуть «витягнути» приховані команди повз звичайне автодоповнення. Приховані команди залишаються прихованими навіть для модифікованих клієнтів.