级联

Cascade

一个面向 NeoForge 和 Fabric 上 Minecraft 的代码优先视觉特效与序列编排库。

Cascade 让你的模组可以直接从服务端代码播放高性能视觉特效。特效会流式传输到附近的客户端，并在本地进行模拟与渲染。不会生成任何实体，也不会向世界存档写入任何内容。

Cascade 是一个开发者库。 单独安装它不会添加任何玩法内容。

演示

查看 Cascade 的实际效果：

https://www.youtube.com/watch?v=pa19m-STock

---

快速示例

Vfx.emitter()
    .shape(ShapeSpec.sphere(0.5f))
    .count(200)
    .lifetime(40)
    .speed(0.2f)
    .gradient(Easings.LINEAR, 0xFFCC33, 0xFF3300)
    .play(level, pos);

---

特性

粒子系统

• 可配置的发射器形状
• 尺寸、透明度、速度和颜色曲线
• 多段颜色渐变
• 碰撞与软粒子
• 拖尾与子发射器
• 方块、物品、网格和自定义粒子

模拟

• 重力与阻力
• 旋度噪声
• 旋涡与吸引子
• Boids 群集
• 确定性模拟核心

渲染

• 光束
• 能量穹顶
• 相机抖动
• 动态光照投射
• 光线步进有向距离体积
• HUD 层粒子
• 仅影响 Cascade 特效的选择性泛光

序列编排

• 延迟
• 并行分支
• 可组合的特效时间线

可扩展性

• 数据包定义的 JSON 特效
• 用于自定义粒子行为的注册 API
• 可选的 GPU 常驻后端，适用于极大量粒子
• 在 NeoForge 和 Fabric 上均无需 Mixin
• 经过单元测试的模拟核心

---

安装

添加 Maven 仓库：

repositories {
    maven {
        url = uri("https://raw.githubusercontent.com/ChocoBooyy/maven/main")
    }
}

添加与你 Minecraft 版本匹配的依赖：

dependencies {
    implementation("dev.chocoboy.cascade:cascade-neoforge:1.0.0+26.1")
    // 或：
    // implementation("dev.chocoboy.cascade:cascade-fabric:1.0.0+1.21.1")
}

---

文档

Wiki 涵盖了所有特性，包括：

• 入门指南
• 粒子发射器
• 序列编排
• 行为
• 渲染
• 数据包特效
• 自定义扩展
• 能力与限制（确切说明哪些功能在哪里可用）

---

环境要求

Minecraft	Java	Cascade 版本
26.1	25	1.0.0+26.1
1.21.1	21	1.0.0+1.21.1

支持：

• NeoForge
• Fabric + Fabric API

---

许可证

MIT