> For the complete documentation index, see [llms.txt](https://cyr1en.gitbook.io/commandprompter/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cyr1en.gitbook.io/commandprompter/getting-started/commands-and-permissions.md).

# Commands and Permissions

All administrative commands except the delegates are children of `/commandprompter` (alias `/cmdp`).

## Commands

| Command                                                  | Alias   | Sender       | Description                                                                                                              | Permission                    |
| -------------------------------------------------------- | ------- | ------------ | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
| `/commandprompter`                                       | `/cmdp` | Any          | Shows CommandPrompter help.                                                                                              | None                          |
| `/cmdp reload`                                           | None    | Any          | Cancels all active sessions, then reloads both YAML files, the parser, locales, and `presets.json`.                      | `promptpaper.reload`          |
| `/cmdp cancel`                                           | None    | Player       | Cancels only the sender's active prompt session.                                                                         | `promptpaper.cancel`          |
| `/cmdp version`                                          | None    | Any          | Shows the plugin version.                                                                                                | `promptpaper.version`         |
| `/cmdp migrate [--dry-run] <path>`                       | None    | Any          | Previews or migrates V2 prompts in a file under `plugins/`, backing it up before applying changes.                       | `promptpaper.migrate`         |
| `/cmdp migrate undo <backup>`                            | None    | Any          | Restores a migration backup after backing up the destination’s current contents.                                         | `promptpaper.migrate`         |
| `/cmdp preset add <id> <inline prompt...>`               | None    | Any          | Converts one inline prompt to a structured JSON preset with an unused ID.                                                | `promptpaper.preset`          |
| `/cmdp preset update <id> <inline prompt...>`            | None    | Any          | Replaces an existing prompt preset's complete definition.                                                                | `promptpaper.preset`          |
| `/cmdp preset remove <id>`                               | None    | Any          | Deletes an existing prompt preset.                                                                                       | `promptpaper.preset`          |
| `/consoledelegate <target> <command...>`                 | `/cd`   | Console only | Prompts the target player, then executes the completed command as console.                                               | `promptpaper.consoledelegate` |
| `/playerdelegate <target> <permission-key> <command...>` | `/pd`   | Console only | Prompts the target player, then executes the completed command as that player with the configured temporary permissions. | `promptpaper.playerdelegate`  |

See [Preset management](/commandprompter/prompts/presets.md#create-and-manage-prompt-presets) for conversion examples, ID completion, and immediate activation.

See [Prompt migration](/commandprompter/features/prompt-migration.md) for file autocomplete, backups, undo, and path examples.

Delegate targets accept player names and single-target Minecraft selectors such as `@p`. The commands use Paper's singular player argument, so multi-target selectors such as `@a` are rejected.

When `Enable-Permission` is enabled, a prompted delegate flow starts only if the target has `promptpaper.use`; the console sender's delegate permission does not bypass that target-side gate. A direct delegated command with no prompt tags is still dispatched.

{% hint style="warning" %}
Reload cancels every active prompt session before publishing the new configuration.
{% endhint %}

## Permissions

The permission declarations treat permissions as operator-only by default, except `promptpaper.cancel` which defaults to `true` (changed in 3.2.0).

| Permission                    | Description                                                                                                                                                                                                                                                                       | Default |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `promptpaper.admin`           | Master permission that grants every permission below (`promptpaper.reload`, `promptpaper.migrate`, `promptpaper.preset`, `promptpaper.cancel`, `promptpaper.version`, `promptpaper.use`, `promptpaper.consoledelegate`, `promptpaper.playerdelegate`, `promptpaper.pcm.console`). | OP      |
| `promptpaper.reload`          | Allows `/cmdp reload`.                                                                                                                                                                                                                                                            | OP      |
| `promptpaper.migrate`         | Allows migration, dry-run previews, undo, and their file autocomplete suggestions.                                                                                                                                                                                                | OP      |
| `promptpaper.preset`          | Allows creating, updating, and removing prompt presets, including ID autocomplete suggestions.                                                                                                                                                                                    | OP      |
| `promptpaper.cancel`          | Allows `/cmdp cancel` to cancel the sender's own active prompt session (changed to `true` in 3.2.0).                                                                                                                                                                              | `true`  |
| `promptpaper.version`         | Allows `/cmdp version`.                                                                                                                                                                                                                                                           | OP      |
| `promptpaper.use`             | Allows prompt interception when `Enable-Permission` is enabled.                                                                                                                                                                                                                   | OP      |
| `promptpaper.consoledelegate` | Allows the console delegate command. The command also has a console-only sender restriction.                                                                                                                                                                                      | OP      |
| `promptpaper.playerdelegate`  | Allows the player delegate command. The command also has a console-only sender restriction.                                                                                                                                                                                       | OP      |
| `promptpaper.pcm.console`     | Gates post-commands that execute as console (added in 3.2.0).                                                                                                                                                                                                                     | OP      |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cyr1en.gitbook.io/commandprompter/getting-started/commands-and-permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
