HomeJavaModsINSANE MAGIC
✨ InsaneMagic ✨ A Modular Spell-Crafting System for Paper 1.21.1

Players don't just cast spells — they design them. Chain together scribes on a spellbook to create unique combinations of delivery methods, effects, and augments. Every spell is player-authored, fully configurable, and backed by a mana economy, a soul energy network, and a multi-block infusion crafting system.

Platform: Paper 1.21.1+ | Dependencies: None


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

THE SCRIBE SYSTEM — BUILD YOUR OWN SPELLS

InsaneMagic's core innovation is the Scribe System. Spells aren't pre-made — players construct them by chaining together three types of scribes:

• Form — How the spell is delivered (Projectile, Ray, Touch, Self) • Effect — What the spell does on hit (Harm, Heal, Break, Explosion, Ignite, Freeze, Teleport) • Augment — Modifies the preceding effect or form (Amplify, AoE, Split, Extend Time)

A spell is always structured as: [Form] → [Form Augments] → [Effect + Augments] → [Effect + Augments] → ...

EXAMPLE SPELLS:

• Magic Missile — Projectile → Harm — Fires a bolt that deals 1 heart of damage
• Empowered Blast — Projectile → Harm → Amplify → Amplify — Bolt deals 1.5 hearts (amplified 2x)
• Firestorm — Projectile → Split → Ignite → Amplify → Harm — 2 splitting projectiles that ignite and damage
• Healing Touch — Touch → Heal → Amplify — Touch a player/mob to restore health • Blink — Self → Teleport — Instant forward teleport
• Frozen Volley — Projectile → Split → Split → Freeze → Amplify — 3 projectiles that freeze and slow enemies
•Mining Ray — Ray → Break → AoE — A laser beam that breaks blocks in a 3x3 area
The possibilities are as deep as your imagination — and your mana pool.

upload_2026-2-27_0-37-34.png

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

FORMS — CHOOSE YOUR DELIVERY

Every spell starts with a Form that determines how it reaches its target.

⚡ Projectile Launches a physical energy bolt that flies through the air. When it hits an entity or block, the effects trigger. Supports the Split augment to fan multiple projectiles outward in a cone. Range increases with Amplify.

Ray An instant hitscan beam — point and fire. The ray immediately resolves at whatever the caster is looking at. Perfect for precision sniping.

✋ Touch Melee-range delivery. Right-click an entity to apply effects directly. Great for healing allies or close-quarters combat.

Self Applies effects to the caster themselves. Essential for self-heals, self-buffs, and teleport spells.

