Modular Staffs
An Iron's Spells 'n Spellbooks addon that lets you build your own spellcasting staff.
Draw up a blueprint, pick a core material, and fill the staff's grid with the spells and bonuses you want. Your staff gains experience as you cast, unlocks more cells, and grows stronger over time.
Features
- Build your own staff from a blueprint and one of 8 core materials.
- Socket any Iron's Spells spell into the staff using spell modules made from scrolls.
- Stat modules for spell power, max mana, mana regen, cooldown, cast time, spell resistance, summon damage, and power for each of the 9 schools.
- School support modules that raise the level of adjacent spells of the same school. Placement matters!
- Staff leveling: casting gives XP. Each level opens a new cell and adds a random bonus.
- Spell Programmer: write IF/THEN rules into your staff to cast spells automatically or with one key.
- Custom looks with 5 tip parts and 5 rod parts.
- In-game guide book, given on first join (or craft it from a Book + Lapis Lazuli).
- JEI support for all recipes and info pages.
- Modpack-friendly config: turn off the gameplay changes to Iron's Spells if you don't want them.
- Translations: English, Japanese, Simplified Chinese.
Getting Started
1. Blueprint
Craft: Paper + Lapis Lazuli + Arcane Essence (shapeless). Each blueprint has a quality from 1 to 8. Higher quality means more usable cells in the 4×4 grid (quality 1: 1–2 cells, quality 8: 15–16 cells).
2. Staff Workbench → Staff Type
Place the blueprint anywhere in the grid, then put a core material above two sticks in one column. Core materials: Amethyst, Lapis Lazuli, Gold, Emerald, Diamond, Netherite, Arcane Essence, Mithril. Stronger cores give more attack damage, spell power and max mana. Add a tip part and a rod part to change the staff's look. An existing Iron's Spells staff placed alone can also be converted.
3. Module Workbench → Modular Staff
Put the Staff Type in the left slot, place modules into the lit cells, and take your Modular Staff from the right slot. You can put the staff back later to rearrange modules.
4. Cast and level up
Casting with the staff gives XP. Each level opens one more cell and adds a random stat bonus. Max level is 4 / 6 / 8 / 10 depending on blueprint quality.
Modules
| Module | How to get | Effect |
|---|---|---|
| Spell module | Scroll + Iron Ingot + Ink of the same rarity + Arcane Essence | Cast that spell from the staff |
| Stat module (I) | Crafting: Arcane Essence ×4, Amethyst Shard ×4 and a key item | Stat bonus |
| Stat module (I–III) | 2.5% drop from hostile mobs killed by a player | Stat bonus |
| Stat module (IV) | Always dropped by bosses | Stat bonus |
| School support module | Crafting only: Arcane Ingot ×4, school rune ×4, Diamond. Upgrade: 2 of the same quality + Diamond / Diamond Block / Netherite Ingot | Adjacent same-school spells +1 level (IV: +2) |
Up to 3 stat/support modules work on one staff.
Blueprint drops
- Hostile mobs killed by a player: 2.5% chance, quality 1–6.
- Bosses (
forge:bosses/c:bossestag, e.g. Ender Dragon, Wither): always drop a quality 7–8 blueprint.
Spell Programmer
Put a Modular Staff in the Spell Programmer and write rules: IF (or NOT) a condition → cast one or more spells from the staff.
Conditions include: Always, Enemy near / far, 3+ enemies, HP < 50% / 25%, Mana > 80% / < 20%, Just hurt, Falling, On fire, Sneaking, Night, Previous spell lands, 5s after previous.
- AUTO mode casts by itself when the condition is met.
- MANUAL mode casts when you press the Run Spell Program key (default G).
Changes to Iron's Spells (configurable)
By default this addon is built around staffs, so it changes a few things. All of them can be turned off in config/modularstaffs-common.toml:
| Option | Default | What it does |
|---|---|---|
disableSpellbookInscription |
true | Spells can't be written into spellbooks at the Inscription Table |
lockArcaneAnvilForModularStaffs |
true | Modular Staffs can't be changed at the Arcane Anvil |
manaSickness |
true | Spending a large share of mana in a few seconds causes brief slowness and nausea |
blueprintDropChance / moduleDropChance |
0.025 | Drop chances from hostile mobs |
bossDrops |
true | Bosses always drop a high-quality blueprint and a quality IV module |
giveGuideOnFirstJoin |
true | Give the guide book on first join |
Requirements
Minecraft 1.21.1 (NeoForge)
- NeoForge 21.1.223 or newer
- Iron's Spells 'n Spellbooks 1.21.1-3.15.0 or newer (and its dependencies)
Minecraft 1.20.1 (Forge)
- Forge 47 or newer
- Iron's Spells 'n Spellbooks 1.20.1-3.15.0 or newer (and its dependencies)
Install on both client and server. JEI is optional.
FAQ
Can I use this in a modpack? Yes. You can use it in modpacks on CurseForge and Modrinth. Please don't re-upload the file elsewhere.
I found a bug / I have a suggestion. Please leave a comment on this page. Include your Minecraft version, loader version, and a log if possible.