🏷️ PAPI 与物品过滤

PlaceholderAPI

变量	用途
%invsync_survival%	获取名为 survival 的子服在线人数，将名字替换为代理实际子服名
%invsync_totalOnline%	获取代理消息通道返回的总在线人数，保持大小写

需要 PlaceholderAPI 和兼容 BungeeCord 插件消息的代理环境。在线数有缓存并依赖当前子服玩家发送消息，空服、通道关闭或缓存过期可能显示 0/滞后。Velocity 环境需要其兼容消息通道正确设置，不能凭预加载已接入就认定人数消息也可用。

这些变量不是跨代理集群准确的会话统计，也不能作为编辑安全的唯一依据。

保存时排除物品

# 名字忽略颜色后完全匹配，默认模板只是占位示例。
skip-items:
  - '不同步物品名1'
# lore 匹配保留颜色，按现有格式测试，默认模板只是占位示例。
skip-items-lore:
  - '不同步的lore'

过滤不是禁带暂存

命中的物品不进入该次同步快照，跨服恢复时对应物品可能消失。不自动存入仓库，也不保证返回源服恢复。上线前用测试物品验证；重要装备优先通过玩法插件明确限制转服，不用过滤充当安全保管。

开发者可监听 InvSyncSkipItemEvent 调整 isSkip，不是调用事件取消。

解析失败策略

策略	行为	风险
deny（默认）	抛错，阻止正常加载	需查明坏数据、缺失附魔/插件或版本问题，不能靠反复登录解决
remove	移除不认识的附魔后转换	会改变物品；不能处理全部组件问题，也不保证嵌套容器全部净化
skip	跳过异常物品，槽位为空	后续保存可能永久覆盖原物品，先备份再决定

改策略前保留数据库原始记录、玩家档案和错误日志。当前没有通用坏物品隔离仓库，不对解析失败自动恢复作保证。