光子 & 史诗战斗

Photon & EpicFight 整合

这是一个用于整合 Forge 模组的工具，旨在 Photon 粒子编辑器中预览 EpicFight 的骨骼动画，并将视觉特效绑定到特定的骨骼上。

🎯 目的

该模块为 Photon VFX 编辑器添加了对 EpicFight 骨骼动画的支持，使特效创作者能够：

• 在粒子编辑器中加载玩家克隆体，并实时预览 EpicFight 动画。
• 将当前编辑的特效绑定到指定的骨骼上（位置和旋转会实时更新）。
• 通过指令在游戏中将特效绑定到玩家或实体的骨骼上。

🛠️ 功能

编辑器整合

• 动画控制面板 - 在编辑器的“视图”菜单中启用“动画控制”，即可搜索并播放 EpicFight 动画。
• 骨骼绑定输入框 - 输入骨骼名称（如 Root, Chest, Head），编辑器中的特效将根据该骨骼的位置和旋转实时更新。
• 骨骼名称自动补全 - 输入时，会提示 Armature（骨架）中的所有骨骼名称，提供模糊匹配的下拉建议，并支持页面滚动。
• 实时玩家同步 - 克隆体会每帧同步玩家的装备、生命值和吸收值。
• 预览开关 - 通过指令 /photon_preview 控制是否启用 EpicFight 预览。

游戏内指令

• /bone play <命名空间> <路径> [骨骼名称] - 在指定骨骼上播放特效（默认为 Tool_R）。
• /bone stop [骨骼名称] [命名空间] [路径] - 停止指定骨骼上的特效。
• /bone list - 列出所有可用的特效。
• /photon_EpicFight_Editor - 切换编辑器的 EpicFight 预览模式。

注： 所有指令均支持 Tab 键自动补全（命名空间、路径、骨骼名称）。

⚙️ 动画驱动

• 使用 AnimationPlayer.tick() 自然推进动画时间，并设置 setHardPause(true) 以防止 ClientAnimator 干扰。
• 避免使用 modifyPose() / correctRootJoint()，直接读取 getRawPose() 以保留 Root 骨骼的位移。
• 动画结束后自动重置实体位置。

📖 使用说明

编辑器预览

1. 要启用预览，请在游戏中输入 /photon_preview（再次输入可禁用）。
2. 打开 Photon 粒子编辑器（/pe）。
3. 在“视图”菜单中打开“动画控制”浮动窗口。
4. 输入“动画资源路径”并点击播放。
5. 在骨骼输入框中输入骨骼名称（如 Root, Chest），特效将跟随骨骼移动。

指令绑定

# 在 Tool_R 骨骼上播放来自 "epicfight" 命名空间的 "test" 特效
/bone play epicfight test Tool_R

# 在 Chest 骨骼上播放
/bone play epicfight test Chest

# 停止 Chest 上的所有特效
/bone stop Chest

# 停止 Chest 上指定的特效
/bone stop Chest epicfight test

# 停止所有骨骼特效
/bone stop

# 列出可用的特效
/bone list

📦 依赖

• Photon - VFX 编辑器
• EpicFight - 20.14.X
• LDLib - UI 库（Photon 的依赖）
• Minecraft Forge 1.20.1