[UNOFFICIAL] TaCZ Refabricated 26.2 R1 更新公告

更新范围： BETA-3 至 R1
适用版本： Minecraft 26.2 / Fabric
模组版本： 1.1.8+fabric.26.2.R1

R1 不只是一次版本改名。本次集中收口了第一人称枪械渲染、瞄具裁剪、外部动画 Mod 兼容、LRTactical 反馈层，以及多项长期遗漏的上游内容与兼容入口。

✨ 第一人称枪械与 ADS 修复

• 修正了曳光弹渲染错位的问题
• 修正了 ADS、开火和换弹时，枪和手臂会随着玩家朝向产生异常旋转的问题。
• 修正了东南、西北、东北、西南等斜向视角下尤为明显的横向漂移。
• 修正了某些方向下枪械反向移动、向上或向下看时姿态异常，以及后坐力过度下压的问题。
• 重新整理第一人称 viewmodel 的接管位置，避免 vanilla 装备进度、挥动动画和第三方手部变换再次叠加到 TACZ 动画上。
• 恢复主手 TACZ viewmodel 自带双手时的副手让出逻辑，减少重复手臂和副手穿模。

🔭 瞄具与光影渲染

• 修正部分中高倍镜的物理目镜内环被镜内裁剪“啃掉”的问题。
• 低倍镜、红点以及组合瞄具的低倍部分不再错误裁切自身内框。
• 改进镜内枪身、非瞄具配件与枪口火焰的遮罩处理。
• 发光准星改用独立自发光路径，减少随玩家朝向忽明忽暗的问题。
• 恢复 Iris shadow-pass 检测初始化，避免相关判断长期固定为错误状态。
• 普通渲染与 Iris 路径继续分别采用安全的 26.2 实现，不重新启用高风险的第二次世界渲染。

🖐️ 第一人称身体与手部动画 Mod 兼容

新增按物品自动交还渲染权的兼容层：

• First-person Model
• Not Enough Animations
• Punchy!
• Hide Hands
• SkyHands
• Viewmodel Changer
• Swing Animation Plus / Swing Speed 等 vanilla swing 修改类 Mod

现在的行为是：

• 普通物品继续使用外部 Mod 的身体、手部、位置和挥动动画；
• 持有拥有实际 TACZ/LRTactical 动画模型的枪、刀或投掷物时，自动交还给 TACZ viewmodel；
• 放下这些物品后，外部第一人称动画自动恢复；
• 不会永久修改其他 Mod 的用户配置；
• 未安装上述可选 Mod 时，不影响 TACZ 基础渲染。

这是一套“持有 TACZ 动画物品时让出”的兼容机制，而不是把两套手臂骨骼强行叠加。

🎒 LRTactical 反馈层补齐

物品 Tooltip

为以下物品补充数据提示：

• 投掷物
• 近战武器
• 消耗品

支持：

• 自动换行；
• 默认折叠长描述与效果列表；
• 按住 Shift 展开；
• 冷却、预燃、持续时间；
• 爆炸伤害、半径和特殊属性；
• 闪光范围与持续时间；
• 效果云范围、点燃和药水效果；
• 近战左右键伤害倍率与冷却；
• 治疗、饥饿、药水效果、使用次数和使用时间。

使用进度 HUD

新增：

• 白色准备/使用进度条；
• 红色手雷预燃和引信进度条；
• 绿色 toggle consumable 进度条；
• toggle 取消提示；
• 近战冷却恢复条；
• 潜行慢投几何箭头提示。

自定义分类冷却

• 新增自定义 Identifier 冷却的服务端到客户端同步。
• 冷却开始和结束都会同步到所属玩家。
• 物品栏图标会显示对应的冷却遮罩。
• 客户端只负责显示，实际能否再次使用仍由服务端判定。
• 不同手雷和消耗品不会再因为共用基础 Item 而错误共享全部冷却显示。

🔧 上游遗漏与兼容修复

• 恢复弹药盒染色：
  • 补回兼容用 dyeable 标签；
  • 增加 Minecraft 26.2 实际使用的 minecraft:crafting_dye 配方；
  • 保留弹药盒原有组件、弹药 ID、等级和数量。
• 恢复 Blood Strike 专属画作：
  • 保留专属名称；
  • 正确写入 tacz:blood_strike_1 画作变体；
  • 同时兼容现代 id + components 与旧枪包 item + nbt 结果格式。
• 修复末影龙 multipart 命中归属：
  • 伤害仍作用于命中的龙部件；
  • 击杀事件、击退和无敌帧等归属正确回到龙本体。
• 恢复 Shoulder Surfing Reloaded 5.x 支持：
  • TACZ 枪械可作为自适应瞄准物品；
  • 肩扛视角下正确处理 TACZ 准星；
  • free-look 时不强制显示。
• 删除会覆盖真实 MAE API 的本地空壳，改为使用并打包真实 MAE 1.1.1。
• 清理并修正大量已经过时或错误的 TODO、兼容注释和阶段说明。

🎞️ Player Animation Library

• 修正 PAL 动画停止链可能残留无效 fade modifier、导致一次切枪后第三人称持枪动画整局失效的问题。
• 切枪、收枪和重新装备后，第三人称持枪动画可以重新启动。
• PAL 继续只负责第三人称动画，不参与 TACZ 第一人称枪械和手部 viewmodel。

✨ 其他视觉改善

• 恢复曳光弹 energySwirl 渲染类型和正确亮度。
• 第一人称枪口视觉偏移改为按每发子弹缓存。
• 修正部分枪械模型、配件和手部提交顺序。
• 更新中英文 LRTactical 提示文本。

🔎 审计结论

本轮还完成了上游功能与 TODO 真伪审计：

• 枪械经验等级不是本移植漏做，而是上游尚未完成的脚手。
• 当前没有完整的经验获取、等级曲线、等级上限或属性加成系统。
• glTF CUBICSPLINE 和普通非爆头暴击标记同样属于上游未完成内容。
• 剩余 Controllable、Accelerated Rendering 和 KubeJS 接口问题主要受外部 26.2 API/构建限制。

因此本次没有擅自添加一套与上游不同的枪械等级玩法。

⚠️ 已知问题

Player Animation Library

在第三人称下经历：

趴姿 → 站立 → 切换枪械