ContractBlade

Contract Blade / 车万女仆：契约之刃

Contract Blade is a Touhou Little Maid addon that lets maids form persistent contracts with supported weapons. Contracted companions can manifest in combat, return safely when their weapon is switched, build Contract Resonance, and strengthen their weapon through shared battles. Versioned compressed storage preserves maid inventories, appearances, capabilities, and progression while reducing contract NBT size.

Features

• Bind a tamed maid to the dedicated Contract Blade or another supported weapon.
• Automatic manifestation and delayed recall for ordinary contracted weapons.
• Manual summon and recall controls for the dedicated Contract Blade.
• Contract Resonance as a renewable combat resource, separate from TLM favorability.
• Weapon growth, ownership protection, transfer safeguards, and multiplayer-safe contracts.
• Single-authority contract storage, automatic legacy migration, compressed maid data, and anti-recursion protection.
• Optional integrations for Goety, Iron’s Spells ‘n Spellbooks, Touhou Little Maid: Spell, SlashBlade, TLM: True POWER, and True POWER of Maid.
• Optional TACZ contract-gun support using TLM’s native gun task and owner-inventory ammunition links.
• Optional Patchouli handbook support.

Requirements

• Minecraft 1.20.1
• Forge 47.x
• Java 17
• Touhou Little Maid 1.1.7 or newer

All compatibility integrations are optional and are detected at runtime.

TACZ contract guns require TACZ 1.1.8 or newer and a TLM version that provides
the touhou_little_maid:gun_attack task. The current TLM release is recommended.

License

Code and original assets in this repository are available under the MIT License. See LICENSE and ASSET_SOURCES.md.