Epic Fight × TacZ First-Person Compat

Epic Fight × TacZ 兼容

一个仅客户端兼容补丁，在同时安装 Epic Fight 与 TacZ 时，恢复 TacZ 的枪械动画——包括第一人称（换弹、检视、拔枪）和第三人称（持枪姿势、身体倾斜、腿部站姿）。

本仓库维护两个并行构建：

• 1.21.1 / NeoForge — main 分支。
• 1.20.1 / Forge — 1201 分支（向后移植）。

两个构建实现相同的修复（公共 API 战斗模式抑制

• 在 HumanoidModel.setupAnim 上的单个 TAIL 注入）；仅加载器和依赖版本不同。

TacZ、Epic Fight 和 PlayerAnimator 均为必需。缺少它们模组将拒绝加载——它本身没有独立用途。

简介（CurseForge）

在安装 Epic Fight 时恢复 TacZ 的第一人称和第三人称枪械动画。仅客户端。分别为 1.21.1/NeoForge 和 1.20.1/Forge 提供独立构建。

问题

当 TacZ 和 Epic Fight 同时加载时，会出现两个回退问题：

• 第一人称：Epic Fight 的战斗模式渲染器会在 TacZ 运行其 ItemInHandRenderer 链之前接管玩家手臂。持枪时，换弹、检视和拔枪动画会悄然消失。
• 第三人称：即使强制 Epic Fight 进入原版模式，Epic Fight 的 HumanoidModel.setupAnim TAIL 注入仍会在 TacZ 的之后运行，抹掉持枪姿势。玩家会恢复为默认的原版行走动画。

本模组的作用

三项相互独立的修复：

1. 第一人称 tick 补丁。 每个客户端 tick，当本地玩家手持 TacZ 枪械（IGun）时，通过 LocalPlayerPatch.toVanillaMode(...) 强制 Epic Fight 回到原版模式。一旦切换到非枪械物品，战斗模式立即恢复。
2. 第三人称 mixin。 在 priority=1500 处进行单个 HumanoidModel.setupAnim TAIL 注入（因此它在 Epic Fight 的之后运行），重新调用 TacZ 的 InnerThirdPersonManager.setRotationAnglesHead，恢复持枪姿势。
3. PlayerAnimator 依赖。 TacZ 的第三人称逻辑只有在 PlayerAnimator 位于类路径上时才会播放全身枪械动画（身体倾斜、腿部站姿、跪姿蹲伏）；否则会悄然回退为仅手臂姿势。本模组将 PlayerAnimator 设为必需依赖，使视觉效果与单独使用 TacZ 时一致。

无资源替换、无服务端代码、无配置文件。

要求

1.21.1 / NeoForge 构建（main 分支）

1.20.1 / Forge 构建（1201 分支）

同一 Minecraft 版本线上更新的 TacZ / Epic Fight / PlayerAnimator 小版本在加载时会被接受，但只有上面列出的版本经过验证可与各构建配合使用。

安装

1. 为你的 Minecraft 版本安装匹配的加载器
   （1.21.1 使用 NeoForge 21.1.228+，1.20.1 使用 Forge 47.4.10+）。
2. 将 TacZ、Epic Fight、PlayerAnimator 和 此 jar 文件
   （与你的 Minecraft 版本匹配的那个）放入你的 mods/ 文件夹。
3. 启动游戏。装备枪械时，TacZ 动画在第一人称和
   第三人称下都应正常播放；其他情况下，Epic Fight 姿态也会照常生效。

此模组仅在客户端运行。在专用服务器上可以放心省略。

已知限制

• 第一人称下仅会对本地玩家应用补丁。其他玩家手持枪械时，
  在你的屏幕上仍会显示 Epic Fight 的战斗骨架——修复这一点需要修改服务器状态，
  超出了本补丁的范围。（第三人称混入会应用于所有玩家。）
• 此补丁假定 TacZ（IGun、
  InnerThirdPersonManager.setRotationAnglesHead）、Epic Fight
  （LocalPlayerPatch.toVanillaMode、isEpicFightMode、
  EpicFightCapabilities.getCachedLocalPlayerPatch）的公开 API 签名以及
  PlayerAnimator 的模组 ID（playeranimator）保持不变。如果其中任何一项在未来版本中发生变化，
  此补丁就需要重新构建。

源代码 / 问题反馈

• 源代码：https://github.com/Ardelhite/epic-tacz
  （1.21.1：main / 1.20.1：1201）
• 问题报告：https://github.com/Ardelhite/epic-tacz/issues

许可证

MIT — 随你使用，不提供任何担保。

致谢

• 感谢 TacZ 团队制作了原版枪械模组，也感谢 1.20.1 Forge
  维护者和非官方的 1.21.1 NeoForge 移植者，让它能在不同版本中继续运行。
• 感谢 Yesman / Epic Fight 团队制作了这款战斗模组。
• 感谢 KosmX 提供PlayerAnimator，否则 TacZ 的第三人称枪械
  动画就会退化为仅有手臂动作的姿势。

本项目与 TacZ、Epic Fight 或 PlayerAnimator没有关联。