Jester’s Spell Framework

💀 What is this?

Jester’s Spell Framework is a modular, JSON-based spell system that lets you create complex abilities without writing Java code.

Build spells using:

• 🎯 targeting logic
• 🧍 filters (ally / enemy / self)
• 🔍 conditions (health, mana, effects)
• 💥 chained and conditional effects

All through simple JSON files.

⚙️ Core Philosophy

Spells should be data, not code.

✔ No recompiling
✔ Easy balancing
✔ Modpack-friendly
✔ Expandable

🧠 Features

🎯 Advanced Targeting

• forward_box → directional skillshots
• area_around_caster → aura effects
• area_around_target → explosion on target
• area_on_hit_position → impact AoE
• self → self-cast

🧍 Target Filtering

Control who gets hit:

• all
• self
• allies
• enemies

🔍 Target Predicates (Smart Targeting)

Only affect entities that match conditions:

• ❤️ health thresholds
• 🔵 mana thresholds
• 🧪 has / missing effects
• 🧍 player-only checks
• 🔥 on-fire checks

Examples:

• Heal only low HP allies
• Buff only players missing haste
• Damage only burning enemies

💥 Effects System

Mix multiple effects into one spell:

⚔️ Damage & Combat

• damage_target
• ignite_target
• knockback_target

🧪 Buffs & Debuffs

• apply_mob_effect_target
• remove_mob_effect_target
• cleanse_target

❤️ Healing & Defense

• heal_target
• shield_target
• remove_shield_target

🔵 Resource System (Mana)

• resource_restore_target
• resource_drain_target
• resource_transfer_target
• resource_leech_target

🧩 Conditional Effects

Run effects only when conditions are met:

Examples:

• 💀 Execute enemies below 30% HP
• 🔵 Restore mana only if low
• 🧪 Apply buffs only if missing

🔗 Nested Effects

• Chain multiple effects
• Build layered spells
• Combine AoE + conditions + multi-effects

🧪 Built-in Validation

• ❌ Invalid configs are caught at load
• ⚠️ Clear error messages
• 🛡 Prevents broken spells

🛡️ Shield System

Uses absorption hearts as shields:

• ➕ shield_target → add shield
• ➖ remove_shield_target → remove shield

🧰 Included Tooling

🖥️ HTML Spell Builder

Create spells visually:

✔ Checkboxes for effects
✔ Input fields for values
✔ Built-in validation structure
✔ JSON preview
✔ 📥 Download ready-to-use files

Perfect for:

• modpack creators
• rapid iteration
• testing ideas