可选插件集成

Vault

Vault 是经济服务桥，本身不一定提供余额；还需要一个通过 Vault 注册 Economy provider 的经济插件。

配置例子：

currency: { type: vault, amount-per-affix: '100.00' }

或宝石操作：

currency: { type: vault, amount: '100.00' }

金额必须是带引号十进制字符串。SealItems 会检查 provider 身份、名称、小数位、操作前后余额和扣款结果。provider 在打开 GUI 与提交之间变化时会拒绝。

PlayerPoints

currency: { type: playerpoints, amount-per-affix: '10' }

点数应为可精确表示的整数。SealItems 依据实际 API 扣除前后余额与返回值分类结果。

外部经济的 UNKNOWN 状态

网络、插件异常或返回事实不一致时，SealItems 不能确定钱是否扣掉。为了防止重复点击二次扣款，会保留现场并冻结对应 provider。处理步骤：

1. 禁止玩家继续尝试该玩法。
2. 保存控制台审计、玩家 UUID、物品实例和时间。
3. 查经济插件流水确认真实扣款。
4. 修复 provider。
5. 执行成功的相关规则重载，让 provider 重新绑定。
6. /si health 确认 frozen 消失，再人工处理补偿。

不要直接重启并假定“肯定没扣”。

MythicMobs

安装后 SealItems 注册自定义掉落桥，用 MythicMobs 的 Drops 控制触发概率/数量，用 SealItems 稳定 ID构建物品。当前自定义掉落只支持 ground，不承诺 killer 直送。若 MythicMobs 缺失，原版掉落和核心物品仍可使用。

ArcartX

ArcartX 只提供前端。费用、概率、候选、随机和事务由 SealItems 服务端控制。模板安装与 provider 见 GUI 与 ArcartX。移除 ArcartX 后，auto 应回退原版；显式 arcartx 会拒绝。

缺少软依赖时的预期

缺少	预期
SealAttributes	核心定义可诊断，但装备属性联动不 writable，完整装备玩法不应视为 READY
Vault/Economy	仅使用 Vault 费用的规则不可用/拒绝发布或提交
PlayerPoints	仅使用 PlayerPoints 的规则不可用
MythicMobs	Mythic 自定义掉落不可用，原版掉落不受影响
ArcartX	auto/vanilla 可用原版 GUI；强制 arcartx 拒绝

所有集成版本升级都先在测试服重新跑安装、打开 GUI、费用不足、成功扣费、失败/冲突和重启恢复用例。