> 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/gong-neng/editor.md).

# 游戏内编辑器

管理员可以在游戏内浏览和修改配置，无需退出游戏。使用以下命令打开：

```
/uq editor
```

权限为 `ultimatequest.admin`。编辑器默认开启，可以通过 `config.yml -> editor.enabled` 关闭。

## 打开文件

可以在编辑器中选择分类和文件，也可以直接打开指定文件：

```
/uq editor task miner
/uq editor scroll novice
/uq editor menu main
```

| 范围            | 对应文件                   |
| ------------- | ---------------------- |
| `quest`       | `quests/` 中的可复用目标。     |
| `task`        | `tasks/` 中的普通任务。       |
| `category`    | `categories/` 中的任务分类。  |
| `battlepass`  | `battlepasses/` 中的战令。  |
| `milestone`   | `milestones/` 中的里程碑。   |
| `period`      | `periods/` 中的周期任务。     |
| `scroll`      | `scrolls/` 中的任务卷轴。     |
| `pool`        | `pools/` 中的目标池。        |
| `reward-pool` | `reward-pools/` 中的奖励池。 |
| `menu`        | `menus/` 中的菜单。         |

## 修改和应用

1. 打开文件，选择需要修改的配置项。
2. 修改文本、数值、列表、嵌套配置或物品。分类选择支持多选。
3. 检查修改后，选择 **校验并应用（Validate and Apply）**。
4. 如果提示校验错误，修正后再次应用。

应用前的修改只是草稿。应用时会创建备份并重载对应配置；校验失败时恢复原文件。

编辑器打开期间，请勿同时从外部修改同一文件。文件已经变化时，请重新打开再编辑。任务修改对新任务生效，不会改写玩家已有任务的目标和奖励。