🛡️ XPVault 插件 – 全面技术指南
什么是 XPVault？
XPVault 是一个针对 Minecraft 的高级插件，允许玩家安全地管理他们的经验值（XP）。
它引入了一个个人 XP 宝系统，玩家可以在其中存储、检索和转移 XP，同时也为服务器管理员提供了通过管理命令完全控制 XP 分发的权限。XPVault 通过提供可靠性和自定义性来增强多人游戏体验。
---
✅ 主要功能
安全的 XP 宝系统用于存储 XP。
随时恢复保存的 XP — 尤其是在死亡后。
在玩家之间发送和接收 XP。
对 XP 余额进行完全的管理员控制。
通过 messages.yml 进行完全的消息自定义。
内置的 PlaceholderAPI 集成支持。
---
🧭 可用命令
/savexp
功能：将 XP 保存到您的个人宝库。
别名：/sxp
权限：所有玩家开放
示例：/savexp 100
---
/givexp
功能：向另一位玩家赠送 XP。
别名：/gxp
权限：所有玩家开放
示例：/givexp Steve 500
---
/retrievexp [amount]
功能：从您的宝库中检索 XP。
别名：/rxp
权限：所有玩家开放
示例：/retrievexp 或 /retrievexp 200
---
/adminxp [player] [amount]
功能：管理 XP 控制 (重置、设定、增加、移除)。
权限：需要 xpvault.admin
示例：/adminxp set Player1 1000
---
/checkxp
功能：显示当前和存储的 XP 以及等级。
别名：/cxp
权限：所有玩家开放
---
🔗 PlaceholderAPI 集成
可用占位符：
%xpvault_saved_xp%: 显示玩家保管箱中保存的 XP 数量。
示例用法 (积分板):
lines:
- "&a存储的 XP: &f%xpvault_saved_xp%"
---
💬 消息自定义
支持的占位符：
占位符 描述
%player% 目标玩家名称
%amount% XP 数量
%current_xp% 玩家的当前 XP
%saved_xp% 玩家的存储 XP
%sender% 发送 XP 的玩家
%action% 采取的动作 (设置、增加、移除)
%new_xp% 动作后的新的 XP 值
示例消息 (messages.yml):
plugin_enabled: "&aXPVault 已启用!"
xp_saved: "&a您的 XP 已保存!"
xp_given: "&a已成功向 %player% 赠送 %amount% XP!"
xp_retrieved: "&a您从保管箱中检索了 %amount% XP。"
adminxp_player_success: "&a为 %player% %action% %amount% XP。新的存储 XP: %new_xp%"