第一人称模型兼容

FPModel x Compat

第一人称模型 (FPM) 的技术兼容层，可在与战斗、动画、施法、翻滚、饰品和外观模组一起使用时，保持第一人称身体渲染的稳定性。

目标很简单：你的第一人称身体应与相机保持对齐，避免视觉穿模，并仅为你自己隐藏遮挡视线的头部/饰品外观，同时在第三人称和其他玩家视角中保持其可见。

兼容性建议

如果你使用 Better Combat 搭配基于 EMF 的玩家动画/资源包（例如 Fresh Animations Player 或 Fresh Moves），建议安装 Entity Player Compat 以修复动画冲突。

兼容性与集成

战斗与玩法

• Better Combat

  • 在攻击动画期间，同步手臂旋转和身体偏移与相机俯仰角。
  • 检测活动战斗动画阶段，实现更流畅的第一人称渲染。

• Spell Engine

  • 将第一人称对齐修复扩展到施法姿势。
  • 帮助手部、武器和法杖更自然地跟随玩家视角。

• Combat Roll

  • 在翻滚期间稳定第一人称身体渲染。
  • 防止运动过渡期间的相机穿模和视觉抖动。

• Punchy

  • 第一人称模型优先级：当 Punchy 被禁用或其 FPM 隐藏角度设为 never 时，阻止 Punchy 的 FPM 集成干扰第一人称模型的身体渲染。
  • 动画状态恢复：在 Punchy 的运行时钩子禁用 Better Combat 和 Spell Engine 的第一人称动画设置后，恢复其设置。

饰品、装备与外观

• Accessories

  • 在第一人称中隐藏与头部相关的饰品槽位，例如头、帽子、面部、面具和护目镜。
  • 在第三人称与其他玩家视角中保持饰品可见。

• Curios API (NeoForge)

  • 对基于 Curios 的装备应用同样的第一人称头部槽位隐藏行为。

• Essential

  • 当 FPM 渲染本地玩家身体时，在第一人称中隐藏与头部相关的 Essential 外观。
  • 在第三人称与其他玩家视角中保持 Essential 外观可见。
  • 支持 Fabric 和 NeoForge。

• Relics (NeoForge)

  • 为 Relics 物品（如猪灵面具和厨师帽）添加自定义渲染器修复。

• Artifacts

  • 在第一人称中隐藏围巾式渲染器，同时让其他遗物正常渲染。

配置

该模组包含一个 ignoredAccessorySlots 选项，用于控制在第一人称中隐藏哪些饰品/外观槽位名称。

项目目标

FPModel x Compat 最初是作为 First Person Model 和 Better Combat 之间的桥梁，但它正在发展为一个更广泛的第一人称渲染兼容中心。

希望看到某个模组被集成？

请创建一个 Issue，告诉我们你希望集成哪个模组！我们将评估并努力将其变为现实。