QuestWorldProgression

插件介绍

QuestWorldProgression（QWP）是一个“任务 + 世界进阶”插件：玩家通过任务列表 GUI 完成目标获取世界经验并升级世界等级；支持首次进服发放任务书，右键打开任务界面；并提供 PAPI 变量展示等级与经验。

主要功能

世界等级系统 —— level/xp，支持固定经验模式（每级固定需要多少经验）
任务列表 GUI —— /questwp list 打开任务列表
新手引导书 —— 首次进服发放“探路者指南”
定时保存 —— 默认每 5 分钟异步保存一次玩家数据
PAPI 变量 —— %questwp_level% / %questwp_xp% / %questwp_maxlevel%
存储 —— 可选 MySQL（配置开关）；并带 storage info/convert 命令入口（转换逻辑为示例）

命令列表

主命令：/questwp

命令	说明	权限
`/questwp list`	打开任务列表 GUI	`questwp.use`
`/questwp level`	查看自己的世界等级	`questwp.use`
`/questwp book`	获取任务书	`questwp.use`
`/questwp reload`	重载配置	`questwp.reload`
`/questwp setlevel <玩家> <等级>`	设置玩家等级	`questwp.setlevel`
`/questwp addxp <玩家> <经验>`	增加经验	`questwp.addxp`
`/questwp delexp <玩家> <经验>`	减少经验	`questwp.delexp`
`/questwp storage info`	查看存储信息	`questwp.storage`（实现中有检查）
`/questwp storage convert <file2db\|db2file>`	存储转换入口（示例）	`questwp.storage`

权限节点

权限	说明	默认
`questwp.use`	基础使用	所有人
`questwp.admin`	管理员集合权限	OP
`questwp.reload`	重载	OP
`questwp.setlevel`	设置等级	OP
`questwp.addxp`	加经验	OP
`questwp.delexp`	减经验	OP

PAPI 占位符

插件内置注册的标识符为 questwp：

占位符	说明
`%questwp_level%`	世界等级
`%questwp_xp%`	当前经验
`%questwp_maxlevel%`	最大等级

关键配置

配置文件路径：plugins/QuestWorldProgression/config.yml

YAMLconfig.yml

world-level:
  fixed-exp-mode: true
  fixed-exp-value: 500
  max-level: 1000

newbie:
  give-book-on-first-join: true
  book-name: "§6§l探路者指南"

database:
  enabled: false
  host: localhost
  port: 3306
  database: minecraft
  username: root
  password: ""

gui:
  title: "§6§l任务列表"
  size: 54

常见问题

PlaceholderAPI 是硬依赖（depend）。请先安装后再启动。

当前实现里转换逻辑以示例形式保留了入口，实际转换可按你的数据结构补全实现。