卡斯凯德

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 均无混入
• 经过单元测试的模拟核心

---

安装方式

添加 Maven 仓库：

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

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

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

---

文档

维基百科涵盖了所有功能，包括：

• 快速入门
• 粒子发射器
• 序列化
• 行为
• 渲染
• 数据包效果
• 自定义扩展
• 功能与限制（明确说明哪些功能在何处可用）

---

运行环境要求

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