Spell Engine

Мод Spell Engine для Minecraft — библиотека для создания заклинаний и магии

Spell Engine — это модуль-библиотека (API), предоставляющий разработчикам полный набор инструментов для создания магических заклинаний. Проект включает в себя систему управления заклинаниями через книги, визуальные эффекты и интеграцию с оружием. Библиотека поддерживает создание заклинаний в формате JSON с возможностью горячего обновления и синхронизации сети, а также автоматическое определение совместимости с любым оружием. Встроенный контент предлагает различные ударные навыки ближнего боя с уникальными анимациями и физикой.

Основная концепция и встроенный контент

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

Разработчики могут использовать библиотеку для создания собственных RPG-серий. Встроенный контент уже включает в себя набор навыков ближнего боя для различных видов оружия. Каждый навык уникален и адаптирован под конкретное оружие, предлагая такие функции, как детальное обнаружение столкновений, инерция, скольжение и сложные анимации. Эти навыки автоматически назначаются на оружие сторонних модов и ванильные предметы на основе их ID или тегов, что позволяет легко расширять существующие сборки.

Система навыков оружия

Библиотека предоставляет широкий спектр навыков ближнего боя (melee attack skills), каждый из которых разработан для конкретного типа оружия.

Ключевые особенности встроенных навыков:

• Физика и анимация: Реализованы сложные механики, включая детекцию столкновений, сохранение импульса и скольжение. Анимации оружия выглядят детально проработанными.
• Автоматическое назначение: Навыки автоматически применяются к третьим лицам и ванильному оружию. Система проверяет ID предмета или его тег.
• Настройка: Назначение навыков можно настраивать через файл конфигурации config/spell_engine/weapon_fallback.json.

Эти навыки служат базой для RPG-серий, которые поставляются с предустановленными умениями, но могут быть адаптированы для любого другого предмета.

Функционал API для разработчиков

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

Создание и управление заклинаниями:

• Заклинания определяются в формате JSON, что позволяет легко редактировать их без recompilation кода.
• Поддерживается горячее обновление (hot-reloading) и синхронизация между клиентами и сервером.
• Система контейнеров заклинаний (Spell Container System) позволяет управлять ими через слоты экипировки или прокси-режим.
• Универсальное сопоставление паттернов поддерживает теги, регулярные выражения и точные совпадения для всех свойств заклинаний.

Механика заклинаний:

• Типы: Активные (вызываемые), пассивные (срабатывающие) и модификаторы.
• Режимы применения: Мгновенные, заряжаемые, каналлизируемые с настраиваемыми эффектами ускорения.
• Система триггеров: Более 14 типов срабатывания (ближний бой, стрелы, магические эффекты, уклонение и т.д.) с логикой условий.
• Целеуказание: Выбор целей (целенаправленный, луч, зона, от триггера) с лимитами и условиями здоровья.
• Доставка: Прямое воздействие, снаряды, метеориты, облака, стрельба стрелами и пользовательские методы.
• Снаряды: Поддержка прицеливания, отскока, пробития, цепных реакций и кастомных хитбоксов.

Интеграция и события:

• Поддерживается обширная совместимость с другими модами, такими как Better Combat, Combat Roll, FTB Teams и Shoulder Surfing.
• Комплексная система событий для жизненного цикла заклинаний, лечения и снарядов.
• Предикатная система сущностей для сложных условий таргетинга.
• Оптимизация производительности через батчинг и клиентское предсказание.

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

Библиотека включает продвинутую систему для создания магических визуалов и звуков, что делает заклинания оживленными и атмосферными.

Визуальные эффекты:

• Частицы: Продвинутая система частиц с формами, следованием за сущностями, масштабированием и кастомными магическими частицами.
• Освещение: Интеграция с LambDynamicLights для динамического освещения заклинаний.
• Модели: Поддержка кастомных моделей предметов и блоков для снарядов и облаков заклинаний через BlockBench.
• Лучи: Настраиваемое рендеринг лучей с цветами, текстурами, шириной и эффектами потока.
• Зоны: Визуализация зон действия с индикаторами на земле и частицами, масштабируемыми по радиусу.

Аудио:

• Продвинутая звуковая система с отдельными звуками для начала заклинания, цикла, завершения, удара и полета снаряда.
• Поддержка случайности в воспроизведении звуков для разнообразия.

Анимации игрока:

• Анимации игрока на всех стадиях заклинания с контролем высоты звука (pitch).
• Поддержка анимации оружия на расстоянии (ranged weapon animation support).

Ин-игра функции и инструменты

Для удобства игроков и администраторов предусмотрены различные инструменты и улучшения качества жизни (QoL).

Управление и интерфейс:

• Выбор и применение заклинаний отображаются на HUD, и их поведение полностью настраивается игроком.
• Таблица связывания заклинаний (Spell Binding Table): Позволяет добавлять заклинания к оружию и создавать книги заклинаний.
• Система свитков: Генерация свитков заклинаний для творческого режима и интеграция с лутом в подземельях.

Экипировка и лут:

• Интеграция с книгами заклинаний, слотами для украшений (Trinkets/Accessories).
• Автоматическое обнаружение оружия.
• Магическое проклятие "Spell Infinity" с поддержкой пользовательских тегов предметов.
• Продвинутая система лута с функцией spell_bind_randomly для динамического назначения заклинаний.

Команды:

• Команда /spell_cooldowns доступна для администрирования сервера и отладки.

Примеры проектов на базе Spell Engine:
Библиотека активно используется для создания разнообразных RPG-классов и расширений, таких как Archers, Paladins and Priests, Wizards, Rogues and Warriors, Skill Tree, Jewelry, Relics, Arsenal, Armory, Berserker, Witcher, Forcemaster, Death Knights, Mercenaries, Oathsworn, Elemental Wizards, Archer Expansion и Anarchy.

Автор: ZsoltMolnarrr · Лицензия: GPL-3.0-only