Iron's Spell Tweaker GUI

Quick rating

Community listing page, reviews here may not be monitored by the author.

Iron's Spell Tweaker GUI

No reviews yet

allows players and modpack creators to freely tweak, balance, and customize all spells from Iron's Spells 'n Spellbooksand various Addons

Mod Loaders
Minecraft

About

Description

🪄 Iron's Spell Tweaker GUI

An intuitive, modern in-game GUI mod for Minecraft NeoForge 1.21.1 that allows players and modpack creators to freely tweak, balance, and customize all spells from Iron's Spells 'n Spellbooks and its addons—directly from the title screen or in-game pause menu with zero restart required!


 1789847470199_Screenshot_2026-09-20_021821.png

Features

 Interactive Spell Browser

  • Instant Search: Type to search spells in real time by display name, spell ID, or mod ID.
  • School Filter: Filter by Fire, Ice, Lightning, Holy, Ender, Blood, Evocation, Nature, Eldritch, or any custom school.
  • Addon/Mod Filter: Automatically discovers all installed spell addons and allows filtering per mod.
  • "Edited Only" Filter: Quickly toggle to view only spells that have custom configs or unsaved tweaks.
  • Dynamic Theming: Each spell card features authentic school color accents and borders.

 Live Stat Tweaks

  • Power Multiplier: Tune damage and spell potency (0.1× to 10.0×).
  • Mana Cost Multiplier: Adjust mana consumption (0.1× to 10.0×).
  • Cooldown: Set cooldowns precisely from 0.0s to 120.0s.
  • Max Level: Adjust upgrade cap from level 1 to 10.
  • Min Rarity: Cycle through Common, Uncommon, Rare, Epic, and Legendary.
  • School Reassignment: Freely reassign spells to different magic schools.
  • Enable / Disable Toggle: Disables spell casting and scroll generation.
  • Crafting Toggle: Toggle whether spell scrolls can be crafted at the Inscription Table.

 Base Stats & Lore Preview

  • Base Stats Row: Inspect original Cast Type (Instant, Charge, Continuous, Passive), Base Cast Time (seconds), Base Mana Cost, and Base Spell Power before applying multipliers.
  • Description Lore: Multi-line word-wrapped guide/lore extracted directly from language definitions.

 Batch Tweak Mode (Mass Adjustment)

  • Target School Selector: Apply adjustments to all spells in a specific school or across all schools.
  • Percentage Sliders:
    • Power: −50 to +200 (5 step).
    • Cooldown: −80 to +100 (5 step).
    • Mana Cost: −80 to +100 (5 step).
  • Quick Preset Chips: +20 Power, +50 Power, −20 Cooldown, −50 Cooldown.
  • Mass Toggle: Enable All / Disable All for an entire school in one click.

 Safety Confirmation Modals & Factory Reset

  • In-Screen Modal Dialog: Prevents accidental clicks on destructive actions (Delete JSON, Batch Apply, Disable All, Reset All).
    • Full keyboard support: ESC to cancel, ENTER to confirm.
    • Complete click interception to prevent background click-through.
  • Factory Reset All: 1-click button to purge all custom config files in .minecraft/config/irons_spellbooks_spell_config/ and revert all spells to mod defaults.

Zero Gameplay Performance Overhead

  • Audited Architecture: 0% background CPU / memory overhead during world gameplay.
  • No Tick Handlers & No Background Threads: The mod only executes when the GUI is explicitly open.

Instructions for Server Admins / Modpack Creators
If you are hosting a server or creating a modpack for friends, you can use this mod to help balance the server.
Configure settings on the client first:
Launch the game to the main menu, customize the spells as desired, and save your changes.
Copy the configuration file to the server:
Click the "Open Config Folder" button in the bottom-left corner of the GUI.
Copy the `irons_spellbooks_spell_config` folder.
Paste it into the `config/` folder of your dedicated server, overwriting the existing one.

📄 How It Works

Iron's Spells 'n Spellbooks natively reads individual JSON configuration files located at:

.minecraft/config/irons_spellbooks_spell_config/<namespace>/<spell_path>.json
 

Iron's Spell Tweaker GUI acts as a visual interface for this system:

  1. Reads authentic defaults directly from each spell's DefaultConfig in memory.
  2. Generates and saves standard Iron's Spells JSON config files formatted identically to manual configs.
  3. Calls SpellRegistry.onConfigReload() upon saving or deleting configs, allowing real-time stat updates without restarting the game or server.

📜 License

This project is licensed under the MIT License - feel free to use, modify, and distribute this mod in your modpacks!