用途:将编译生成的 out/vfx 产物集成到游戏或应用的渲染器中,支持 Three.js(规范后端)与 PixiJS(UI/2D 场景)。不要在游戏中直接加载创作工程文件。
安装:只安装所选的可选 peer 依赖,例如 npm install nixie-fx three 或 npm install nixie-fx pixi.js。
用法:先确认宿主渲染器、渲染循环、资源管线、相机或投影以及清理生命周期;通过 nixie-fx/export 的 loadVfxExportBundle 加载完整编译包;按需只读一份后端指南(three.md 或 pixi.md);由宿主应用注入的 provider 解析纹理、材质图、网格与子特效;创建渲染器与特效实例,每帧只调用一次 renderer.update(deltaSeconds),不要同帧再调用 instance.update。
包边界:仅使用公开入口 nixie-fx、nixie-fx/pixi、nixie-fx/three、nixie-fx/materials、nixie-fx/export,Node 文件系统导出工具用 nixie-fx/export/node;禁止深层导入 nixie-fx/src/**、复制运行时代码或导入未使用的后端。
限制与规则:应用、场景、相机、时钟、URL、缓存与错误上报由游戏自己持有;异步资源需在生成特效前预加载,渲染期 provider getter 必须同步;作者路径视为包内相对查找键,由宿主 provider 映射为 URL 或图集帧;需要确定性播放时使用稳定种子;非活动运行时需暂停或销毁,隐藏场景不应继续 tick;Three.js 性能优化需查看每发射器绘制数并集成 ThreeVfxBatcher,仅共享材质不会合并绘制,自定义材质会禁用内置实例化快路径。其他引擎可参考引擎中立的导出 JSON 与共享模拟实现移植。未在目标渲染器中实际观察导出特效前,不要声称与编辑器一致。其他细节暂未提供。