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

# 存储与保存

默认 YAML（database.enabled: false）保存在 data/。SQL 通过 JDBC 支持 SQLite、MySQL/MariaDB、PostgreSQL、H2。更换后端需重启，不会自动迁移旧数据，先备份当前后端。

```yaml
auto-save:
  enabled: true
  hide-message: false
  period-tick: 6000
  message: '{lang:auto-save.message}'
database:
  enabled: false
  jdbc-url: jdbc:sqlite:{plugin_folder}/quests.db
  properties:
    user: ''
    password: ''
```

JDBC 配置会展开 `{plugin_folder}`，database.properties.user/password 提供 SQL 凭据，方言加载器可下载额外驱动。玩家与卷轴为独立记录，备份时一并保留。

自动保存按 tick（20 tick=1秒），默认 6000 tick，首次延迟 180 tick。hide-message 隐藏提示；关闭定时保存仍在退出、关键领奖、停服时保存，重载重新安排定时器。

实例保存解析定义、目标进度、固定奖励和领奖状态，阶段/卷轴令牌保留各自快照。加载中可返回 LOADING，命令需等待玩家数据就绪。未解决领奖应核对实际发放，不应删除记录或盲目重复发奖。