星云特效

星云特效

一个粒子模组,由高性能GPU实例化渲染引擎驱动,并针对NBL流式传输进行了优化,可实现流畅的大规模动画。

装饰

横幅

Nebula FX

许可证 OpenGL Mac 兼容性

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]

致谢

贡献

欢迎任何形式的贡献!你可以通过以下方式参与:

  • 提交 Issue:报告 Bug、建议新功能或提供反馈。
  • 提交 Pull Request:修复已知问题、优化代码或改进文档。
  • 本地化:帮助我们翻译模组到更多语言。

请在提交 PR 前确保你的代码遵循项目的编码风格。

许可证

本项目采用 GPL-v3 许可证。


由 Atemukesu 用 ❤️ 制作