> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-ultimatequest/information/commands-permissions.md).

# Commands & Permissions

Main command: `/ultimatequest`; aliases: `/uq`, `/quests`. No arguments opens `main`. Player commands use `ultimatequest.use` (default everyone).

| Player command                                      | Purpose                                |
| --------------------------------------------------- | -------------------------------------- |
| `/uq help`                                          | Show help.                             |
| `/uq menu [menu]`                                   | Open a menu; default `main`.           |
| `/uq accept <task>`                                 | Accept a normal task.                  |
| `/uq info <task-or-instance>`                       | Show objectives/rewards.               |
| `/uq claim <task-or-instance>`                      | Claim a completed task.                |
| `/uq abandon <task-or-instance>`                    | Abandon an eligible normal task.       |
| `/uq period` / `/uq scroll`                         | View periodic tasks / carried scrolls. |
| `/uq battlepass [id]` / `/uq milestone [id]`        | Open progression catalog/details.      |
| `/uq battlepass claim <id> <level> [free\|premium]` | Claim a level; default track `free`.   |
| `/uq milestone claim <id> <stage>`                  | Claim a milestone stage.               |
| `/uq battlepass claimall <id>`                      | Claim eligible stage rewards.          |
| `/uq battlepass history <id>`                       | List saved seasons.                    |
| `/uq battlepass challenges <id>`                    | Open challenges.                       |
| `/uq battlepass stats <id>`                         | Show progression stats.                |

The shared progression handler also exposes `claimall`, `history`, `challenges`, and `stats` under `milestone`. Use `<id>@<season>` to address a saved season.

## Administration

```
/uq reload
/uq editor [quest|task|category|battlepass|milestone|period|scroll|pool|reward-pool|menu] [id]
/uq accept <task> <online-player> [-b]
/uq scroll give <online-player> <profile> [rarity] [difficulty]
/uq battlepass addxp <player-or-UUID> <id> <amount>
/uq battlepass setxp <player-or-UUID> <id> <total>
/uq battlepass removexp <player-or-UUID> <id> <amount>
/uq battlepass setlevel <player-or-UUID> <id> <level>
/uq battlepass premium <player-or-UUID> <id> <true|false>
/uq battlepass boost <player-or-UUID> <id> <multiplier> <seconds>
/uq battlepass resolve <player-or-UUID> <id> <track/stage> <AVAILABLE|CLAIMED>
/uq battlepass editor <id>
```

Management uses `ultimatequest.admin` (default OP). Progression edits also work under `milestone` and can address stored offline players. `resolve` only handles unresolved `CLAIMING`/`REVIEW` stages: inspect actual reward delivery first. See [battle passes](/for-ultimatequest/configuration/battlepasses.md) for season management.

Console dispatch requires `ultimatequest.admin` and an online target:

```
uq menu [menu] <player> [-b]
uq accept <task> <player> [-b]
uq info <task-or-instance> <player>
uq claim <task-or-instance> <player>
uq abandon <task-or-instance> <player>
uq period <player> [-b]
uq scroll <player> [-b]
uq battlepass [id] <player> [-b]
uq battlepass challenges <id> <player> [-b]
uq battlepass claim <id> <level> [free|premium] <player>
uq battlepass claimall <id> <player>
uq milestone [id] <player> [-b]
```

Menu `-b` skips its own permission and persists during navigation; reward checks and disabled menus still apply. Administrative `accept -b` skips prerequisites, acceptance conditions, and activity checks, while still enforcing slots and duplicates. Players dispatching tasks to others need admin permission.

| Permission                                 | Default  | Purpose                                                             |
| ------------------------------------------ | -------- | ------------------------------------------------------------------- |
| `ultimatequest.use`                        | Everyone | Player commands and bundled menus.                                  |
| `ultimatequest.reload`                     | OP       | Reload.                                                             |
| `ultimatequest.admin`                      | OP       | Editor, dispatch, scroll issuance, progression management.          |
| `ultimatequest.saveitem`                   | OP       | `/uq saveitem <id> [bukkit\|itemformat]`.                           |
| `ultimatequest.givesaveitem`               | OP       | `/uq givesaveitem <id> [player] [amount]`; console requires player. |
| `ultimatequest.generateitemformat`         | OP       | Export main-hand item.                                              |
| `ultimatequest.battlepass.example.premium` | Nobody   | Bundled pass premium access.                                        |

Menus set their own permissions; passes can set their own `premium-permission`.

## Examples

```
/uq accept miner
/uq info miner
/uq claim miner
/uq scroll give Steve novice
/uq editor task miner
/uq reload
```

Use the first three as a player to accept the built-in mining task, check its requirements, and claim its reward after completion. The scroll and editor commands require administrator permission. Reload after editing configuration files.

## Exporting items

`/uq saveitem <id> [bukkit|itemformat]` saves the main-hand item for reuse. `/uq givesaveitem <id> [player] [amount]` gives a saved item, and `/uq generateitemformat` exports the main-hand item to `generated-item-format.yml`. See [Custom Items](/for-ultimatequest/configuration/custom-items.md) for file examples and permissions.