ItemLoom 2.10.1

ItemLoom 2.10.1

• Register the CraftEngine item source under lowercase itemloom, matching CraftEngine's configuration lookup. Mixed-case source: ItemLoom configurations now resolve through the actual external-source processor.
• Recover display rendering on the same connection after a 250 ms timeout: drain original packets in order, wait one second and a main-thread acknowledgement, then resync inventory. Cancelled render work is never replayed; explicit shutdown cancels recovery and inbound proof checks remain active.
• Extend the Paper packet probe with timeout recovery and explicit-stop checks, and exercise CraftEngine's configured external-source processor rather than only the direct registry API.

---

• 附件：ItemLoom-2.10.1.jar 与 SHA256SUMS.txt。
• SHA-256：b479a63a267d1c379a2e6301b7bcb951a4252c94fb67a4154e209ea44c555479
• 历史 Release 保留，不用新附件覆盖旧版本。

ItemLoom 2.10.0

ItemLoom 2.10.0

• Host Soulbind binding, ownership protection, container/pickup protection and wrong-owner returns in ItemLoom.
• Preserve legacy Soulbind/Malkuth configuration, language files and orakasoulbind:owner / owner_name PDC data; return journals use stable Malkuth mailbox delivery IDs.
• Keep LootBeam/Ambience integration from 2.9.0 unchanged.

更新日志

---

• 附件：ItemLoom-2.10.0.jar 与 SHA256SUMS.txt。
• SHA-256：0467826a3d4169f1fe84289635e81d65ed45e2c20c26e01f949d68a8a21c5dc0
• 历史 Release 保留，不用新附件覆盖旧版本。

ItemLoom 2.9.0

ItemLoom 2.9.0

LootBeam has been merged into ItemLoom while preserving the legacy commands (/lootbeam, /beam, /lb), permissions, preference API, SQLite data path and PDC contract. CraftEngine beam rendering is now owned by ItemLoom, with safe operation when CraftEngine is absent.

• 31 Gradle tasks completed successfully; ItemLoom source review: 0 problems.
• Artifact audit passed with no forbidden deployment content or local paths.
• No-CraftEngine and CraftEngine 26.9.1 Paper probes passed, including old preferences, entity/PDC behavior, reload rollback and cleanup.

This release contains only the verified JAR and SHA256SUMS.txt.

ItemLoom 2.8.0

ItemLoom 2.8.0

• 并入通用装备对比：数值差、已装备标记、Division 式品相条差段；部位、属性映射、输出文本、字体/图片 ID 与扫描间隔独立配置。不包含服务器配置、素材或专用迁移工具。
• 原生 %itemloom_*% 占位符继续兼容 %gearcompare_*%；读取原生 itemloom:slot|uid|stats 并回退 GearCompare PDC。属性文本同时支持旧 key=value;... 与规范键 JSON，部位可含下划线。
• 公开 EquipmentProvider 与 ComparisonStatProvider：当前装备、有效性、属性值及原始基础来源由调用方提供；owner 停用或关闭句柄时清理。完整候选将同类固定/百分比词条按查看者基础值合成总贡献；缺完整上下文保留原单条比较。
• 生成结束后立即发布最终候选，首次读取不再等待下一 tick；不重复 roll 或事件。候选缓存有界，异步请求只读不可变快照；创造模式不强制整包库存重发，避免覆盖客户端光标。
• 通过 CraftEngine 26.9.1 公开 registerItemSource 注册原生 ItemLoom 来源，支持 build、id 与缺失 ID；可选依赖隔离，无 CraftEngine 也可启动。
• 保留 2.7.0 的公开重建接口与现有状态保留规则，清理相关未使用 import，维护来源审查与配置/接口文档。
• 验证：372 项单元测试，369 项通过、3 项缺外部参考输入而跳过，无失败。隔离 Paper 26.2 build 123 沙箱通过 24 项比较断言（含实际 PAPI 与 CE API），实际 NI 配置副本加载/生成 653 件，无生成失败。配置副本的两处未展开 tooltip_style 与一处未知 test 节点仍有诊断；坏配置探针故意产生的错误已原字节恢复。
• 未验证：真实客户端 Tooltip、字形素材、CE 配方组合与多人负载。生成事件尚未完成时提前自行发包、未登记且不在库存/GUI 的外部候选仍可能只显示单条比较。GitHub 发布与生产部署由统一收尾执行。

---

• 附件：ItemLoom-2.8.0.jar 与 SHA256SUMS.txt。
• SHA-256：e2efbe28b4a654ff9232af88ca26716c729a2acf506920d698929623ec3b376a
• 历史 Release 保留，不用新附件覆盖旧版本。

ItemLoom 2.7.0

ItemLoom 2.7.0

