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("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

Supports:

• NeoForge
• Fabric + Fabric API

License

MIT