Перейти к содержимому
Mineforgian

NebulaFX

A particle mod powered by a high-performance GPU-instanced rendering engine and optimized NBL streaming for fluid, large-scale animations.

Загрузки
30K
Подписчики
7
Обновлён
4 июля 2026 г.
Лицензия
GPL-3.0-only

Опубликован 15 февраля 2026 г.

Исходный кодСообщить об ошибке

Banner

Nebula FX

License OpenGL Mac Compatibility

Nebula is a particle mod powered by a high-performance GPU-instanced rendering engine and optimized NBL streaming for fluid, large-scale animations.

Core Features:

High-Performance Rendering

  • GPU Driven: Built on OpenGL 4.4+ Compute Shaders and SSBO technology.
  • Zero-Allocation: Logically ensures no object allocation during runtime, completely eliminating GC pressure.
  • PMB (Persistent Mapped Buffer): Utilizes persistent mapped buffer technology to achieve zero-copy data transfer from CPU to GPU.
  • OIT (Order Independent Transparency): Supports weighted-blended OIT to perfectly resolve sorting issues during particle overlapping.

Advanced Architectural Design

  • Multi-threaded Streaming: NblStreamer performs Zstd decompression and state calculation in a background thread, ensuring the main rendering thread is never blocked.
  • Resource Reference Counting: Intelligent TextureCacheSystem manages VRAM resources, supporting multi-instance reuse and automatic garbage collection.
  • Immutable Snapshots: Uses TextureAtlasMap to guarantee absolute thread safety in multi-threaded environments.

Compatibility

  • Seamlessly compatible with Iris Shaders.
  • Supports ReplayMod recording and rendering.

.nbl File Format

Nebula uses a custom .nbl binary format specifically engineered for streaming:

  • Zstd Compression: High compression ratios coupled with ultra-fast decompression speeds.
  • SoA Layout: Data is organized in memory using a Structure of Arrays layout to maximize CPU cache hit rates.
  • I/P Frame Structure: Similar to video encoding; utilizes Keyframes (I-Frames) and Predicted Frames (P-Frames) to drastically reduce file size.

For more information about the nbl format, please click here.

Also, you can use the Blender Addon to export a Blender animation as a .nbl particle animation.

Installation & Usage

Prerequisites

  • Minecraft 1.20.1 (Fabric)
  • Fabric API
  • ThreatenGL
  • ModMenu
  • Yet Another Config Lib
  • GPU with OpenGL 4.4+ support

