Iron's Spellbooks Tweaks
If you have spent any time with Iron's Spells 'n Spellbooks, you know how deep its magic system runs. Spells, mana, cooldowns, summons, and rarity tiers all shape your progression. But you also know the frustration: the base mod only exposes a handful of serverconfig options. Open GitHub issues asking for finer control over mana regen, starting mana, and cooldowns have lingered for months. Iron's Spellbooks Tweaks steps in to fill those gaps, giving modpack makers and server admins the precise levers they need without touching Iron's buggy serverconfig file.
What Iron's Spellbooks Tweaks Does
Iron's Spellbooks Tweaks is a lightweight addon that reads its own TOML file at config/irons_spellbooks_tweaks-server.toml. It applies your settings through attribute modifiers and hooks on Iron's public events, leaving the original serverconfig completely untouched. This approach sidesteps the known multiplayer sync bugs reported in Iron's GitHub issue #1033. The result is a stable, server-side-only solution that works cleanly across clients.
The addon targets several pain points that have been requested repeatedly in issues #161, #162, and #391. You get direct control over mana regen, starting mana, cooldown reduction, cast time reduction, and much more. Best of all, every option is optional. If you only need one tweak, you can ignore the rest.
Core Config Options
Mana and Regen Control
Mana management is the heart of any spellcaster experience. Iron's Spellbooks Tweaks gives you three powerful options:
- baseManaRegenPercent: Adds a bonus to the MANA_REGEN attribute on login, letting you speed up or slow down natural regeneration.
- startingMaxMana: Adds a flat bonus to the MAX_MANA attribute on login, giving players a head start or a handicap.
- disableManaRegen: Fully disables passive mana regeneration, forcing players to rely on other sources like potions or items.
These options are applied on login, so they work seamlessly with existing worlds and player data.
Spell Timing Adjustments
Combat pacing often comes down to cooldowns and cast times. The addon offers two straightforward attributes:
- cooldownReductionBonus: Adds a bonus to the COOLDOWN_REDUCTION attribute, letting you shorten the downtime between powerful spells.
- castTimeReductionBonus: Adds a bonus to the CAST_TIME_REDUCTION attribute, making spells fire faster.
These are global modifiers, but they stack with any other sources of cooldown or cast time reduction your players might have.
Spell Scaling and Buff Duration
Starting with version 1.5, Iron's Spellbooks Tweaks introduces scaling options that affect the entire player base. The spellPowerMultiplier option scales the SPELL_POWER attribute on every player, with a range from 0.0 to 10.0. Damage tooltips update to reflect the scaled value, so players always see accurate numbers. This is perfect for creating high-powered or low-magic server experiences.
The buffDurationMultiplier scales the duration of buffs and debuffs from Iron's Spellbooks and its addons. The range is also 0.0 to 10.0. Vanilla potions, food effects, and beacon effects are not touched, so you can target only the magic mod's effects. The active effect countdown in the inventory shows the actual scaled time, while the spell tooltip displays the unmodified base. You can also define a buffDurationNamespaces list to control which mods get their effects scaled. The defaults cover Iron's Spellbooks plus popular addons like Cataclysm Spellbooks, dacxirons, GameTechBC's Spellbooks, GTBC's Geomancy Plus, Hazen 'n Stuff, Illage and Spell-age, and Traveloptics.
Restrictions and World Overrides
Sometimes you need to limit what players can do. Iron's Spellbooks Tweaks provides several restriction options:
- spellCastingDisabledDimensions: Blocks casting entirely in specified dimension IDs.
- maxSpellRarity: Caps the highest spell rarity players can cast. Mob casters bypass this cap.
- inscriptionBlacklist: Prevents specific spell IDs from being inscribed.
For even finer control, the addon supports per-world config overrides. The global config in config/ remains the source of truth. To customize a specific world, copy the global file into that world's serverconfig/ folder and edit it. Missing keys fall back to the global values. The /isstweaks copyconfig command, which is op-only, copies the global config into the current world's folder so you can set up overrides in-game without manually navigating files.
Per-Player Progression Unlocks
One of the most exciting features is the datapack-driven unlock system. Pack developers can gate spells, dimensions, and bonuses behind advancements or boss kills. JSON files go into data/<namespace>/isstweaks/unlocks/<id>.json and support advancement and entity_kill triggers. Available grants include:
- rarity_cap: Raises the player's allowed rarity ceiling above the global maxSpellRarity gate.
- cooldown_reduction_bonus: Adds a flat bonus to cooldown reduction.
- cast_time_reduction_bonus: Adds a flat bonus to cast time reduction.
- max_mana_bonus: Adds a flat integer bonus to MAX_MANA.
- mana_regen_bonus: Adds a flat bonus to MANA_REGEN.
- remove_dimensions: Exempts the player from the casting dimension blacklist for specified dimensions.
- remove_inscriptions: Exempts the player from the inscription blacklist for specified spells.
Multiple unlocks that grant the same number bonus all add up. Negative values work too, if you want to subtract from a player's stats. Each unlock JSON can include an optional requirement_text field for a hint string, which the requirements command displays in chat.
Commands and Modpack Integration
Server admins get a full set of op-only commands: /isstweaks grant, /isstweaks revoke, /isstweaks status, /isstweaks reset, and /isstweaks copyconfig. All players can use /isstweaks requirements spell <spell_id> and /isstweaks requirements rarity <rarity> to check unlock progress in chat.
For modpack makers, integration is simple. Drop the jar into your pack's mods folder, edit the TOML config, and ship the config alongside the pack. All options are server-side, so clients do not need matching configs. If you want to streamline the experience for your community, the foxygame.net launcher offers a one-click install for modpacks that include Iron's Spellbooks Tweaks, and its add-on catalog keeps version compatibility checks automatic, so players always get the right build. The launcher also handles auto-updates, meaning your server's tweaks stay current without manual downloads.
Compatibility and How to Install
Iron's Spellbooks Tweaks supports Minecraft 1.20.1 Forge and Minecraft 1.21.1 NeoForge. It requires Iron's Spells 'n Spellbooks 3.0.0+ for 1.20.1 or version 1.21.1-3.15.0+ for 1.21.1. The mod is a soft dependency, so it loads cleanly even without Iron's Spellbooks present, though you will not get any functionality without it. No conflicts are expected with other Iron's addons.
To download Iron's Spellbooks Tweaks, head to a trusted mod repository and grab the jar for your Minecraft version. The installation process is standard: place the jar in your mods folder and launch the game. If you need to know how to install it on a server, simply add the jar to the server's mods folder and restart. The config file generates on first run. Iron's Spellbooks Tweaks for Minecraft is MIT licensed, so you can freely include it in any pack.
Final Thoughts
Iron's Spellbooks Tweaks is the missing config layer for one of Minecraft's best magic mods. It respects Iron's original design while opening up the precise control that modpack makers and server owners have been asking for. Whether you want to slow down mana regen, gate powerful spells behind boss kills, or scale summon damage, this addon delivers. The per-world overrides and per-player unlocks add a layer of depth that transforms how you can design progression. If you have been waiting for a way to fine-tune Iron's Spells 'n Spellbooks, this is the tool you need.