Хотите создавать крутые эффекты частиц в виде конусов, кубов, сфер и вихрей, но не знаете как? Этот мод для вас! В основном это утилита для разработчиков, но игроки могут экспериментировать с командами, особенно чтобы протестировать эффекты перед их реализацией в коде. Мод полностью серверный — клиентам он не нужен. Вдохновлён плагином EffectLib.
Доступные эффекты:
- [3D] Анимированная сфера, сфера, кубоид, вихрь, конус
- [2D] Дуга, линия, анимированный круг, цветные и чёрно-белые изображения
Мод находится в альфа-стадии: между версиями возможны изменения или поломки (хотя автор старается их избегать). Пока доступна лишь малая часть запланированных эффектов, а документация в основном сводится к javadoc, но в будущем планируется создать вики. Версия для Forge/NeoForge может появиться позже, после доведения Fabric/Quilt версии до бета-стадии.
Лучше всего использовать мод с другими игроками на сервере. Для скидки на Nodecraft используйте код EMALIGHTDEV.
Как создавать эффекты? Все эффекты находятся в пакете effects. Создайте новый объект эффекта или используйте метод-билдер, аналогично свойствам блоков. Затем активируйте эффект с помощью метода #run():
- Через конструктор: Effect effect = new Effect(...); effect.runFor(5);
- Через билдер: Effect effect = Effect.builder(...).particles(10).build(); effect.setIterations(5*20); effect.run();
При использовании билдера всегда указывайте мир, эффект частиц и исходную позицию — они обязательны для работы анимации.
Как управлять анимацией? У каждого эффекта есть геттеры и сеттеры для изменения настроек перед запуском. В метод run/runFor можно передать лямбду, выполняемую каждый тик активности эффекта. Подробности — в javadoc конструктора эффекта.
Как использовать команды? Используйте pal или particleanimationlib с автодополнением для создания эффектов. Документация команд ограничена именами аргументов, поэтому лучше смотреть в соответствующие классы эффектов. Примечание: для параметров вроде вращения используйте значения типа "x.5", так как игра воспринимает их как позиции. Можно вводить double (например, "2.0").
Для разработчиков: Добавьте библиотеку как зависимость в build.gradle:
- Репозиторий: maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }
- Зависимость: modImplementation "maven.modrinth:particleanimationlib:<version>"
Версию берите со страницы версий на Modrinth.
Основан на плагине EffectLib от команды elBukkit — эффекты взяты оттуда и адаптированы для моддинга, иногда с добавлением функциональности. Лицензия: MIT.
