Winefox's Spellbooks

Winefox's Spellbooks

中文说明 · Minecraft 1.21.1 · NeoForge · MIT

**Bridges Touhou Little Maid and Iron's Spells 'n Spellbooks: maids read spellbooks, manage mana and pick their own spells, and players can summon maids onto the battlefield in return.**

---

Mod Overview

Winefox's Spellbooks turns the maids of Touhou Little Maid into real spellcasters: put a spellbook in her accessory slot and she picks spells to suit the situation, budgets her mana, respects cooldowns, strafes and repositions — and plays a casting animation if she uses a GeckoLib model.

Beyond that main line, the mod also provides:

• Winefox Hex — a standalone school with its own damage type and attributes, built around player–maid teamwork: the player opens, the maid follows up, and fighting together pays far better than fighting apart;
• Addon compatibility — behaviour classifications for several hundred spells across 15 Iron's Spells addons. Installed addons take effect automatically; missing ones cause no errors.

About the name: casting animations only play on GeckoLib maid models, and "Winefox" is one such model.

---

Quick Start

1. Install the dependencies: Touhou Little Maid and Iron's Spells 'n Spellbooks, plus their own dependencies (Curios, GeckoLib).
2. Install this mod.
3. Give the maid a spellbook with spells inscribed and put it in her accessory slot, or give her an imbued weapon / armour piece.
4. Open the maid GUI and switch her task to Magic Attack or Magic Support.
5. With Show spell names in spell battle enabled (the default), the spell she is casting appears above her head.

---

Maid Spellcasting

Casting Media

Her main hand, armour slots, maid accessory slots and Curios slots are all scanned; spells in any "spell container" (spellbook, imbued weapon, imbued armour) enter her spell list.

• Only one spellbook takes effect at a time, same as for players; imbued gear is not subject to that limit and stacks.
• Spell level = the spell's own level + the Affinity bonus from gear.
• A spell that belongs to no behaviour category is ignored — the most common reason for "she just won't cast that spell". See Seven Behaviour Categories.
• Any change of equipment recalculates the spell list immediately; after /reload updates the spell tags, loaded maids rescan as well.

The Two Tasks

| Task | Categories used | Target | |---|---|---| | Magic Attack | Attack / Defense / Movement / Self-heal / Negative Effect | Her own hostile targets | | Magic Support | Defense / Self-heal / Ally Buff / Negative Effect / Ally Heal | Whatever her owner and allies are fighting |

Magic Attack is the regular combat role: seek targets, reposition, cast, and optionally finish with a melee weapon.

Magic Support never starts a fight. It heals, buffs and cleanses the owner and same-team creatures (including other maids of the same owner), and debuffs enemies along the way.

> Both tasks share the same unlock condition: an imbued weapon in the main hand or armour slots, or a spellbook with inscribed spells in an accessory slot.

Seven Behaviour Categories

A maid's spell list is split into seven behaviour categories; the in-game config screen uses these same names. Each category also has an English field name in the spell tags and the loadout datapack:

| Category | Spell tag | Config option (key) | Loadout spells field | |---|---|---|---| | Attack | attack_spells | Extra attack spell ids (extraAttackSpells) | attack | | Defense | defense_spells | Extra defense spell ids (extraDefenseSpells) | defense | | Movement | movement_spells | Extra movement spell ids (extraMovementSpells) | movement | | Self-heal | support_spells | Extra self-heal spell ids (extraSupportSpells) | support | | Ally Buff | positive_effect_spells | Extra ally buff spell ids (extraPositiveEffectSpells) | positive_effect | | Negative Effect | negative_effect_spells | Extra negative effect spell ids (extraNegativeEffectSpells) | negative_effect | | Ally Heal | support_effect_spells | Extra ally heal spell ids (extraSupportEffectSpells) | support_other |

Two further marker tags take no part in classification: summon_spells (summons) and maid_should_recast_spells (needs several casts). They only mark a spell; they do not decide whether a maid may cast it.

Mana

• A maid has her own mana bar, independent of the player's; point at her with Jade to see it.
• The cap uses the same formula as for players: "Max Mana" affixes on staves and mage gear apply, and the Maximum mana multiplier option scales the whole thing.
• Natural regeneration defaults to roughly 2% per second, modified by mana regen affixes.
• Having been struck by lightning is a permanent flag saved on the maid — one strike and it never wears off. With Lightning-struck maids regenerate mana 100x faster enabled, such maids refill the entire bar every 0.5 seconds, which is effectively unlimited mana. That option is off by default.

How a Maid Picks a Spell

She makes a decision every short interval (upper bound set by Max combo delay tick, 10 ticks by default):

1. Drop what cannot be cast right now: anything short on mana or still on cooldown. If a multi-cast spell is unfinished, she finishes it first.
2. Weight every behaviour category, pick one category by weighted random, then pick a spell within it with equal probability.

Rules of thumb for the weights: