> 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/configuration-files.md).

# 配置文件

以下路径均相对于 `plugins/UltimateQuest/`。

| 路径                   | 用途                                                                                  |
| -------------------- | ----------------------------------------------------------------------------------- |
| `config.yml`         | 语言、数学计算、自动保存、任务名额、数据库、编辑器与分类菜单默认值。                                                  |
| `languages/*.yml`    | 消息与 `override-lang` 文案；内置 `en_US`、`zh_CN`。                                          |
| `quests/*.yml`       | [可复用目标模板](/ultimatequest-zhong-wen-wen-dang/pei-zhi/objectives.md)，供普通任务、周期任务等引用。   |
| `tasks/*.yml`        | [普通任务](/ultimatequest-zhong-wen-wen-dang/pei-zhi/tasks.md)。                         |
| `categories/*.yml`   | [分类名称、图标和排序](/ultimatequest-zhong-wen-wen-dang/pei-zhi/categories.md)。              |
| `pools/*.yml`        | [加权目标池](/ultimatequest-zhong-wen-wen-dang/pei-zhi/pools.md)。                        |
| `reward-pools/*.yml` | [可复用加权奖励选项](/ultimatequest-zhong-wen-wen-dang/pei-zhi/rewards.md)。                  |
| `periods/*.yml`      | [周期任务](/ultimatequest-zhong-wen-wen-dang/pei-zhi/periods.md)。                       |
| `scrolls/*.yml`      | [实体卷轴配置](/ultimatequest-zhong-wen-wen-dang/pei-zhi/scrolls.md)。                     |
| `battlepasses/*.yml` | [战令与挑战](/ultimatequest-zhong-wen-wen-dang/pei-zhi/battlepasses.md)。                 |
| `milestones/*.yml`   | [累计里程碑](/ultimatequest-zhong-wen-wen-dang/pei-zhi/milestones.md)。                   |
| `menus/*.yml`        | [菜单定义](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus-1.md)；`settings.yml` 保存公共设置。 |
| `items/`             | [已保存物品](/ultimatequest-zhong-wen-wen-dang/pei-zhi/custom-items.md)。                 |
| `data/`              | 关闭 SQL 时使用的 YAML 数据，见[存储](/ultimatequest-zhong-wen-wen-dang/gong-neng/storage.md)。  |

定义文件夹只扫描直接子级 `.yml` 文件，不递归子目录。ID 使用小写字母、数字、`_` 或 `-`，去掉 `.yml` 的文件名就是定义 ID。`enabled` 默认为 `true`。

不要把完整任务放进 `quests/`，也不要在 `source.quest` 中引用普通任务。`source.quest` 必须引用已启用的目标模板。分类是任务显式配置的元数据，不从目标模板继承。

## `config.yml` 中的重要配置

### `config-files`

```yaml
config-files:
  language: en_US
  per-player-language: true
  force-parse-mini-message: false
```

控制默认语言、按玩家客户端选择语言，以及 MiniMessage 解析。详见[高级语言管理](/ultimatequest-zhong-wen-wen-dang/gong-neng/advanced-language-management.md)。

### `math`

```yaml
math:
  enabled: true
  enable-function: true
```

控制支持的数值字段是否使用表达式和数学函数。详见[数学计算格式](/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/math-calculate-format.md)。

### `hook-item-method`

```yaml
hook-item-method: DEFAULT
```

选择从其他插件获取自定义物品的方式。除非你的配置有特殊要求，否则请保留 `DEFAULT`。

### `auto-save`

```yaml
auto-save:
  enabled: true
  hide-message: false
  period-tick: 6000
  message: '{lang:auto-save.message}'
```

控制玩家进度的自动保存，默认间隔为 6000 tick，在 20 TPS 时约为 5 分钟。玩家退出、领取奖励和插件关闭时也会保存。详见[存储与保存](/ultimatequest-zhong-wen-wen-dang/gong-neng/storage.md)。

### `task-limits`

限制每位玩家同时进行的任务数量。可分别设置普通任务、卷轴、周期任务和战令挑战的上限，并按任务分类进一步限制。`-1` 表示不限，`0` 表示不再分配该类型的新任务。已完成但尚未领奖的任务仍占用名额。详见[任务名额](/ultimatequest-zhong-wen-wen-dang/gong-neng/task-limits.md)。

### `database`

```yaml
database:
  enabled: false
  jdbc-url: jdbc:sqlite:{plugin_folder}/quests.db
  properties:
    user: ''
    password: ''
```

默认使用 YAML 保存玩家数据。设置 `enabled: true` 并填写 JDBC 地址后可以使用数据库。切换前请备份原数据；修改此设置不会自动搬迁已有数据，且需要完整重启服务器。详见[存储与保存](/ultimatequest-zhong-wen-wen-dang/gong-neng/storage.md)。

### `editor`

```yaml
editor:
  enabled: true
```

控制 `/uq editor` 打开的游戏内配置编辑器是否启用。详见[游戏内编辑器](/ultimatequest-zhong-wen-wen-dang/gong-neng/editor.md)。

### 显示和菜单设置

* `objective-display.formats`：目标未单独设置名称时使用的默认显示文本。
* `task-display`：前置任务和管理员任务的提示文本。
* `category-menu`：分类选择菜单共用的标题、布局、图标和按钮。
* `debug`：排查问题时使用的额外信息，平时保持关闭即可。

各菜单布局位于 `menus/`，共用设置位于 `menus/settings.yml`。详见[菜单类型](/ultimatequest-zhong-wen-wen-dang/cai-dan/menus.md)。

## 修改配置的步骤

1. 备份准备修改的文件。
2. 修改对应的任务、目标、奖励或菜单，YAML 缩进请使用空格。
3. 执行 `/uq reload`，查看是否存在配置错误。
4. 重新接取一项新任务，测试目标和奖励。

已经接取的任务会保留原有要求。修改模板不会重置玩家进度，也不会替换这些任务的奖励。