
第一人称伙伴扩展
在第一人称视角中为玩家的手臂和手持物品添加动画。
查看大图第一人称 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骨骼约定)。
📦 安装
- 下载模组:从 GitHub Releases 或 Modrinth 下载。
- 安装依赖:确保 Player Animation Library (PAL) 已放入你的
mods文件夹。 - 添加模组:将
.jar文件放入mods文件夹。 - 启动并测试:启动 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 团队提供的动画库,本模组基于此构建。
“你的手臂,你的物品,你的摄像机——全部动画化,全部在第一人称视角下。” 🎯
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。