Spell Engine

Discord

SpellEngine is library mod (also known as an API) that lets developers create magic spells using, providing players with a complete spell-casting system including spell books, visual effects, and weapon integration.

📦 Installation

🎁 Installation via Modrinth app is strongly recommended, to automatically resolve all required mods.

Required

- Cloth Config - Player Animator - Spell Power Attributes

Additionally on Fabric: - Fabric API - slot mod: Trinkets or Accessories

Additionally on NeoForge: - Forgified Fabric API - slot mod: Accessories

⭐️ Content made with Spell Engine

Archers

Paladins

Wizards

Rogues

Skill Tree

Jewelry

Relics

Arsenal

Armory

🤝 Made by partners

Anarchy

Mercenaries

Oathsworn

Archer Expansion

Elemental Wizards

Berserker

Witcher

Forcemaster

Death Knights

📦 Built-in content

🗡️ Weapon skills 🪓

Explore a variety of melee attack skills, each of them designed for a specific weapon type, with unique features: - detailed collision detection - momentum and sliding - fancy animations

RPG Series content mods come with these skills assigned by default.

Automatically assigned to third-party and vanilla weapons, based on item id or item tag membership. (Config file: `config/spell_engine/weapon_fallback.json`)

🪄️ API Features

Data driven API - 🗡️ Spells can be assigned to any weapon (data driven with automatic weapon compatibility) - 🔮 Spells deal damage based on Equipment Sets entity attributes - ✍️ Spells defined in JSON format with hot-reloading and network synchronization - 📦 Spell Container System with proxy mode, equipment slots, and dynamic spell resolution - 🔄 Universal pattern matching for tags, regex, and exact matches across all spell properties - 🛠️ Programmatic spell generation with SpellBuilder and SpellGenerator for mod developers - ⚙️ Spells have a comprehensive set of mechanical behaviours: - Equipment Sets: Active (casted), Passive (triggered), Modifier (spell-modifying) - Equipment Sets: Instant, charged, channeled, with configurable haste effects - Equipment Sets: 14+ trigger types (melee, arrow, spell, damage, evasion, roll, etc.) with conditional logic - Equipment Sets: Aim, Beam, Area, Caster, None, FromTrigger - with caps, conditions, and health-based limits - Equipment Sets: Direct, Projectile, Meteor, Cloud, ShootArrow, StashEffect, Custom - with delays and multi-placement - Equipment Sets: Homing, ricochet, bounce, pierce, chain reactions, divergence, custom hitboxes - Equipment Sets: Damage, Heal, StatusEffect, Fire, Teleport, Spawn, Cooldown, Aggro, Custom - Equipment Sets: Target modifiers, impact filters, chance-based execution, entity type conditions - Equipment Sets: Exhaust, items/runes, cooldowns, durability, status effect consumption, with batching - Equipment Sets: Set bonuses providing spells, attributes, and special abilities

Fancy audio and visuals - 🔈 Advanced sound system: casting start/loop, release, impact, travel sounds with randomization - ✨ Sophisticated particle system with shapes, entity following, scaling, and custom magical particles - 🎨 Custom Item/Block models for projectiles, status effects, and spell clouds with BlockBench support - 🤸 Player animations at all spell stages with pitch control and ranged weapon animation support - 💡 Dynamic lighting integration (LambDynamicLights) for magical illumination - 🌈 Customizable beam rendering with colors, textures, width, and flow effects - 📍 Area effect visualization with ground indicators and range-scaled particles

In game features - 🔧 Spell selection and casting visible on HUD (fully player configurable) - 😌 QoL features: automatic spell cast release, client prediction, smart targeting - ⛓️ Spell Binding Table for adding spells to weapons and creating spell books - 📜 Spell Scroll system with creative tab generation and dungeon loot integration - 🎒 Equipment integration: Spell books, trinket slots (Trinkets/Accessories), automatic weapon detection - ⚡ Spell Infinity enchantment with configurable item tag support - 🎮 Commands: `/spell_cooldowns` for server administration and debugging - 💰 Advanced loot system with `spell_bind_randomly` function for dynamic spell assignment

Developer & Mod Integration - 🔌 Extensive mod compatibility: Better Combat, Combat Roll, FTB Teams, Shoulder Surfing, and more - 📊 Comprehensive event system for spell casting, healing, and projectile lifecycle - 🏗️ Custom handler registration for delivery methods and impact actions - 🎯 Entity predicate system for complex targeting conditions - 🔧 Performance optimizations: batching, scheduling, client-side prediction - 📝 Data generation framework for programmatic spell creation and validation - 🌐 Multi-platform support (Fabric & NeoForge) with unified API