更新日志

[0.5.0] - 2026-08-07

修复

• 修复专用服务器中客户端未收到服务端口径与弹药属性配置，导致已配置弹药仍显示“未配置口径”的问题。
• 修复玩家登录或服务端执行 /reload 后，客户端可能继续使用本地旧数据的问题；弹药档、口径定义、枪械修正和独立枪口径覆盖现在均以服务端数据为准。
• 修复 Arcana 1.1.4 在 Mojmap 开发环境中多个同名 Mixin Invoker 发生递归，导致客户端进入世界前栈溢出的问题。
• 修复 Arcana 弹药类型图标位于较高 GUI 深度、仍会穿透口径标签显示的问题。

改进

• Arcana 右下角弹药类型显示现在会替换为当前生效枪械支持的完整口径列表，而非仅显示当前逻辑弹药对应的单个口径。
• 多口径标签改为纵向排列，并统一右对齐到原弹药图标位置。
• 客户端应用服务端同步数据后会重新派生 TacZ 原生弹药的低属性档，确保提示信息与实际服务端伤害逻辑一致。

网络与兼容性

• 新增服务端到客户端的口径数据快照，在玩家登录及数据包重载后自动同步。
• 网络协议版本升级至 2；服务器与客户端必须同时使用 0.5.0，旧版本客户端不会静默使用错误数据。
• Arcana 仍为可选依赖；未安装时基础 TacZ 口径、装填和发射逻辑保持不变。

验证

• Forge 1.20.1 实际登录流程成功同步 244 个弹药档、38 个口径定义和 4 个枪械口径覆盖，无数据包解码或网络异常。
• Forge 1.20.1 携带 Arcana 进入世界、HUD 多口径显示及正常退出验证通过。
• Forge 1.20.1 与 NeoForge 1.21.1 完整构建通过，发布 JAR 均包含新增同步实现。

[0.4.0] - 2026-08-05

新增

• 新增能力化兼容框架，将枪械模式解析、弹药准入策略和发射数量覆盖拆分为可独立注册的能力。
• 新增基础 TacZ 回退模块；未安装可选模组时继续使用原有的口径匹配、装填和发射逻辑。
• 新增 TacZ Arcana 兼容模块，已针对 Arcana 1.1.4 验证：
  • 识别当前生效的主枪或下挂模式。
  • 为主枪和下挂武器分别保存弹仓序列及膛内弹药状态。
  • Arcana 切换逻辑弹药后，可装填同口径的 TacZ Caliber Ammo 弹种；未登记口径的逻辑弹药仍仅接受自身。
  • 保留 Arcana 对动态弹丸数量的覆盖，避免被基础散弹丸数逻辑再次改写。
• 新增按稳定 ModeKey 分区的弹药状态存储，数据统一保存在 tacz_caliber_ammo:AmmoStates 下。
• 新增平台侧模组存在性与版本查询，为后续接入更多可选模组提供统一入口。

改进

• 装填、卸弹、弹药箱匹配、弹药袋补弹、HUD 和发射流程统一通过兼容层解析当前枪械模式。
• 兼容能力按优先级和模块 ID 确定性排序；单个能力发生错误时仅禁用对应提供者，并继续尝试低优先级回退。
• 可选兼容模块通过类名延迟加载，避免未安装目标模组时提前解析其类。
• 调整发射阶段的 Mixin 注入方式，规避与 Arcana 等模组竞争同一 @Redirect 目标。
• 旧版根级 LoadedSeq 和 BarrelAmmo 数据会在主模式首次写入时自动迁移，无需手动处理已有枪械。

开发支持

• Forge 1.20.1 的 runClient 和 runServer 新增可选参数 -PwithArcana=true，用于附带 Arcana 及其运行库进行本地兼容测试。
• 完成 Arcana hybrid 发布包的开发环境处理，包括内层模组重映射、Transformation Service bootstrap、Kotlin for Forge 和私有 Jar-in-Jar 依赖。
• 修复 Mojmap 开发环境中 Arcana KeyMapping accessor 递归导致的客户端栈溢出。
• 为生成的 Arcana 运行库容器补充有效的 pack.mcmeta，消除无效 ResourcePackInfo 提示。
• withArcana 默认关闭，且不会改变普通构建、数据生成或 NeoForge 开发运行的依赖集合。

文档

• 新增兼容 API 文档，说明模块布局、能力契约、优先级、故障隔离、模式状态和可选依赖约束。
• README 新增 Arcana 可选客户端与服务端开发运行命令。

兼容性

• Arcana 不是必需依赖；未安装时兼容模块不会加载，基础 TacZ 行为保持可用。
• Arcana 1.1.4 为已验证版本。其他版本允许以降级模式加载，并会在日志中提示未经验证。
• 新的模式化 NBT 结构兼容旧版装弹数据，但升级后的独立下挂状态无法被旧版本识别。

验证

• Forge 1.20.1 客户端携带 Arcana 启动、资源重载及正常退出通过。
• Forge 1.20.1 服务端携带 Arcana 启动至 Done 通过。
• Forge 1.20.1 与 NeoForge 1.21.1 常规构建通过。