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&quot;)
    }
}

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