> 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/ultimatequest-zhong-wen-wen-dang/ji-chu-xin-xi/commands-permissions.md).

# 命令与权限

主命令 `/ultimatequest`，别名 `/uq`、`/quests`。无参数打开 `main`。玩家任务命令使用 `ultimatequest.use`（默认所有人）。

| 玩家命令                                                | 用途                |
| --------------------------------------------------- | ----------------- |
| `/uq help`                                          | 查看帮助。             |
| `/uq menu [menu]`                                   | 打开菜单，默认 `main`。   |
| `/uq accept <task>`                                 | 接取普通任务。           |
| `/uq info <task-or-instance>`                       | 查看目标/奖励。          |
| `/uq claim <task-or-instance>`                      | 领取完成任务奖励。         |
| `/uq abandon <task-or-instance>`                    | 放弃符合条件的普通任务。      |
| `/uq period` / `/uq scroll`                         | 查看周期任务/携带卷轴。      |
| `/uq battlepass [id]` / `/uq milestone [id]`        | 打开成长目录/详情。        |
| `/uq battlepass claim <id> <level> [free\|premium]` | 领取等级奖励，默认 `free`。 |
| `/uq milestone claim <id> <stage>`                  | 领取里程碑阶段。          |
| `/uq battlepass claimall <id>`                      | 领取全部符合条件的阶段。      |
| `/uq battlepass history <id>`                       | 列出已保存赛季。          |
| `/uq battlepass challenges <id>`                    | 打开挑战。             |
| `/uq battlepass stats <id>`                         | 查看成长统计。           |

共用处理器也在 `milestone` 下支持 `claimall`、`history`、`challenges`、`stats`。用 `<id>@<season>` 指定保存的赛季。

## 管理命令

```
/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>
```

管理操作需要 `ultimatequest.admin`（默认 OP）。成长管理也适用于 `milestone`，支持有记录的离线玩家。`resolve` 只处理 `CLAIMING`/`REVIEW` 阶段，操作前先核对实际发放情况。赛季管理见[战令](/ultimatequest-zhong-wen-wen-dang/pei-zhi/battlepasses.md)。

控制台派发需要 `ultimatequest.admin`，目标必须在线：

```
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]
```

菜单 `-b` 跳过菜单自身权限并在本次跳转中保留；奖励校验和禁用状态仍生效。管理员 `accept -b` 跳过前置、接取条件和活动检查，仍检查名额和重复接取。玩家向其他玩家派发任务需管理权限。

| 权限                                         | 默认  | 用途                                                   |
| ------------------------------------------ | --- | ---------------------------------------------------- |
| `ultimatequest.use`                        | 所有人 | 玩家命令与默认菜单。                                           |
| `ultimatequest.reload`                     | OP  | 重载。                                                  |
| `ultimatequest.admin`                      | OP  | 编辑器、派发、卷轴发放、成长管理。                                    |
| `ultimatequest.saveitem`                   | OP  | `/uq saveitem <id> [bukkit\|itemformat]`。            |
| `ultimatequest.givesaveitem`               | OP  | `/uq givesaveitem <id> [player] [amount]`；控制台必须指定玩家。 |
| `ultimatequest.generateitemformat`         | OP  | 导出主手物品。                                              |
| `ultimatequest.battlepass.example.premium` | 无人  | 默认战令高级资格。                                            |

菜单可配置自身权限，其他战令可设置自己的 `premium-permission`。

## 使用示例

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

玩家可以用前三条命令接取内置挖矿任务、查看要求，并在完成后领奖。发放卷轴和打开编辑器需要管理员权限。修改配置文件后，请执行重载命令。

## 导出物品

`/uq saveitem <ID> [bukkit|itemformat]` 保存主手物品供以后复用，`/uq givesaveitem <ID> [玩家] [数量]` 发放已保存物品，`/uq generateitemformat` 将主手物品导出到 `generated-item-format.yml`。文件示例和权限见[自定义物品](/ultimatequest-zhong-wen-wen-dang/pei-zhi/custom-items.md)。