Player Animation Library More Rotation

PlayerAnimationLibraryMoreRotation

英语

PlayerAnimationLibraryMoreRotation 是一款面向玩家动画创作者和模组开发者的附加前置库。它扩展了 Player Animation Library 和可弯曲立方体功能，主要改进弯曲变形和手持物品动画，并增强对多轴旋转的支持，让自定义玩家动作更加完整、灵活。

主要功能

• 扩展玩家身体弯曲变形的轴向支持，不再局限于单一方向。
• 允许弯曲骨骼通过 bend.position 和 bend.scale 通道使用位置和缩放。
• 改进手持物品动画，使武器、工具和动作姿势能够更精确地应用 Y/Z 轴旋转。
• 改进部分玩家动画骨骼的旋转表现。
• 保持与旧版 Player Animation Library 动画的兼容性。
• 为其他模组提供可复用的玩家动画播放、停止和服务器同步支持。

动画兼容性

现有的 Player Animation Library 动画应该仍可正常使用。旧版弯曲格式仍受支持，同时也可以使用较新的数组格式弯曲值，让动作表现更加丰富。

示例：

"bend": 35

"bend": [35, 0, 0]

"bend": {
  "0.0": { "post": [0, 0, 0] },
  "0.5": { "post": [35, 20, -15] },
  "1.0": { "post": [0, 0, 0] }
}

弯曲骨骼也可以使用位置和缩放：

"left_arm": {
  "bend": {
    "rotation": {
      "0.0": { "post": [0, 0, 0] },
      "0.5": { "post": [35, 20, -15] },
      "1.0": { "post": [0, 0, 0] }
    },
    "position": {
      "0.0": { "post": [0, 0, 0] },
      "0.5": { "post": [2, 1, 0] },
      "1.0": { "post": [0, 0, 0] }
    },
    "scale": {
      "0.0": { "post": [1, 1, 1] },
      "0.5": { "post": [1.25, 0.8, 1] },
      "1.0": { "post": [1, 1, 1] }
    }
  }
}

scale 使用倍率，因此 1 表示原始大小。

Blockbench 插件

制作动画时，请使用 PAL Bend Player Tools Blockbench 插件。

推荐工作流程：

1. 使用 PAL Bend Player Animation 创建新项目。
2. 如有需要，导入现有动画。该插件可以导入 PAL 原版动画 JSON、PAL 表情 JSON、DragonCore 玩家模型动画 JSON，以及 PlayerAnimationLibraryMoreRotation 动画 JSON。
3. 在 Blockbench 中为可见的玩家骨骼制作动画。*_bend 辅助骨骼仅用于编辑；导出时会转换回真正的 PAL bend 数据。
4. 使用 PAL: Export Player Animation 导出。
5. 将导出的 JSON 放入资源包或模组中的 assets/<namespace>/player_animations/。

导出行为：

• 如果动画没有弯曲数据，或仅使用旧版 X 轴弯曲，插件会导出普通的 Player Animation Library 动画。如果动画兼容表情格式，也可以导出为 PAL 表情格式。
• 如果任何弯曲使用 Y/Z 轴旋转、弯曲局部位置或弯曲局部缩放，插件会使用 bend.rotation、bend.position 和/或 bend.scale 导出 PlayerAnimationLibraryMoreRotation 格式。
• 要转换 DragonCore 玩家模型动画，请创建一个 PAL Bend Player Animation - DragonCore Player Model 项目，导入旧动画后重新导出。

导出的文件不应包含供运行时使用的自定义辅助骨骼。本库会从真实的 PAL 玩家骨骼（如 torso、right_arm、left_arm、right_leg 和 left_leg）读取扩展弯曲数据。

中文

PlayerAnimationLibraryMoreRotation 是一个面向玩家动画作者和模组开发者的附属库，用来扩展 Player Animation Library 和 bendable-cuboids 的玩家动画表现能力，重点补足 bend 弯曲和手持物品动画在更多轴向上的旋转支持，让自定义玩家动作更完整、更灵活。

主要功能

• 让玩家身体部位的 bend 弯曲支持更丰富的轴向变化，不再只局限于单一方向。
• 让 bend 骨骼通过 bend.position 和 bend.scale 通道使用位移和尺寸变化。
• 改善手持物品动画，让武器、道具和动作姿势能更准确地应用 Y/Z 等轴向旋转。
• 改善部分玩家骨骼动画的旋转表现。
• 保持旧的 Player Animation Library 动画兼容。
• 提供通用的玩家动画播放、停止和服务端同步能力，方便其他模组直接调用。

动画兼容性

已有的 Player Animation Library 动画应继续可用。旧的 bend 写法仍然支持，同时也可以使用新的数组形式来表达更复杂的弯曲动作。

示例：

"bend": 35

"bend": [35, 0, 0]

"bend": {
  "0.0": { "post": [0, 0, 0] },
  "0.5": { "post": [35, 20, -15] },
  "1.0": { "post": [0, 0, 0] }
}

bend 骨骼也可以使用位移和尺寸：

"left_arm": {
  "bend": {
    "rotation": {
      "0.0": { "post": [0, 0, 0] },
      "0.5": { "post": [35, 20, -15] },
      "1.0": { "post": [0, 0, 0] }
    },
    "position": {
      "0.0": { "post": [0, 0, 0] },
      "0.5": { "post": [2, 1, 0] },
      "1.0": { "post": [0, 0, 0] }
    },
    "scale": {
      "0.0": { "post": [1, 1, 1] },
      "0.5": { "post": [1.25, 0.8, 1] },
      "1.0": { "post": [1, 1, 1] }
    }
  }
}

scale 是倍率，1 表示原尺寸。

Blockbench 插件

制作动画时，推荐使用我制作的PAL Bend Player Tools Blockbench 插件。

推荐流程：

1. 使用 PAL Bend Player Animation 新建项目。
2. 如果已有动画，可以直接导入。插件可以导入 PAL 原版动画 JSON、PAL emote JSON、龙核玩家模型动画 JSON，以及 PlayerAnimationLibraryMoreRotation 动画 JSON。
3. 在 Blockbench 中正常制作玩家动画。*_bend 骨骼只是方便编辑用的辅助骨骼，导出时会转换回真实 PAL 骨骼上的 bend 数据。
4. 使用 PAL：导出玩家动画 导出。
5. 将导出的 JSON 放到资源包或模组的 assets/<namespace>/player_animations/ 下。

导出规则：

• 如果动画没有 bend 数据，或只有旧版 X 轴 bend，插件会导出普通 Player Animation Library 动画。动画兼容时，也可以选择导出 PAL emote 格式。
• 如果 bend 使用了 Y/Z 轴旋转、bend 局部位移或 bend 局部缩放，插件会自动导出 PlayerAnimationLibraryMoreRotation 支持的格式，也就是 bend.rotation、bend.position、bend.scale。
• 如果要转换龙核玩家模型的旧动画，可以新建 PAL Bend Player Animation - 龙核玩家模型版 项目，导入旧动画后再导出。

最终放进游戏运行的文件不应该依赖自定义辅助骨骼。本库会从真实 PAL 玩家骨骼读取扩展 bend 数据，例如 torso、right_arm、left_arm、right_leg、left_leg。