[​IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

EFFECTS — WHAT YOUR SPELL DOES

Effects are the payload of the spell. Chain multiple effects for devastating combos.

⚔️ Harm — Deals 2 HP (1 heart) of magical damage. +25% damage per Amplify.
❤️ Heal — Restores 2 HP (1 heart) to the target. +0.5 HP per Amplify.
Explosion — Creates an explosion at the impact point. Amplify increases blast radius.
⛏️ Break — Breaks blocks at the target location. AoE augment expands area.
Ignite — Sets the target on fire for 4 seconds. Extend Time increases duration.
❄️ Freeze — Freezes the target and applies Slowness. Amplify increases Slowness level.
Teleport — Teleports the caster to the spell's target location. +5 blocks range per Amplify.

[​IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AUGMENTS — CUSTOMIZE EVERY DETAIL

Augments modify the scribe immediately before them. Stack them for compounding effects.

Amplify Increases the potency of the preceding effect by 25% per stack. Also increases the total spell's mana cost by 25% (compounded). Stack 5 amplifies on a Harm spell? That's 2.5x base damage — but at 3x the mana cost.

AoE (Area of Effect) Expands the effect to hit multiple targets or a wider area. Level 1 = 3x3, Level 2 = 5x5, Level 3 = 7x7. Hard-capped at level 3 to prevent lag.

Split Applied to the Form. Creates additional projectiles that fan outward. 1 Split = 2 bolts, 2 Splits = 3 bolts. Each bolt carries the full effect chain.

⏳ Extend Time Increases the duration of timed effects (Ignite, Freeze, and similar). Stacks multiplicatively.

[​IMG]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SPELLBOOKS — YOUR MAGICAL ARSENAL

Spells are stored on Spellbooks — physical items that players carry and use. Three tiers, each crafted at the Enchanting Apparatus:

Tier 1 — Novice Spellbook — 1 spell slot, max 3 scribes per spell. Free to craft. Tier 2 — Apprentice Spellbook — 5 spell slots, max 5 scribes per spell. Costs 100 Soul. Tier 3 — Archmage Spellbook — 10 spell slots, max 10 scribes per spell. Costs 500 Soul.

• Left-Click the spellbook to open the Spell Selection GUI and choose/edit spells • Right-Click to cast the currently active spell • Scroll through spell slots for quick-switching in combat

Spells are stored directly on the item using Persistent Data Containers, so they survive restarts, inventories, chests — no external databases needed.
upload_2026-2-27_0-39-25.png

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

MANA SYSTEM

Every spell costs mana. Designed for strategic resource management:

• Max Mana: 100 (configurable) • Regen: 1 per second (configurable) • Display: Real-time action bar showing "Mana: 85/100" • Amplify Tax: Each Amplify increases the entire spell's mana cost by 25%, compounded. A base 15-mana spell with 3 Amplifies costs about 30 mana.

When a player runs out of mana, casting fails with an audio cue and a red "Not enough mana!" message.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

SOUL NETWORK — HARVEST MAGICAL ENERGY

Soul is the crafting currency that powers the Enchanting Apparatus. Two custom blocks generate it:

Soul Conduit Drains life energy from nearby growing crops. Place it near a farm, and every time a crop grows within 4 blocks, the owner earns 50 Soul. The owner must be within 10 blocks. Particle trails pulse from the conduit toward connected Siphons.

Soul Siphon Absorbs essence from mob deaths within a 5-block radius. Different mobs yield different amounts:

• Zombie — 5 Soul
• Skeleton — 5 Soul
• Creeper — 8 Soul
• Witch — 10 Soul
• Enderman — 15 Soul
• Blaze — 12 Soul
• Evoker — 20 Soul
• Warden — 100 Soul
• Ender Dragon — 200 Soul
• ...and 20+ more configurable mobs

Soul is stored in Soul Jars (capacity: 500) and spent at the Enchanting Apparatus.

Both blocks emit ambient soul particles — siphons have rising soul wisps, conduits pulse glowing trails toward nearby siphons, making the energy network visually alive.

soul jars must be in off hand on main hand to gain souls
upload_2026-2-27_0-40-59.png

upload_2026-2-27_0-41-21.png

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚗️ ENCHANTING APPARATUS — MULTI-BLOCK CRAFTING

A multi-block structure for crafting magical items:

• 1 Infusion Table (center) — place the base ingredient here • Multiple Magic Bases (pedestals around it) — place recipe ingredients on these

Items placed on tables and bases appear as floating, physics-locked entities hovering above the block — a polished visual effect. Right-click to place/take items.

When the correct ingredients are placed and the player has enough Soul, right-clicking the Infusion Table begins the craft. Items are consumed and the result appears.

WARNING: Disturb a ritual in progress and the apparatus EXPLODES (power 12.0 — stronger than TNT). Don't touch it during crafting!

upload_2026-2-27_0-42-20.png
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ FULLY CONFIGURABLE

Server admins have full control through config.yml:

• Mana — max pool, regen rate
• Spell Costs — per-scribe mana costs for every form, effect, and augment
• Amplify Scaling — mana multiplier and power bonus per amplify level
• Spellbook Tiers — slots and max scribes per tier
• Soul Values — per-mob soul yields, conduit ranges, siphon radii
• Recipe Costs — soul cost for each apparatus recipe
• Scribe Unlocks — material and amount to unlock each scribe at the Scribe Table
upload_2026-2-27_0-42-20.png • Infusion Settings — explosion toggle and power

Example:

Make Harm cost 20 mana and require 5 diamonds to unlock
spells.costs.effects.harm: 20 scribe-unlocks.harm.material: DIAMOND scribe-unlocks.harm.amount: 5

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ COMMANDS

/magic give [tier] — Give yourself a spellbook (Novice/Apprentice/Archmage)
/magic mana max
/magic mana set amount
/magic mana regen amound
/magic enchanter recipes
/magic table recipes
/magic

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WHY INSANEMAGIC?

True Spell Crafting Unlike other magic plugins that give you a static list of pre-built spells, InsaneMagic lets players design their own spells from modular components. The scribe system creates thousands of unique combinations from just 14 scribes.

⚖️ Balanced by Design The Amplify system creates natural trade-offs: more power = more mana. Five amplifies make your Harm spell devastating, but it costs 3x the mana. Players must think strategically.

Zero Dependencies Runs on vanilla Paper with no external dependencies. No ProtocolLib, no Vault, no Citizens. Just drop the jar in your plugins folder.

Immersive Progression Players unlock scribes by bringing materials to the Scribe Table, craft better spellbooks at the Enchanting Apparatus, and farm Soul from crops and mobs. Every step feels earned.

️ Multi-Block Structures The Enchanting Apparatus with floating item displays and Soul Conduit/Siphon particle networks make bases look and feel magical, not just functional.

Server-Friendly • Mana regen is a single lightweight timer (1 tick/second) • AoE hard-capped at level 3 to prevent lag • Soul blocks only tick when their chunk is loaded • Floating items use minimal stabilization tasks • SQLite database with automatic cleanup

100% Configurable Every number in the plugin — mana costs, damage values, soul yields, unlock materials, spellbook limits — is exposed in the config.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

INSTALLATION

  1. Download InsaneMagic-1.0.0.jar
  2. Place it in your server's plugins/ folder
  3. Restart the server
  4. Edit plugins/InsaneMagic/config.yml to customize
  5. Use /magic give to get a spellbook and start crafting spells!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

InsaneMagic — because magic should be crafted, not memorized.

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

INSANE MAGIC is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 33 times (via Spigot). Download it and open it directly in the game.

Explore more