SkillSystem（技能系统）

适用于 Paper/Luminol/Folia 1.21.11、Java 21 的七技能插件。

安装

将 SkillSystem-1.3.1.jar 放入服务器 plugins/，可选安装 Vault、任意 Vault Economy、PlayerPoints 和 LuckPerms。LuckPerms 仅用于权限管理，不是硬前置。

首次启动后配置位于 plugins/SkillSystem/config.yml，默认 SQLite 数据库位于 plugins/SkillSystem/data/skills.db，购买日志位于 plugins/SkillSystem/logs/。

玩家使用

1. 输入 /skills 打开 27 格技能 GUI。
2. 点击技能购买并自动绑定；有效期默认 30 天，再次点击已解锁技能只切换绑定，不重复扣款。
3. 双手都为空手时按 F 触发当前技能。任意一只手有物品时，插件保留原版换手，不会卡住副手使用。

所有玩家默认拥有 skills.use。技能顺序为：冲刺、回血、震慑、隐身、杀戮、疾跑、自爆。冲刺、隐身、自爆为高级技能，默认 200 点券；其余为普通技能，默认 100000 金币。

创造模式同样可以使用全部技能。默认冷却为冲刺 10 秒、其他技能 120 秒；冷却中按 F 会在动作栏显示剩余秒数，冷却结束会显示“技能已就绪”。自爆使用无方块破坏效果，并排除技能主人自身伤害。

管理命令

/skills help
/skills reload
/skills query <玩家名或UUID>

reload 会热加载配置并建立当前数据库连接；切换 SQLite/MySQL 时只初始化新库表结构，不迁移旧数据。reload 和 query 需要 skills.admin（默认仅管理员）。

GUI 自定义

编辑 plugins/SkillSystem/gui.yml 后执行 /skills reload，可以实时修改 GUI 标题、箱子大小、技能槽位、说明位置、分隔板、技能图标材质、名称和 Lore。skill-slots 按“冲刺、回血、震慑、隐身、杀戮、疾跑、自爆”的顺序填写 7 个槽位，例如 skill-slots: [0, 4, 8, 12, 14, 20, 26]。

技能图标支持 MiniMessage、§ 和 & 颜色码。自定义 Lore 可使用 {skill}、{effect}、{price}、{currency}、{cooldown}、{unlock-days}、{balance}、{expires-at}、{status}、{bound}、{unlocked} 占位符；不填写技能 Lore 时会继续使用内置的新手说明。GUI 配置热加载不会清除购买、绑定或到期数据。

构建

gradlew.bat clean test build --warning-mode all

本项目未启动真实 Paper/Folia 测试服；静态检查、单元测试和 Gradle 构建成功不等于真实服务端运行测试。