Iron's Spellbooks Tweaks
Config tweaks for Iron's Spells 'n Spellbooks aimed at modpack makers. Adds TOML config options Iron's doesn't expose.
What it does
Iron's Spellbooks has a small set of config options in its serverconfig (mana regen multiplier, spawn percent, sword toggles). There are open issues on iron431's GitHub asking for more direct control over mana regen rate, starting mana, and cooldowns (#161, #162, #391) that haven't been addressed.
This mod fills those gaps without touching Iron's serverconfig (which has known multiplayer sync bugs per #1033). It uses its own TOML at config/irons_spellbooks_tweaks-server.toml and applies settings via attribute modifiers and hooks on Iron's public events.
Config options
Mana
baseManaRegenPercent: bonus added to MANA_REGEN attribute on loginstartingMaxMana: bonus added to MAX_MANA attribute on logindisableManaRegen: fully disables passive mana regen
Spell timing
cooldownReductionBonus: bonus to COOLDOWN_REDUCTION attributecastTimeReductionBonus: bonus to CAST_TIME_REDUCTION attribute
Restrictions
spellCastingDisabledDimensions: list of dimension IDs where casting is blockedmaxSpellRarity: caps the highest spell rarity players can cast (mob casters bypass)inscriptionBlacklist: list of spell IDs that cannot be inscribed
Black hole
blackholeImmunity: per-entity-type pull resistance values from 0.0 to 1.0
Per-player progression unlocks
A datapack-driven unlock system lets pack devs gate spells, dimensions, and bonuses behind advancements or boss kills. JSONs go at data/<namespace>/isstweaks/unlocks/<id>.json. Supports advancement and entity_kill triggers.
Available grants:
rarity_cap: raise the player's allowed rarity ceiling above the global maxSpellRarity gatecooldown_reduction_bonus: flat addition to the player's cooldown reduction attributecast_time_reduction_bonus: flat addition to the player's cast time reduction attributemax_mana_bonus: flat int addition to the player's MAX_MANA attributemana_regen_bonus: flat addition to the player's MANA_REGEN attributeremove_dimensions: exempt the player from the casting dimension blacklist for these dimensionsremove_inscriptions: exempt the player from the inscription blacklist for these spells
If a player gets multiple unlocks that grant the same number bonus, they all add up. Negative values work too if you want to subtract. There's an optional requirement_text field on each unlock JSON for a hint string, which the requirements command shows in chat.
Commands
OP-only:
/isstweaks grant <player> <unlock_id>: manually grant an unlock/isstweaks revoke <player> <unlock_id>: revoke from the granted set/isstweaks status <player>: show current progress/isstweaks reset <player>: wipe all progression data
Open to all players:
/isstweaks requirements spell <spell_id>: shows the unlock requirement for a specific spell. Prefixed with [Unlocked] if the player has already met it./isstweaks requirements rarity <rarity>: shows the unlock requirement for a rarity tier. Same [Unlocked] indicator when the player's cap is at or above the queried tier.
Note on overlap with Iron's per-spell configs
Iron's Spellbooks has per-spell JSON configs at config/irons_spellbooks_spell_config/ for tweaking individual spells (max level, mana cost multiplier, cooldown). This mod doesn't touch those. The maxSpellRarity option here is just one rarity gate that applies to every spell at cast time, no per-spell editing needed. It's faster to set up but less precise than per-spell tweaking. Pick whichever fits, or use both together.
For modpack makers
Drop the jar in your pack's mods folder, edit config/irons_spellbooks_tweaks-server.toml, ship the config alongside the pack. All options are server-side so clients don't need matching configs.
Compatibility
- Minecraft 1.20.1 Forge and Minecraft 1.21.1 NeoForge
- Iron's Spells 'n Spellbooks 3.0.0+ (1.20.1) or 1.21.1-3.15.0+ (1.21.1)
- Soft dependency, mod loads cleanly without Iron's Spellbooks present
- No conflicts expected with other Iron's addons
Source
GitHub. MIT licensed.
