Cascade
A code-first visual effects and sequencing library for Minecraft on NeoForge and Fabric.
Cascade lets your mod play high-performance visual effects directly from server-side code. Effects are streamed to nearby clients, where they are simulated and rendered locally. Nothing is spawned as an entity, and nothing is saved to the world.
Cascade is a developer library.
Installing it by itself adds no gameplay content.
Demo
See Cascade in action:
https://www.youtube.com/watch?v=pa19m-STock
Quick Example
Vfx.emitter()
.shape(ShapeSpec.sphere(0.5f))
.count(200)
.lifetime(40)
.speed(0.2f)
.gradient(Easings.LINEAR, 0xFFCC33, 0xFF3300)
.play(level, pos);
Features
Particle System
- Configurable emitter shapes
- Size, alpha, velocity, and color curves
- Multi-stop color gradients
- Collision and soft particles
- Trails and sub-emitters
- Block, item, mesh, and custom particles
Simulation
- Gravity and drag
- Curl noise
- Vortices and attractors
- Boids flocking
- Deterministic simulation core
Rendering
- Beams
- Energy domes
- Camera shake
- Dynamic light casting
- Raymarched signed-distance volumes
- HUD-layer particles
- Selective bloom that only affects Cascade effects
Sequencing
- Delays
- Parallel branches
- Composable effect timelines
Extensibility
- Datapack-defined JSON effects
- Registration API for custom particle behaviors
- Optional GPU-resident backend for extremely large particle counts
- Mixin-free on both NeoForge and Fabric
- Unit-tested simulation core
Installation
Add the Maven repository:
repositories {
maven {
url = uri("" rel="noopener nofollow" target="_blank">https://raw.githubusercontent.com/ChocoBooyy/maven/main")
}
}
Add the dependency matching your Minecraft version:
dependencies {
implementation("dev.chocoboy.cascade:cascade-neoforge:1.0.0+26.1")
// or:
// implementation("dev.chocoboy.cascade:cascade-fabric:1.0.0+1.21.1")
}
Documentation
The wiki covers every feature, including:
- Getting Started
- Particle emitters
- Sequencing
- Behaviors
- Rendering
- Datapack effects
- Custom extensions
- Capabilities & Limits (exactly what works where)
Requirements
| Minecraft |
Java |
Cascade Version |
| 26.1 |
25 |
1.0.0+26.1 |
| 1.21.1 |
21 |
1.0.0+1.21.1 |
Supports:
- NeoForge
- Fabric + Fabric API
License
MIT