RuneFX引擎 | 可视化VFX和粒子编辑器
✨ 让你的Minecraft世界栩栩如生。
RuneFX Engine 让你可以直接在Minecraft中通过可视化的世界编辑器放置、动画、组合、移动和触发环境VFX。构建静态氛围，沿自定义路径发送效果，堆叠完整的组合，并实时预览每个更改，而无需手动编写效果配置。
⚠️ 重要提示： RuneFX Engine是为官方RuneFist Effects内容构建的。它加载兼容的、签名的RuneFist
.rfxpack产品，并不导入或保证支持第三方VFX、松散的Blockbench文件、自定义精灵表、MythicMobs效果或其他创作者制作的包。内置的Vanilla Particle Workshop仍然可用于支持的原生Minecraft粒子。
🎨 直接在你的世界中进行可视化编辑
以GUI为主的工作流程： 浏览、放置、编辑、复制、预览、保存和删除VFX，通过清晰的菜单。
实时编辑器棒： 选择锚点、抓取点、调整深度、贴合表面，并实时移动效果。
私人观众和任务效果： 将完整的VFX/SFX设置目标定为 所有人、 仅限激活者、 记分板标签，或 权限——无需添加任务插件依赖。
静态和多点路径： 使用线性、向心Catmull-Rom、Bezier或B-Spline曲线。
路径控制： 正向、反向和乒乓遍历，带有缓和和跟随路径方向。
分层组合： 在一个生命周期、激活设置和路径下组合最多16个已安装的RuneFist VFX。
每层控制： 偏移、旋转、缩放、延迟、改变播放速度、隐藏、复制或重新排序层。
完整生命周期： 每个创作的效果都可以使用平滑生成、循环空闲和死亡行为。
原生激活： 始终激活、固定/随机间隔、玩家接近、进入/离开、方块交互、红石和命令触发。
持久放置： 保存的VFX在重启后返回，产品更新使用安全验证和回滚。
🧩 四个视觉系统在一个工作流程中
完整的动画3D ModelEngine VFX
动画3D模型粒子发射器
自定义2D广告牌精灵和每粒子精灵表动画
支持的原生Minecraft Java粒子
RuneFX仅暴露对每个效果安全的控制。根据所选的VFX，这些可能包括缩放、旋转、播放速度、亮度/发光、发射、生命周期、形状、扩散、速度、重力、阻力、旋转、模拟空间和激活行为。
🔊 属于世界的声音
独立使用SFX： 放置位置声音效果或非音乐区域氛围，而无需视觉效果。
让组合栩栩如生： 将SFX与VFX叠加，使声音遵循相同的放置、路径、生命周期和触发。
为响应场景而构建： 官方声音包可以使用单独的生成、空闲、移动和死亡提示。
微调每个放置： 直接通过可视化编辑器调整音量、音调、自然音调变化、可听范围和循环间距。
声音可以对接近、交互、间隔、红石、命令和其他RuneFX触发作出反应，同时距离感知播放使它们在世界中保持稳定。
✨ Vanilla Particle Workshop
从支持的Minecraft Java粒子创建和编辑放置，而无需导入自定义文件。可视化选择粒子，立即预览，然后仅调整适用的设置。工作坊粒子也可以与已安装的RuneFist VFX并排堆叠。
📦 包含在RuneFX Engine中
RuneFX Engine 1.2.0 for Paper
完整的可视化编辑器、编辑器棒、菜单、路径、组合、激活系统和放置管理器
Vanilla Particle Workshop
Starter Dust - 原生Minecraft粒子示例
包含的3D VFX - 完整的动画ModelEngine示例
包含的动画漩涡 - 自定义动画2D精灵示例
包含的3D粒子 - 独立动画的3D粒子示例
简明的安装、验证、故障排除和回滚指南
其余的效果目录不包括在内。 额外的官方RuneFist Effects是单独的产品，设计为在其未修改的 .rfxpack 放置在 plugins/RuneFX/packs 中自动出现。
🛠️ 要求
Minecraft / Paper： 1.21.11
Java： 21或更新版本
ModelEngine： 4.1.x是必需的；已测试R4.1.0
客户端资源包： 每个玩家必须接受当前服务器包
Nexo： 可选
Folia： 不支持
其他服务器分支或更新的游戏/依赖版本可能有效，但除非明确列出，否则不受支持。支持可能会要求在支持的Paper构建上重现。
MythicMobs、ItemsAdder、MMOItems、MMOCore、WorldGuard、Citizens、PlaceholderAPI和Nexo并不是RuneFX的放置、路径、组合或激活系统所必需的。 ModelEngine是必需的依赖，并不包含在此次购买中。
🚀 安装
停止并备份服务器。
安装ModelEngine 4.1.x。
提取下载并将
RuneFX-Engine-1.2.0.jar放置在plugins/中。完成一个资源包流程：Nexo或独立。
启动服务器，作为操作员加入，并接受更新的资源包。
运行
/rfx status和/rfx validate，然后使用/rfx打开编辑器。
使用Nexo
RuneFX发布一个管理的外部包，并要求Nexo重新生成并上传合并的包。重新连接后，刷新包可用。
不使用Nexo
RuneFX生成 plugins/RuneFX/generated/RuneFX-ResourcePack.zip。服务器所有者必须托管或将该ZIP合并到提供给玩家的资源包中。RuneFX不单独托管独立的ZIP。
安装购买的效果产品
将未修改的 .rfxpack 直接放置在 plugins/RuneFX/packs 中。请勿提取、重命名内部文件、编辑或手动将模型复制到ModelEngine中。打开 效果 > 已安装产品 查看签名、兼容性、依赖、激活和资源包状态。
🔐 官方内容和受保护资产
RuneFX仅承认由RuneFist Studios签名的兼容包。购买引擎并不会解锁第三方VFX导入，支持不涵盖来自其他创作者的效果、模型、精灵或修改包。
当前的RuneFist Effects产品使用签名的受保护运行时包。可编辑的源项目、私有创作配置、签名工具和原始Blockbench项目文件是 不包括在内，除非列表明确说明。受保护的模型和效果数据由RuneFX自动处理。请勿提取、修改、重新打包、重新分发或转售产品内容。
玩家仍然必须接收客户端资源包资产以渲染自定义视觉效果。保护措施使可编辑的创作源和内部配置不在正常客户工作流程中，检测修改并阻止重新分发；并不宣传为不可破解的DRM。
性能和视觉期望
RuneFX对每个效果和全局施加安全限制，以保护服务器和客户端性能。密集的发射器可能会被限制、延迟或在共享显示预算满时跳过新粒子。实际容量取决于服务器、玩家数量、同时放置、视距、效果类型和客户端硬件。请从创作的默认值开始，并在生产使用前测试更改。
亮度级别15意味着Minecraft全亮行为；它不会自动创建着色器辉光。着色器包、客户端模组、可访问性设置和资源包顺序可以改变效果的外观。
💡 常见问题
我可以导入自己的VFX或其他创作者的VFX吗？
不可以。RuneFX加载兼容的官方RuneFist .rfxpack 产品。它不导入任意模型、精灵表、YAML、Snowstorm文件、MythicMobs效果或第三方包。你可以在Vanilla Particle Workshop中从支持的原生粒子创建放置。
购买RuneFX是否包括所有效果产品？
不包括。此次购买包括引擎和上述四个演示。商业效果产品单独出售。
RuneFX是否替代ModelEngine？
不。ModelEngine 4.1.x是必需的，并不包括在内。
我需要Nexo吗？
不。Nexo是可选的。如果没有，你必须通过正常的服务器资源包设置交付RuneFX生成的独立资源包。
原始Blockbench项目是否包含在内？
不，除非特定产品列表明确说明。
我可以使用插件重载吗？
不。在替换RuneFX或所需依赖JAR之前，请停止服务器。RuneFX自己的重载是用于产品/配置重新扫描，而不是实时插件替换。
💬 支持
支持涵盖在列出的环境中安装、未修改的官方RuneFist产品、可重现的RuneFX缺陷以及在此页面上承诺的行为。它不会自动涵盖第三方/自定义/重新打包的VFX、不受支持的分支或版本、插件重载、手动资源包冲突、定制效果创建或与RuneFX并排安装的无关插件。
为了快速诊断，请包括确切的版本、受影响的产品、来自 mclo.gs 的完整启动/重现日志、来自 /rfx status 和 /rfx validate 的输出，以及清晰的重现步骤。
