--- name: minecraft-role-manager description: >- Assign, update, or remove Minecraft server roles (owner, admin, moderator, player) by player nickname, synchronizing visual team prefixes/colors, LuckPerms groups, and OP status. --- # Minecraft Role Management Runbook Step-by-step procedure for assigning or revoking player roles by nickname on the Docker Forge 1.20.1 server (`mc-forge-server`). --- ## Role Definitions | Role | Team / LP Group | Prefix | Color | LP Weight | OP Level | Rights Summary | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | **Owner** | `owner` | `&c&l[OWN] ` *(bold red)* | `red` | `100` | `4` | Full server control (`/stop`, `/save-all`, `/op`, all Paradigm/mod commands) via OP 4 + LuckPerms `*` wildcard | | **Admin** | `admin` | `&c[ADM] ` *(red)* | `red` | `80` | `4` | Full OP 4 control (live via `op `, no restart) + LuckPerms `*` wildcard (all Paradigm/mod commands) | | **Moderator** | `moderator` | `&d[MOD] ` *(purple)* | `light_purple` | `60` | `0` | OP 3-equivalent moderation & gameplay commands via LuckPerms + Paradigm (live, no restart) | | **Player** | `default` *(no team)* | *(no prefix)* | Default | `10` | `0` | Normal survival gameplay + `CoreCommands` player commands | > **Note:** All role assignments apply **live with zero server restarts**. --- ### Step 1: Resolve Player Identity Run `resolve_player.py` to get the player's exact `name` and offline `uuid` from `server/data/usercache.json`: ```bash python3 .agents/plugins/minecraft-manager/skills/minecraft-role-manager/scripts/resolve_player.py ``` --- ### Step 2: Apply Role via RCON Activate the **`minecraft-rcon`** skill to execute the appropriate commands on `mc-forge-server` using the resolved `name` and `uuid` (falling back to `name` if `uuid` is `null`): - **Assign `owner`, `admin`, or `moderator`:** 1. `team join ` 2. `lp user parent set ` 3. `op ` *(for `owner` / `admin`)* **or** `deop ` *(for `moderator`)* 4. `team list ` *(verification)* - **Assign `player` (revoke elevated role):** 1. `team leave ` 2. `lp user parent set default` 3. `deop ` - **One-time group/team setup** *(only needed if teams or LuckPerms groups do not exist yet)*: - Teams: `team add `, `team modify color `, `team modify prefix ` - LuckPerms: `lp creategroup `, `lp group setweight `, `lp group meta setprefix ""`