> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aboutcapy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissions & commands

> Spyglass in-game commands and permissions.

## Available Commands

* `/spyglass reload` - Reload `config.yml` and `messages.yml`.

* `/spyglass status` - Show the Discord connection, monitor stats, and any config warnings.

* `/spyglass commands` - List every configured Discord command.

* `/spyglass test` - Post a test line to the monitor channel and report the result.

* `/spyglass help` - Show the command list in game.

* `/sg` - Alias for `/spyglass`.

* `/glass` - Alias for `/spyglass`.

## Permission Tree Matrix

| Permission Node | Default | Description |
| - | - | - |
| spyglass.admin | op | Full access to every Spyglass sub-command. |
| spyglass.reload | op | Use /spyglass reload. |
| spyglass.status | op | Use /spyglass status. |
| spyglass.commands | op | Use /spyglass commands. |
| spyglass.test | op | Use /spyglass test. |
| spyglass.monitor.bypass | false | Commands run by this player are never relayed to Discord. |

`spyglass.admin` grants the four sub-command nodes as children, so giving staff that one node is usually enough.

## Discord Side Permissions

Who may use a slash command is controlled in `config.yml`, not by Minecraft permissions. An empty list means everyone who can see the command in Discord.

```
custom-commands:
allowed-roles: ["Moderator", "1234567890123456789"]
allowed-users: []
allowed-channels: ["staff-commands"]
```

Roles, users, and channels are matched by name or by ID. Any command can override these with its own list, and adding `"@owner"` to `allowed-roles` always permits the Discord server owner.

## Hiding Staff Commands

Give an account `spyglass.monitor.bypass` to keep its commands out of the feed entirely. It defaults to nobody, so every command is relayed until you grant it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.