
星云特效
一个粒子模组,由高性能GPU实例化渲染引擎驱动,并针对NBL流式传输进行了优化,可实现流畅的大规模动画。
查看大图
Nebula FX
Nebula 是一款粒子模组,由高性能 GPU 实例化渲染引擎驱动,并采用优化的 NBL 流式传输,实现流畅的大规模动画。
核心特性:
高性能渲染
- GPU 驱动: 基于 OpenGL 4.4+ 计算着色器 和 SSBO 技术构建。
- 零分配: 在逻辑上确保运行时不会发生对象分配,彻底消除 GC 压力。
- PMB(持久映射缓冲区): 利用持久映射缓冲区技术,实现从 CPU 到 GPU 的零拷贝数据传输。
- OIT(顺序无关透明度): 支持加权混合 OIT,完美解决粒子重叠时的排序问题。
先进的架构设计
- 多线程流式传输:
NblStreamer在后台线程中执行 Zstd 解压和状态计算,确保主渲染线程永远不会被阻塞。 - 资源引用计数: 智能的
TextureCacheSystem管理显存资源,支持多实例复用和自动垃圾回收。 - 不可变快照: 使用
TextureAtlasMap保证多线程环境下的绝对线程安全。
兼容性
- 与 Iris 光影 无缝兼容。
- 支持 ReplayMod 录制和渲染。
.nbl 文件格式
Nebula 使用专为流式传输而设计的自定义 .nbl 二进制格式:
- Zstd 压缩: 高压缩比,同时具备超快的解压速度。
- SoA 布局: 数据在内存中以 结构体数组(Structure of Arrays) 布局组织,以最大化 CPU 缓存命中率。
- I/P 帧结构: 类似视频编码;利用关键帧(I 帧)和预测帧(P 帧)大幅缩减文件大小。
有关 nbl 格式的更多信息,请点击此处。
此外,你可以使用 Blender 插件将 Blender 动画导出为 .nbl 粒子动画。
安装与使用
前置要求
- Minecraft 1.20.1 (Fabric)
- Fabric API
- ThreatenGL
- ModMenu
- Yet Another Config Lib
- 支持 OpenGL 4.4+ 的 GPU
资源路径
- 动画文件:
.minecraft/nebula/animations/*.nbl
播放动画
你可以使用此命令播放 NBL 动画。
/nebula play <animation_name> [origin_x] [origin_y] [origin_z]
致谢
- MadParticle 提供了灵感和参考实现。
贡献
欢迎任何形式的贡献!你可以通过以下方式参与:
- 提交 Issue:报告 Bug、建议新功能或提供反馈。
- 提交 Pull Request:修复已知问题、优化代码或改进文档。
- 本地化:帮助我们翻译模组到更多语言。
请在提交 PR 前确保你的代码遵循项目的编码风格。
许可证
本项目采用 GPL-v3 许可证。
由 Atemukesu 用 ❤️ 制作
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。