• 新增公开接口 ItemLoom.rebuild(item, viewer, overrides, keepPdcKeys)，按覆盖的节点值重建已有物品，返回 ItemRebuildResult（成功时为新物品，失败时给出状态与原因）。原物品在成功和失败时都不被修改；配置错误、非 ItemLoom 物品、未知物品 ID 与生成失败都以结果返回，不抛出异常。接口须在服务器主线程调用。
• 重建保留数量、NI 自定义耐久与充能（按新定义的上限钳制，新定义无上限时丢弃）、原版耐久伤害、附魔与存储附魔集合，以及配置的 options.update.protect / protect-components 列表（不受 update 开关限制）。调用方可通过 keepPdcKeys 指定要保留的 PDC 键，ItemLoom.KEEP_ALL_PDC 保留整个 PDC。
• 重建仍通过物品定义生成，ItemGenerateEvent 照常触发，监听器可在保留规则之前修改 Lore 等内容；保留的状态随后恢复。identify 沿用原有实现，返回物品的 ID 与当前节点值。
• SX 物品使用同一接口；SX 的 ProtectNBT 按更新路径的规则恢复。外部提供者物品不支持重建，返回 UNSUPPORTED_FORMAT。
• 来源清单更新为 2.7.0 对应的 264 个生产输入，新增接口与规则文件均已逐文件记录。开始本版时工程工作树没有未提交改动，因此没有需要保留的遗留改动。
• 测试：核心模块新增 6 项、运行模块新增 12 项纯规则测试，全部通过；完整构建的单元测试为 364 项（361 项通过，3 项因未提供外部参考 JAR 或真实配置输入而跳过，无失败）。
• 运行验证：在隔离 Paper 26.2 build 123 沙箱中，使用 NI 配置副本加载 653 个物品，并通过合成控制台探针完成 25 项检查：覆盖等级后仅该行 Lore 变化、数量、耐久、附魔、指定 PDC 与未指定 PDC、事件触发、非 ItemLoom 与未知 ID 的失败及原物品不变。日志无 ERROR 或异常。
• 未覆盖：真实客户端显示、多人负载；SX 物品与外部提供者物品的重建路径；原版耐久伤害（无自定义耐久的物品）的保留路径；任意第三方插件在重建期间修改物品的行为。这些路径已在代码中实现，但本版未单独运行验证。

---

• 附件：ItemLoom-2.7.0.jar（本次构建并验证的产物）与 SHA256SUMS.txt。
• SHA-256：4dc637d0171a4bbe74b9a2b8d8ce99134576e3418b4acbfc5c55944a257face1
• 历史 Release 保留，不用新附件覆盖旧版本。

ItemLoom 2.6.1

• 重写中英文 README，以插件用途、主要功能、安装示例、管理命令、已有配置和插件联动组织入门内容；两种语言保留独立介绍与互相链接。
• 将重构历史和实现细节留在对应文档中，补齐使用、构建、架构、更新日志和来源记录的入口；核对命令参数、配置路径、依赖和兼容范围。
• 修正使用说明的过时适用版本，区分当前文档版本与 2.6.0 的运行验证记录。插件功能、公开 API、配置与物品数据契约保持不变。
• 完整构建通过，343 项测试通过，3 项因未提供外部参考 JAR 或真实配置输入而跳过，无失败；未变化输入使用 Gradle 缓存。33 个本地文档链接、261 个生产输入及成品审查通过；与 2.6.0 相比，成品仅版本描述变化，全部 2,107 个 class 字节一致。本轮未启动验证服务器。

附件仅包含插件 JAR 与 SHA256SUMS.txt。

ItemLoom 2.6.0

ItemLoom 2.6.0 全面重构自有业务实现，保持 2.5.0 公开 API、已有物品数据和已支持功能。NI／SX 原配置继续直接读取，无需转换配置文件。

• 重构配置、生成、脚本、动作、NBT、保存、维护、掉落、显示和插件联动；拆清运行服务职责，清理被替换的实现和过时说明。
• 外观缓存继续逐次计算节点、随机值、有效期和外部物品；隔离可变组件，保留数据提交、失效回调和余量交付边界。
• 完成 261 个生产、资源、构建和法律输入的逐文件来源记录。保留 GPL-3.0、准确署名、必要公开适配器和已署名依赖；强化实际成品许可证及损坏产物拒绝检查。工程重构不构成法律 clean-room 或零风险认证。
• 346 项单元／参考测试通过，无失败或跳过；同一 JAR 通过 38 组常规运行检查、8 组 NI 参考对照、7 组实际 CraftEngine／MythicMobs／PAPI／Vault 联动。与 2.5.0 的 1,739 项运行观察一致；公开 API 和脚本兼容声明保持兼容，72 个调用方链接检查无问题。

运行验证使用隔离 Paper 26.2 build 123 与合成玩家／事件，未做真实客户端或多人负载测试，本轮未部署服务器。完整累计记录见 CHANGELOG，支持范围见 USAGE。

