cascade

Cascade

Библиотека визуальных эффектов и секвенсинга с приоритетом кода для Minecraft на NeoForge и Fabric.

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);

Возможности

Система частиц

• Настраиваемые формы эмиттеров
• Кривые размера, прозрачности, скорости и цвета
• Многоступенчатые цветовые градиенты
• Коллизии и мягкие частицы
• Трейлы и суб-эмиттеры
• Частицы блоков, предметов, мешей и кастомные частицы

Симуляция

• Гравитация и сопротивление
• Curl noise
• Вихри и аттракторы
• Стайное поведение (boids)
• Детерминированное ядро симуляции

Рендеринг

• Лучевые эффекты
• Энергетические купола
• Тряска камеры
• Динамическое освещение
• Raymarched SDF-объёмы
• Частицы на слое HUD
• Избирательный bloom, влияющий только на эффекты Cascade

Секвенсинг

• Задержки
• Параллельные ветви
• Компонуемые таймлайны эффектов

Расширяемость

• JSON-эффекты, определяемые датапаком
• API регистрации для кастомного поведения частиц
• Опциональный GPU-бэкенд для экстремально больших количеств частиц
• Без миксинов как на NeoForge, так и на Fabric
• Юнит-тестируемое ядро симуляции

Установка

Добавьте 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")
    // or:
    // implementation("dev.chocoboy.cascade:cascade-fabric:1.0.0+1.21.1")
}

Документация

Вики охватывает все возможности, включая:

• Начало работы
• Эмиттеры частиц
• Секвенсинг
• Поведения
• Рендеринг
• Эффекты датапаков
• Кастомные расширения
• Возможности и ограничения (что именно где работает)

Требования

Поддерживается:

• NeoForge
• Fabric + Fabric API

Лицензия

MIT