Spell Engine

Spell Engine представляет собой библиотеку для создания магических заклинаний, предоставляющую игрокам полноценную систему их применения с книгами заклинаний, визуальными эффектами и интеграцией с оружием.

Установка

Рекомендуется использовать CurseForge app для автоматического разрешения всех зависимостей.

Обязательные моды

• Cloth Config
• Player Animator
• Spell Power Attributes

Дополнительно для Fabric:

• Fabric API
• Trinkets (слотовый мод)

Дополнительно для NeoForge:

• Curios API (слотовый мод)

Навыки для оружия

Набор боевых умений для разных типов оружия с уникальными особенностями:

• детектирование столкновений
• учёт инерции и скольжения
• качественные анимации

По умолчанию эти умения назначены для контента серии RPG и автоматически применяются к стороннему и ванильному оружию на основе идентификаторов или тегов (конфиг: config/spell_engine/weapon_fallback.json).

Управление заклинаниями

• Заклинания можно назначать на любое оружие с автоматическим подбором совместимости.
• Урон зависит от атрибутов Spell Power.
• Определение заклинаний через JSON с поддержкой горячей перезагрузки и синхронизации по сети.
• Система контейнеров для заклинаний с прокси режимом, слотами экипировки и динамическим разрешением.
• Универсальное сопоставление паттернов для тегов, регулярных выражений и точных совпадений.
• Программное создание заклинаний с помощью SpellBuilder и SpellGenerator.
• Механики заклинаний включают типы (активные, пассивные, модификаторы), режимы кастования (мгновенный, заряженный, каналируемый), 14+ типов триггеров, различные цели и способы доставки, а также сложную логику условий и затрат.

Аудио и визуальные эффекты

• Продвинутый звуковой движок с разнообразными звуками начала, цикла, завершения и попадания.
• Сложная система частиц с формами, следованием за сущностями и масштабированием.
• Кастомные модели предметов и блоков для снарядов и эффектов с поддержкой BlockBench.
• Анимации игрока на всех этапах заклинания с контролем угла наклона и поддержкой дальнобойного оружия.
• Динамическое освещение для магических эффектов (LambDynamicLights).
• Настраиваемое отображение лучей с цветами, текстурами и эффектами течения.
• Визуализация областей действия с индикаторами на земле и масштабируемыми частицами.

Игровые функции

• Выбор и применение заклинаний отображается на HUD с полной настройкой игрока.
• Удобства: автоматический сброс кастования, предсказание клиента, умное наведение.
• Spell Binding Table для добавления заклинаний в оружие и создания книг заклинаний.
• Система свитков с генерацией вкладок творчества и интеграцией в лут подземелий.
• Интеграция с экипировкой: книги заклинаний, слоты аксессуаров (Trinkets/Accessories), автоматическое определение оружия.
• Зачарование Spell Infinity с поддержкой настраиваемых тегов предметов.
• Команда /spell_cooldowns для администрирования и отладки.
• Расширенная система добычи с функцией spell_bind_randomly для динамического назначения заклинаний.

Для разработчиков и интеграция модов

• Широкая совместимость с модами Better Combat, Combat Roll, FTB Teams, Shoulder Surfing и другими.
• Разветвлённая система событий для кастования, исцеления и жизненного цикла снарядов.
• Регистрация пользовательских обработчиков доставки и эффектов при попадании.
• Система предикатов для сложных условий выбора целей.
• Оптимизации производительности: пакетная обработка, планирование, предсказание на клиенте.
• Фреймворк генерации данных для программного создания и проверки заклинаний.
• Поддержка платформ Fabric и NeoForge с единым API.