需要 Java 25 和匹配的 Paper 26.2 环境。附件仅为 ItemLoom-2.6.0.jar 与 SHA256SUMS.txt；探针和验证记录不随插件分发。

JAR SHA-256：2de203f1f6f10d9f64acc3963621dd300a6ae96ffa6100275558f13158020f91

ItemLoom 2.5.0

ItemLoom 2.5.0 替换了来源复查中识别的早期 NI 适配方法和 NI/SX 前端实现，保留已支持的配置文本及脚本行为。

• 替换状态保留、耐久换算及 NBT/物品比较的五个遗留方法体。
• 重写动作上下文与语法、字符串/正则节点，以及 SX 标量、锁定值和物品字段生成。
• 保留 ItemBridge 完整物品底稿，未覆盖的组件、PDC 和标记继续保留。
• 清理旧实现，修正逐文件来源记录；保留 GPL、历史来源署名及已有版本，不宣称法律 clean-room 或零版权风险。

验证：331 项单元/参考测试无失败或跳过；同一探针对照 2.4.0 与新版的 1,739 个结果全部一致；另有 13 组、1,007 项运行检查通过。API 检查在所扫描调用方范围内为 0 个问题，成品内容和许可检查通过。

运行要求：Paper 26.2（构建与验证基线为 build 123），Java 25。配置兼容范围见 README/USAGE；任意旧扩展、真实客户端与全部第三方组合仍需分别验证。本轮未执行性能压测或部署现有服务器。

附件仅含 ItemLoom-2.5.0.jar 与 SHA256SUMS.txt，不包含探针、服务器素材或私有配置。GitHub 自动提供本标签的源码归档。

ItemLoom 2.4.0

本版补齐 Sparrow 内嵌 SnakeYAML 分支的对应源码与署名，不更换 YAML 解析实现或改变物品配置行为。

• 定位并固定 Catnies/snakeyaml-engine 提交 30e9499fcd6e1569b81518db13e12d900c5da2eb 及源码归档 SHA-256，解决此前精确分支源码未定位的缺口。
• 从 136 份主源码重建：223 个运行时类全部通过原始二进制、源码编译结果和插件重定位产物比对；210 个重建类字节相同，其余 13 个在移除指定调试信息后相同。保留反射可见的方法参数，不宣称整个 JAR 字节复现。
• 补齐 SnakeYAML、Google GData、Catnies 署名，加入可复现检查工具。拒绝源码哈希变化、缺类、重复类、多版本覆盖、参数或指令变化，以及缺失许可证。
• 保留 GPL-3.0、NI/SX 历史来源、配置兼容入口和所有历史 Releases。来源可追溯与工程验证不构成零版权风险或法律 clean-room 认证。

验证：最终成品的全部 2,067 个类与 2.3.0 逐字节一致；275 项单元/参考测试无失败或跳过，未变化输入使用 Gradle 缓存；8 组故障样本被拒绝；229 项来源清单检查通过；扫描范围内 API 问题为 0，打包后的脚本引擎检查通过。本轮未重启验证服务器、部署、执行真实客户端或负载测试，历史性能数据不作为本版重测结果。

运行环境：Paper 26.2、Java 25。附件仅插件 JAR 与 SHA256SUMS.txt，不包含服务器素材、私人配置或验证归档。

对应源码及复核步骤见 分支来源记录，完整历史见 CHANGELOG。

ItemLoom 2.3.0

SX 旧数字/旧名称材质不再在首次生成时触发 Paper CraftLegacy/DFU 初始化。转换使用从 Paper 26.2 build 123 API 观察生成的只读映射表，保留现代名称优先、数据值和耐久后缀语义。

• 同条件各三次新 JVM：首次转换从 10.47–11.27 秒降为最终 JAR 的 5.48–6.74 毫秒；热态旧材质混合调用中位数从约 2.50 微秒降为 0.53 微秒。单线程反射微基准，不能换算整服 TPS。
• 全量对照 118,528 种旧材质数据组合，连同名称和语法边界共 119,009 条断言通过；275 项单元/参考测试及 9 组/779 项配置与联动断言通过，API 检查 0 个问题。
• 补齐 Nashorn、ASM、Sparrow 和内嵌组件的完整许可证；来源检查扩展到资源、构建及发布输入，锁定依赖二进制并核验产物中的许可证与材质表。
• 保留 GPL、上游署名和历史。本轮未发现新的实质 NI/SX 复制证据；Sparrow 内嵌 SnakeYAML fork 的对应修改源码仍未定位，不宣称零版权风险或法律 clean-room。

要求 Paper 26.2、Java 25。配置加载不会改写来源文件。未做真实客户端或多人压力测试，未部署到现有服务器。仅提供插件 JAR 与 SHA256SUMS.txt，不附带任何服务器资产。

SHA-256: 8b35c58e119c508fa22b210d4469af77a70ad5678771c2b730c1a5f7644f3fd9