Photon & EpicFight

Photon & EpicFight 整合

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

🎯 用途
该模块为 Photon VFX 编辑器添加了对 EpicFight 骨骼动画的支持，让 VFX 创作者能够：
在粒子编辑器中加载玩家克隆体，并实时预览 EpicFight 动画。
将当前编辑的特效绑定到指定骨骼（实时更新位置和旋转）。
通过指令在游戏中将特效绑定到玩家或实体的骨骼。

🛠️ 功能
编辑器整合
动画控制面板 – 在编辑器的“视图”菜单中启用“动画控制”，即可搜索并播放 EpicFight 动画。
骨骼绑定输入框 – 输入骨骼名称（如 Root、Chest、Head），编辑器中的特效就会根据该骨骼的位置和旋转实时更新。
骨骼名称自动补全 – 输入时会显示 Armature 中的所有骨骼名称，并提供支持翻页滚动的模糊匹配下拉建议。
玩家实时同步 – 克隆体会逐帧同步玩家的装备、生命值和伤害吸收值。
预览开关 – 通过 /photon_preview 指令控制是否启用 EpicFight 预览。
游戏内指令
/bone play [bone_name] – 在指定骨骼上播放特效（默认为 Tool_R）。
/bone stop [bone_name] [namespace] [path] – 停止指定骨骼上的特效。
/bone list – 列出所有可用特效。
/photon_EpicFight_Editor – 切换编辑器的 EpicFight 预览模式。
注：所有指令均支持 Tab 键自动补全（命名空间、路径、骨骼名称）。

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

📖 使用说明
编辑器预览
在游戏中输入 /photon_preview 启用预览（再次输入即可关闭）。
打开 Photon 粒子编辑器（/pe）。
在“视图”菜单中打开“动画控制”浮动窗口。
输入“动画资源路径”，然后点击播放。
在骨骼输入框中输入骨骼名称（如 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

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 – 切换编辑器的 EpicFight 预览模式。

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

⚙️ 动画驱动

使用 AnimationPlayer.tick() 自然推进动画时间，并设置 setHardPause(true) 以防止 ClientAnimator 干扰。

避免使用 modifyPose() / correctRootJoint()，直接读取 getRawPose() 以保留 Root 骨骼的位移。

动画结束后自动重置实体位置。

📖 使用说明

编辑器预览

要启用预览，请在游戏中输入 /photon_EpicFight（再次输入可禁用）；

打开 Photon 粒子编辑器（/photon_editor）；

在“视图”菜单中打开“动画控制”浮动窗口；

输入“动画资源路径”并点击播放；

在骨骼输入框中输入骨骼名称（如 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。