第一人称模型兼容

FPModel x Compat

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

目标很简单：你的第一人称身体应始终与相机对齐，避免视觉遮挡，并且仅对你隐藏遮挡视线的头部/饰品装饰，同时保持它们在第三人称视角和其他玩家眼中可见。

兼容性建议

如果你使用带有基于 EMF 的玩家动画/资源包（如 Fresh Animations Player 或 Fresh Moves）的 Better Combat，建议安装 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 最初是作为 第一人称模型 和 Better Combat 之间的桥梁而诞生的，但它正在发展成一个更广泛的用于第一人称渲染的兼容性中心。

有想要集成的模组吗？

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