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.

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

Bind Touhou Little Maid companions to weapons, manifest them in combat, and grow together through Contract Resonance.

《契约之刃》是《车万女仆》的玩法附属模组：让女仆与武器缔结契约，在战斗中自动显现，并通过契约共鸣共同成长。

Features

• Bind compatible weapons to a maid through the Contract Signing Table.
• Automatically manifest and recall the contracted maid with smooth delays when switching weapons.
• Use Contract Resonance as the combat bond; Touhou Little Maid favorability instead provides a weapon damage bonus.
• Supports ordinary weapons and dedicated behavior for ranged magic weapons and SlashBlade-compatible weapons.
• Protects ownership data in multiplayer and records relevant combat progress back to the player's contracted weapon.
• Includes an in-game Patchouli guide, Contract Fragments, when Patchouli is installed.

Integrations

Required

• Touhou Little Maid

Optional

• Goety - The Dark Arts
• Iron's Spells 'n Spellbooks
• Touhou Little Maid: Spell
• SlashBlade:Resharped
• TLM: True POWER
• Patchouli

Optional integrations are detected independently. You may install any one of them, several of them, or none of them.

Requirements

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

Installation

1. Install Forge for Minecraft 1.20.1.
2. Install Touhou Little Maid.
3. Put this mod's JAR into the mods folder.
4. Add any optional integration mods you want.

This is a beta release. Back up important worlds before testing, especially when using a large modpack.

Source and issue tracker: https://github.com/Bluelgin/Contract-Blade