FAQ 与术语表

FAQ

ItemsAdder、Nexo、Oraxen 能完全替代 SealItems 或 ArcartX 吗？

它们可负责自定义物品/资源包的部分能力，但 SealItems 的独立装备状态、品质、词条、鉴定、改造、宝石、共鸣和安全事务是另一层。ArcartX 在这里是可选 GUI 前端。是否替换要按功能逐项比较，不能只看“都能做自定义物品”。

原版 GUI 能完成全部玩法吗？

能完成当前三个工作台的业务流程。连续滚动区域用分页替代；不需要 ArcartX 才能鉴定、改造或镶嵌。

为什么 examples/complete 复制后没生效？

examples/ 整棵目录永不加载。把文件复制到正式 items/、qualities/、affixes/、affix-schemes/ 和 gameplay/... 对应路径，并保持所有 ID 引用完整。

为什么两个看起来一样的卷轴不能支付？

费用按 SealItems 稳定 ID 识别，不按材质或显示名。普通 PAPER、同名伪造物或其他插件物品都不算。

修改品质/词条后，旧装备会自动重抽吗？

不会。生成结果持久化。定义指纹会标记过期，受支持迁移也不会随便重抽玩家资产。

能直接改物品 PDC 吗？

不建议，也不受支持。UUID、revision、codec、指纹和玩法摘要互相关联，手改容易进入 PROTECTED 或破坏事务安全。

数据保存在哪里？为什么 mysql: {}？

当前物品实例状态主要在 ItemStack PDC；runtime/mysql/redis/integrations 是保留空区块，加入字段会被拒绝，不是可用数据库配置。

为什么默认不开鉴定、改造、掉落、宝石？

避免安装即改变现有玩法或消耗玩家资产。服主应显式配置、测试、备份后启用。

reload all 能代替重启吗？

配置日常更新可重载；JAR、依赖、ArcartX 模板协议或外部插件升级应正常停服重启。重载失败还会保留旧快照，必须核对 health。

Folia 能用吗？

不能声称支持。当前 JAR 明确 folia-supported: false。

第三方插件怎么发放物品或打开宝石界面？

当前公开 API 只支持打开鉴定界面。其他内部能力没有兼容承诺，不要反射。需要时提出新公共 API 用例。

术语表

术语	含义
稳定 ID	配置与跨系统引用使用的长期身份，如 example_blade
individual	每件独立 UUID/revision，可保存品质词条孔位
stackable	可堆叠材料，无逐件玩法状态
品质 quality	装备等级展示与槽位规则
词条 affix	随机抽取的属性效果
主/副槽	primary/secondary 两类词条位置
scheme	物品所用词条池、等级和默认槽位方案
tier	词条档位，受 affix level 解锁
profile	孔位潜力、context、孔型权重和操作白名单
context	宝石场景效果选择键，如 weapon
resonance	按生效宝石计分并在阈值提供属性
snapshot	已编译、不可变且可原子替换的配置事实
fingerprint	定义/规则内容摘要，用于识别过期与冲突
revision	单个装备每次安全写入递增的版本
PDC	Bukkit PersistentDataContainer，物品持久化容器
READY	物品/运行态可安全使用
PROTECTED	数据不满足安全条件，拒绝猜测修改
CAS	compare-and-set；提交前确认事实仍与预览一致
provider	GUI 或经济等可替换实现提供者
softdepend	可选运行依赖，缺少时核心仍可按边界工作
MiniMessage	<aqua> 等现代文本格式

仍未解决的问题请按 故障排查 的报告模板提供完整证据。