> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticswords/permissions.md).

# Permissions

Permission nodes and staff commands for ManticSwords.

Grant only the nodes staff or players need through your server's permission manager. The player-use permissions below default to everyone; administrative and editor permissions default to operators.

## Staff commands

| Command                                                 | Permission                                    | Use                                                                                                                                                                                          |
| ------------------------------------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/manticsword menu <player>`                            | `manticsword.menu.other`                      | Open another player's menu.                                                                                                                                                                  |
| `/manticsword editor`                                   | `manticsword.editor`                          | Open the in-game configuration editor.                                                                                                                                                       |
| `/manticsword reset <player>`                           | `manticsword.player.reset`                    | Reset one player's ManticSwords data.                                                                                                                                                        |
| `/manticsword reset all`                                | `manticsword.player.resetall`; console only   | Start or confirm a reset of all saved ManticSwords player data. Run the same command again within 10 seconds.                                                                                |
| `/crystals resetall`                                    | `manticsword.crystals.resetall`; console only | Start or confirm a reset of all crystal balances. Repeat the configured crystals command with `resetall` within 10 seconds. Progress, enchant levels, prestige and player settings are kept. |
| `/manticsword captcha <player>`                         | `manticsword.captcha.force`                   | Send a captcha to an online player.                                                                                                                                                          |
| `/manticsword captcha clear <player>`                   | `manticsword.captcha.force`                   | Close the player's active captcha and reset its failure count and tool-block cooldown.                                                                                                       |
| `/manticsword event start` or `/manticsword event stop` | `manticsword.event.admin`                     | Start or stop the event when it is enabled.                                                                                                                                                  |

## Nodes

| Node                            | Default   | Allows                                                                                                                                                 |
| ------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `manticsword.give.sword`        | Operators | Give configured swords with `/manticsword give`.                                                                                                       |
| `manticsword.menu.other`        | Operators | Open another player's menu with `/manticsword menu <player>`.                                                                                          |
| `manticsword.editor`            | Operators | Open the in-game configuration editor.                                                                                                                 |
| `manticsword.editor.logs`       | Operators | View editor activity from the editor.                                                                                                                  |
| `manticsword.reload`            | Operators | Reload plugin settings.                                                                                                                                |
| `manticsword.player.reset`      | Operators | Reset one player's ManticSwords data.                                                                                                                  |
| `manticsword.player.resetall`   | Operators | From the console, reset all saved ManticSwords player data. Run `/manticsword reset all` again within 10 seconds to confirm.                           |
| `manticsword.mobs.reset`        | Operators | Reset one player's or all players' mob kill counts.                                                                                                    |
| `manticsword.captcha.force`     | Operators | Use `/manticsword captcha <player>` to send a captcha, or `/manticsword captcha clear <player>` to close one and reset its failure count and cooldown. |
| `manticsword.event.admin`       | Operators | Start or stop the mob-slaying event.                                                                                                                   |
| `manticsword.crystals.pay`      | Everyone  | Pay crystals to another player.                                                                                                                        |
| `manticsword.crystals.give`     | Operators | Give crystals to a player.                                                                                                                             |
| `manticsword.crystals.remove`   | Operators | Remove a player's crystals.                                                                                                                            |
| `manticsword.crystals.set`      | Operators | Set a player's crystal balance.                                                                                                                        |
| `manticsword.crystals.reset`    | Operators | Reset one player's crystal balance.                                                                                                                    |
| `manticsword.crystals.resetall` | Operators | From the console, reset all crystal balances. Run the configured crystals command with `resetall` again within 10 seconds to confirm.                  |
| `manticsword.levels.reset`      | Operators | Reset a player's enchant levels when player-based levels are enabled.                                                                                  |
| `manticsword.levels.set`        | Operators | Set a player's enchant level when player-based levels are enabled.                                                                                     |
| `manticsword.levels.add`        | Operators | Add to a player's enchant level when player-based levels are enabled.                                                                                  |
| `manticsword.levels.remove`     | Operators | Remove from a player's enchant level when player-based levels are enabled.                                                                             |
| `manticsword.prestige.use`      | Everyone  | Use the prestige command and open the prestige menu.                                                                                                   |
| `manticsword.prestige.level`    | Everyone  | Check prestige levels.                                                                                                                                 |
| `manticsword.prestige.set`      | Operators | Set prestige levels.                                                                                                                                   |
| `manticsword.prestige.add`      | Operators | Add prestige levels.                                                                                                                                   |
| `manticsword.prestige.auto`     | Everyone  | Toggle auto-prestige in the sword settings menu.                                                                                                       |

Both all-player resets are console-only: `manticsword.crystals.resetall` clears crystal balances, while `manticsword.player.resetall` clears all saved player data.
