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

# In-game Editor

The editor lets administrators browse and edit configuration without leaving the game. Open it with:

```
/uq editor
```

Permission: `ultimatequest.admin`. The editor is enabled by default; use `config.yml -> editor.enabled` to disable it.

## Opening a file

Choose a category and a file from the editor, or open it directly:

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

| Scope         | Files                             |
| ------------- | --------------------------------- |
| `quest`       | Reusable objectives in `quests/`. |
| `task`        | Normal tasks in `tasks/`.         |
| `category`    | Task categories in `categories/`. |
| `battlepass`  | Battle passes in `battlepasses/`. |
| `milestone`   | Milestones in `milestones/`.      |
| `period`      | Periodic tasks in `periods/`.     |
| `scroll`      | Quest scrolls in `scrolls/`.      |
| `pool`        | Objective pools in `pools/`.      |
| `reward-pool` | Reward pools in `reward-pools/`.  |
| `menu`        | Menus in `menus/`.                |

## Editing and applying changes

1. Open the file and select a setting.
2. Edit its text, number, list, nested section, or item. Category selection allows multiple categories.
3. Review your changes, then choose **Validate and Apply**.
4. If validation reports an error, correct it and try again.

Changes remain a draft until applied. Applying creates a backup and reloads the relevant configuration. If validation fails, the original file is restored.

Do not edit the same file externally while it is open in the editor. If the file has changed, reopen it before continuing. Changes to a task apply to new tasks; they do not rewrite the objectives or rewards of tasks players already have.