ReferenceConfiguration
permissions.json
Per-player permission levels.
Per-player permission level. Overrides default-player-permission-level from server.properties. Created on demand the first time op is run - you don't need to author it by hand.
Use the op and deop server commands instead of editing by hand when possible.
Sample
[
{
"permission": "operator",
"xuid": "2533274912345678"
},
{
"permission": "member",
"xuid": "2533274987654321"
}
]Permission levels
| Level | Capabilities |
|---|---|
visitor | Connect and look around. No block-interaction, no chat, no commands. |
member | Default. Build, break, chat, use non-cheat commands. |
operator | Full server-command access including cheats. Required for moderation commands. |
Fields
| Field | Type | Required | Description |
|---|---|---|---|
xuid | string | Yes | Xbox user ID. Use permission list in-server to find a player's XUID. |
permission | string | Yes | One of visitor, member, operator. |
Server commands
| Command | Description |
|---|---|
op <gamertag> | Promote to operator. Persists if the player is Xbox-Live authenticated; otherwise the promotion applies for the current session only. |
deop <gamertag> | Demote to member. Persists for XBL-authenticated players. |
permission list | List current entries with XUIDs. |
permission reload | Reload after a manual edit. |
online-mode is required
XUID-based identity only works when online-mode=true in server.properties. With online-mode=false, BDS cannot verify XUIDs through Xbox Live, so op/deop won't persist and permissions.json entries won't match anyone. Players not present in the file fall back to default-player-permission-level.