Resource Paths

  • Animation Files: .minecraft/nebula/animations/*.nbl

Play Animations

You can use this command to play NBL Animations.

/nebula play <animation_name> [origin_x] [origin_y] [origin_z]

Thanks

  • MadParticle for the inspiration and reference implementation.

Contributing

Contributions of any kind are welcome! You can participate by:

  • Submitting Issues: Report bugs, suggest new features, or provide feedback.
  • Submitting Pull Requests: Fix known issues, optimize code, or improve documentation.
  • Localization: Help us translate the mod into more languages.

Please ensure your code follows the project's coding style before submitting a PR.

License

This project is licensed under the GPL-v3 License.

Made by Atemukesu with ❤️

Ченджлог

1.0.8-1.21.1Релиз1.21.1 · 4 июля 2026 г.

Nebula v1.0.8

发布信息

  • 发布日期: 2026-07-04 11:54:13
  • Git 提交: 5f11e10
  • 上一版本: v1.0.8

详细提交记录

自上版本 v1.0.8 以来的变更

  • build(build_and_release.py): 补全gh命令的仓库参数 (5f11e10)
  • build(scripts): 优化发布文件收集逻辑并新增目录清理 (a5f9299)

合并的 Pull Requests

  • #5 Add shader-compatible vanilla particle pipeline (by @enzhi-z)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.8+1.20.1.jar (11.27M)
    • MD5: 3a718384c148c239d5d33f5d4a68dc81
    • SHA256: 18a7b25f5ed873f4e35d06857887533241c515709da11b22a0ace1ea01170945
  • nebula-1.0.8+1.21.1.jar (11.28M)
    • MD5: f3cc1b99aa52406389b61db6bb84de6b
    • SHA256: 5f3f9eb5bd7835ee459bc497ad306f36bee74a1a239938cd1fc8e7497fd62a69
1.0.8-1.20.1Релиз1.20.1 · 4 июля 2026 г.

Nebula v1.0.8

发布信息

  • 发布日期: 2026-07-04 11:54:13
  • Git 提交: 5f11e10
  • 上一版本: v1.0.8

详细提交记录

自上版本 v1.0.8 以来的变更

  • build(build_and_release.py): 补全gh命令的仓库参数 (5f11e10)
  • build(scripts): 优化发布文件收集逻辑并新增目录清理 (a5f9299)

合并的 Pull Requests

  • #5 Add shader-compatible vanilla particle pipeline (by @enzhi-z)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.8+1.20.1.jar (11.27M)
    • MD5: 3a718384c148c239d5d33f5d4a68dc81
    • SHA256: 18a7b25f5ed873f4e35d06857887533241c515709da11b22a0ace1ea01170945
  • nebula-1.0.8+1.21.1.jar (11.28M)
    • MD5: f3cc1b99aa52406389b61db6bb84de6b
    • SHA256: 5f3f9eb5bd7835ee459bc497ad306f36bee74a1a239938cd1fc8e7497fd62a69
1.0.7-1.21.1Релиз1.21.1 · 8 апреля 2026 г.

Nebula v1.0.7

发布信息

  • 发布日期: 2026-04-08 22:28:35
  • Git 提交: 6d1faed
  • 上一版本: v1.0.6

详细提交记录

自上版本 v1.0.6 以来的变更

  • fix: 修复了 Windows 环境下构建脚本不可用的问题 (6d1faed)
  • feat: 添加了 Python 构建脚本 (7953993)
  • chore: 删除Windows平台的构建脚本 (a6d7f8a)
  • feat(build): 添加自动化构建发布脚本 (1b2487a)
  • chore(build): 更新模块版本号 (61744a3)
  • fix(loader): 解决流式加载器压缩数据读取和解压问题 (0f6d522)
  • fix: 修复了粒子采样问题 (6900fd3)
  • feat: 添加构建脚本 (930faa3)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.7+1.20.1.jar (11.26M)
    • MD5: 49124d87b108320f9e600e821f29ff19
    • SHA256: 44d7163e6c5ef37f55ec5822ad593872f1f384c0618fb85d3a34779a32e34b76
  • nebula-1.0.7+1.21.1.jar (11.26M)
    • MD5: cc0a41948a444a0931bc3a2891645264
    • SHA256: 30288bcdbea875ffb0373127a8da8ac0fccb8da2916d7b05bcf5431a55144d8b
1.0.7-1.20.1Релиз1.20.1 · 8 апреля 2026 г.

Nebula v1.0.7

发布信息

  • 发布日期: 2026-04-08 22:28:35
  • Git 提交: 6d1faed
  • 上一版本: v1.0.6

详细提交记录

自上版本 v1.0.6 以来的变更

  • fix: 修复了 Windows 环境下构建脚本不可用的问题 (6d1faed)
  • feat: 添加了 Python 构建脚本 (7953993)
  • chore: 删除Windows平台的构建脚本 (a6d7f8a)
  • feat(build): 添加自动化构建发布脚本 (1b2487a)
  • chore(build): 更新模块版本号 (61744a3)
  • fix(loader): 解决流式加载器压缩数据读取和解压问题 (0f6d522)
  • fix: 修复了粒子采样问题 (6900fd3)
  • feat: 添加构建脚本 (930faa3)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.7+1.20.1.jar (11.26M)
    • MD5: 49124d87b108320f9e600e821f29ff19
    • SHA256: 44d7163e6c5ef37f55ec5822ad593872f1f384c0618fb85d3a34779a32e34b76
  • nebula-1.0.7+1.21.1.jar (11.26M)
    • MD5: cc0a41948a444a0931bc3a2891645264
    • SHA256: 30288bcdbea875ffb0373127a8da8ac0fccb8da2916d7b05bcf5431a55144d8b
1.0.6-1.21.1Релиз1.21.1 · 14 марта 2026 г.

Nebula v1.0.6

发布信息

  • 发布日期: 2026-03-14 19:36:39
  • Git 提交: f90b3c6
  • 上一版本: bv1.2.0

主要更新

  • 修复了小实例导致堆内存爆炸的问题。 Fixed an issue where small animation instances caused Heap Memory exhaustion.
  • 修复了堆外内存浪费。 Optimized Direct Memory usage and eliminated resource waste.

详细提交记录

自上版本 bv1.2.0 以来的变更

  • fix: 修复构建脚本 (f90b3c6)
  • chore: 更新 gradle 配置 (5377863)
  • fix(build): 修复构建脚本问题 (3a9a3e4)
  • chore(build): 更新项目默认版本为 1.21.1 (7a83d01)
  • fix: 修复构建脚本 (64ab366)
  • feat(build): 更新构建脚本以支持新依赖项和优化上传流程 (71f68d8)
  • perf(particles): 优化粒子系统内存分配策略 (aa2e3a2)
  • feat(build): 添加自动化构建发布脚本和环境配置 (8b8daf0)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.6+1.20.1.jar (12M)
    • MD5: ad440c92c6ee3721cb3bbeac2d1c183f
    • SHA256: 84ad8fec75442507f0010cb0f1690a5a59a1361ea73a0513036d230d6ab7ea4b
  • nebula-1.0.6+1.21.1.jar (12M)
    • MD5: 47a3e802bc5c743f4f3306c2164269b9
    • SHA256: 955f22cd68736caac8fba9f6296e43ec8546fcb2dcb91bc3cfb812cffaff4c1c
1.0.6-1.20.1Релиз1.20.1 · 14 марта 2026 г.

Nebula v1.0.6

发布信息

  • 发布日期: 2026-03-14 19:36:39
  • Git 提交: f90b3c6
  • 上一版本: bv1.2.0

主要更新

  • 修复了小实例导致堆内存爆炸的问题。 Fixed an issue where small animation instances caused Heap Memory exhaustion.
  • 修复了堆外内存浪费。 Optimized Direct Memory usage and eliminated resource waste.

详细提交记录

自上版本 bv1.2.0 以来的变更

  • fix: 修复构建脚本 (f90b3c6)
  • chore: 更新 gradle 配置 (5377863)
  • fix(build): 修复构建脚本问题 (3a9a3e4)
  • chore(build): 更新项目默认版本为 1.21.1 (7a83d01)
  • fix: 修复构建脚本 (64ab366)
  • feat(build): 更新构建脚本以支持新依赖项和优化上传流程 (71f68d8)
  • perf(particles): 优化粒子系统内存分配策略 (aa2e3a2)
  • feat(build): 添加自动化构建发布脚本和环境配置 (8b8daf0)

兼容性说明

Minecraft 1.20.1 版本

支持范围: Minecraft 1.20 ~ 1.20.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.92.2+1.20.1
  • Java >=21
  • Mod Menu >=7.2.2
  • YACL >=3.5.0+1.20.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.6.17+1.20.1 (备用光影支持)
  • ReplayMod >=1.20.1-2.6.23 (录像支持)

Minecraft 1.21.1 版本

支持范围: Minecraft 1.21 ~ 1.21.1

必需依赖:

  • Fabric Loader >=0.17
  • Fabric API >=0.110.0+1.21.1
  • Java >=21
  • Mod Menu >=11.0.3
  • YACL >=3.8.1+1.21.1-fabric
  • ThreatenGL >=2.0.4 (光影和渲染支持)

可选依赖:

  • Iris >=1.8.8+1.21.1-fabric (备用光影支持)
  • ReplayMod >=1.21-2.6.23 (录像支持)

技术规格

  • 渲染引擎: GPU-instanced 高性能渲染
  • 粒子格式: NBL 流式压缩传输
  • OpenGL 要求: 4.4+
  • 着色器支持: Compute Shader, SSBO
  • OIT 支持: 顺序独立透明度渲染

文件清单

本次发布包含以下文件：

  • nebula-1.0.6+1.20.1.jar (12M)
    • MD5: ad440c92c6ee3721cb3bbeac2d1c183f
    • SHA256: 84ad8fec75442507f0010cb0f1690a5a59a1361ea73a0513036d230d6ab7ea4b
  • nebula-1.0.6+1.21.1.jar (12M)
    • MD5: 47a3e802bc5c743f4f3306c2164269b9
    • SHA256: 955f22cd68736caac8fba9f6296e43ec8546fcb2dcb91bc3cfb812cffaff4c1c

Комментарии

Загружаем…