Cascade

A code-first visual effects and sequencing library. Particle emitters, beams, volumes, bloom, and choreographed timelines for other mods to build on.
2026-07-08_13.35.46.png

2026-07-08_13.35.46.png

2026-07-08_13.35.24.png

2026-07-08_13.35.24.png

2026-07-08_13.36.18.png

2026-07-08_13.36.18.png

2026-07-08_13.36.05.png

2026-07-08_13.36.05.png

video thumbnail

Description

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

The Cascade Team

profile avatar
  • 1
    Followers
  • 5
    Projects
  • 37.4K
    Downloads
Donate

More from ChocoBoyView all

  • Create: Henry project image

    Create: Henry

    • 33.5K
    • Mods

    A create add-on with Create: Dreams n Desires features and more.

    • 33.5K
    • July 1, 2026
    • Mods
    • +4
  • Create: Circuits project image

    Create: Circuits

    • 2.8K
    • Mods

    Create addon that adds redstone logic gates, signal arithmetic and memory elements.

    • 2.8K
    • May 22, 2026
    • Mods
    • +1
  • Create: Processing project image

    Create: Processing

    • 656
    • Mods

    A create addon that adds new type of processing.

    • 656
    • April 18, 2026
    • Mods
  • HenryCraft project image

    HenryCraft

    • 890
    • Modpacks

    SteamPunk themed modpack based around create, space and food

    • 890
    • October 21, 2025
    • Modpacks
    • +4
  • Create: Henry project image

    Create: Henry

    • 33.5K
    • Mods

    A create add-on with Create: Dreams n Desires features and more.

    • 33.5K
    • July 1, 2026
    • Mods
    • +4
  • Create: Circuits project image

    Create: Circuits

    • 2.8K
    • Mods

    Create addon that adds redstone logic gates, signal arithmetic and memory elements.

    • 2.8K
    • May 22, 2026
    • Mods
    • +1
  • Create: Processing project image

    Create: Processing

    • 656
    • Mods

    A create addon that adds new type of processing.

    • 656
    • April 18, 2026
    • Mods
  • HenryCraft project image

    HenryCraft

    • 890
    • Modpacks

    SteamPunk themed modpack based around create, space and food

    • 890
    • October 21, 2025
    • Modpacks
    • +4