ISS 冲击传递

ISS 冲击传递

阻止Punchy和Iron's Spellbooks的法术施放动画在第一人称视角下重叠。

修复了 Punchy 的第一人称手部动画 与 Iron's Spellbooks 的施法动画 之间的冲突。

连续施放瞬发法术时,Iron 的动画和 Punchy 的动画会叠在一起播放,或在两者之间来回跳变。长施法结束把控制权交还给 Punchy 时会出现卡顿:Punchy 的右键动作从中间开始播放,或者原版的“举起物品”姿势在中间闪一下。本模组在每个 tick 决定由哪一个占用屏幕,因此任何时候只会绘制其中一个。

功能说明

  • 瞬发法术不再重叠 —— 只要 Iron 的施法动画确实在播放(而不只是法术处于“施法中”状态),Punchy 就保持隐藏,包括连续施法之间的间隙。
  • 干净地交还给 Punchy —— Iron 的动画结束时,先重置 Punchy 的动画状态,让它从头开始播放,而不是从中间接着一段过期的右键动作。
  • 不再闪现原版举物品姿势 —— 补上了两个动画之间原版持握姿势短暂露出的空隙。
  • Epic Fight 第三人称 —— 配合 Epic Fight 和 efiscompat 时,在 Iron 的施法动画播放期间,Epic Fight 会始终负责绘制玩家。此前画面会在 Epic Fight 的施法动画和 Iron 自己的动画之间来回切换,看起来像动画混合在一起、头部抖动。
  • 遵循 Iron 自己的设置 —— 如果在 Iron 的配置中关闭了第一人称施法动画,Punchy 会保持可见并播放自己的动画。
  • 无需任何设置 —— 开箱即用。每个部分都可以在配置中关闭。

需求

  • Minecraft 1.20.1,Forge 47+
  • Punchy 2.7 或更高版本(已用 3.0 测试)
  • Iron's Spellbooks 3.0.0 或更高版本
  • 可选:Epic Fight + efiscompat(用于第三人称修复)

Punchy 和 Iron's Spellbooks 是软依赖:如果缺少其中一个,模组不会做任何事,只会输出一行日志说明。它绝不会导致游戏崩溃。

配置

config/iss_punchy_handoff-client.toml

  • enabled(默认 true)—— 第一人称交还的总开关。
  • ironsAnimationForInstantSpells(默认 true)—— 瞬发法术播放 Iron 的动画,Punchy 等待其结束。设为 false 则改为播放 Punchy 自己的交互动作,并抑制 Iron 的第一人称动画。
  • instantGraceMillis(默认 0)—— Iron 的动画结束后 Punchy 继续隐藏的额外时间(毫秒)。
  • graceMillis(默认 0)—— 长施法结束或被取消后 Punchy 继续隐藏的额外时间(毫秒)。
  • keepEpicFightRenderDuringCast(默认 true)—— Epic Fight 第三人称修复。
  • advancedHandoff(默认 false)—— 实验性附加功能:长施法立即交还给 Punchy,并且 Iron 的第一人称动画按施法类型分别控制。
  • logging(默认 false)—— 将状态变化写入 latest.log([iss_punchy] 行)。仅在报告 Bug 时需要。一次性启动日志始终会写入。

注意事项

  • 仅客户端。 不要安装在服务器上。
  • 钩子通过 Mixin 应用并在启动时验证:latest.log 中包含一行 [iss_punchy] mixin hooks: ...=APPLIED,因此你可以看到它是否生效。
  • 除 Punchy 外,未测试与其他第一人称动画模组的兼容性。