图X EMF桥接

图X EMF桥接

使Figura头像能与使用EMF的玩家动画资源包配合工作

FiguraXEMF Bridge

FiguraXEMF Bridge 允许 Figura 准确读取由 Entity Model Features (EMF) 在玩家模型上生成的动画。


为什么需要这个?

通常情况下,EMF 在渲染期间运行其自定义的 .jem 和 .jpm 动画,而 Figura 读取玩家模型姿态的时间更早,就在 PlayerModel.setupAnim 之后立即进行。由于这一时间差异,Figura 只能看到原版玩家姿态,而不是 EMF 动画后的姿态。

此桥接模组强制 EMF 的动画在 PlayerModel.setupAnim 结束时处理。随后 Figura 脚本和虚拟形象便可读取真实的动画位置和旋转,既不会重复运行动画,也不会影响性能。


特性

  • 完全兼容: Figura 虚拟形象和脚本可以与 EMF 动画化的玩家部件交互。
  • 游戏内切换: 按 F8 可即时启用或禁用桥接(可在 选项 > 控制 > Figura x EMF Bridge 中重新绑定)。
  • 简单配置: 通过 config/figuraxemf-bridge.properties(enabled=true|false)轻松切换。
  • 故障安全设计: 如果 EMF 内部实现发生变化或发生错误,桥接会安全地自我禁用并记录日志警告,而不会使游戏崩溃。

需求