第一人称伙伴扩展

第一人称伙伴扩展

在第一人称视角中为玩家的手臂和手持物品添加动画。

第一人称 PAL 扩展

在第一人称视角下为玩家的手臂和手持物品添加动画。

“将你的 Blockbench 第一人称骨架在游戏中生动呈现。”


📖 描述

First Person PAL Expansion 是 Player Animation Library (PAL) 的一个附加模组,让你能够直接在第一人称视角下为玩家的手臂、手持物品甚至摄像机添加动画,使用与 PAL 相同的 Bedrock 动画格式。

在 Blockbench 中制作第一人称动画,将其放入 assets/<namespace>/fp_animations/,它们就会驱动原版手臂网格、手持物品和视角,效果与你在 Blockbench 预览中看到的完全一致。


🌟 特性

  • 第一人称手臂:原版手臂网格跟随你的 rightArm / leftArm 骨骼,与 Blockbench 预览 1:1 对应。
  • 第一人称物品:手持物品跟随 fp_r_item / fp_l_item 骨骼,因此枪械、工具及其他物品会紧贴动画中的手部。
  • 第一人称摄像机:fp_camera 骨骼可移动和翻滚真实视角。
  • 可选的物品模型预览:加载 Bedrock .geo.json 模型,在第一人称下渲染额外细节(弹匣、枪栓、枪口闪光等)。
  • AzureLib 兼容骨架:手臂骨骼使用与 AzureLib 相同的命名/约定,因此现有的枪械骨架只需少量修改即可使用。
  • 自动模型解析:fp_models/<name>.geo.json + textures/fp/<name>.png 会从动画中自动加载。
  • 第三人称配对:将第三人称动画与其第一人称对应动画配对(FpSyncRegistry / /fp_anim pair)。
  • 轻量:仅在第一人称动画播放时运行。

⚙️ 兼容性

  • Minecraft 版本:1.19.2、1.20.1、1.20.4、1.21.1、1.21.11、26.1.2、26.2、26.3。

  • 模组平台:

    • Fabric:✅ 完全支持!
    • Forge:✅ 完全支持!
    • NeoForge:✅ 完全支持!
  • 模组兼容性:

    • 需要 Player Animation Library (PAL)。
    • 兼容 AzureLib 风格的手臂骨架(相同的 leftArm / rightArm 骨骼约定)。

📦 安装

  1. 下载模组:从 GitHub Releases 或 Modrinth 下载。
  2. 安装依赖:确保 Player Animation Library (PAL) 已放入你的 mods 文件夹。
  3. 添加模组:将 .jar 文件放入 mods 文件夹。
  4. 启动并测试:启动 Minecraft,运行 /fp_anim play <animationID> 来预览你的第一人称动画。

🛠️ 开发者 API

First Person PAL Expansion 设计为可作为 API 使用。添加第一人称动画,将其与第三人称动画配对,并通过编程方式控制它们:

// Play a first-person animation on the local player
FpAnimationSystem.playFpAnimation(Minecraft.getInstance().player,
        Identifier.fromNamespaceAndPath("mymod", "fp_reload"));

// Pair a third-person animation with its first-person counterpart
FpAnimationSystem.registerPaired(
        Identifier.fromNamespaceAndPath("mymod", "reload"),
        Identifier.fromNamespaceAndPath("mymod", "fp_reload"));

完整文档(骨骼、动画格式、额外数据、命令和 Java API)位于 WIKI。


📝 贡献与反馈

欢迎贡献和错误报告!

  • 发现 bug?在 GitHub Issues 上报告。
  • 有功能请求?提交 issue 或加入 Discord。
  • 想要贡献?Fork 项目并提交 pull request。

📄 许可证

本模组基于 MIT 许可证 授权。详情请查看 LICENSE 文件。


❤️ 致谢

由 [RazorPlay01] 创建。手臂渲染是 AzureLib 的 AzItemArmRenderUtil 的 1:1 移植(MIT 许可证,Copyright (c) 2024 AzureDoom)。感谢 PAL 团队提供的动画库,本模组基于此构建。

“你的手臂,你的物品,你的摄像机——全部动画化,全部在第一人称视角下。” 🎯