Touhou Little Maid: Combat Plus
A combat AI enhancement addon for Touhou Little Maid.
Works out of the box — no special task switching needed. Your maids' existing melee, bow, crossbow, trident and gun tasks automatically gain a brand-new three-circle combat system.
Features
🎯 Three-Circle Combat
Combat behaviour is driven by three concentric circles centred on the owner:
| Circle | Default | Behaviour |
|---|---|---|
| Follow | 4 blocks | Stays near the owner while fighting |
| Active | 10 blocks | Enemies inside are engaged proactively |
| Expand | 24 blocks | Temporarily expanded when the owner attacks / is attacked |
- Enemy leaves the expand circle → target dropped, circle shrinks back, aggro cleared
- After the owner walks away, stale aggro no longer makes the maid charge in again when approaching
🏹 Move-and-Shoot
Bow, crossbow, trident and gun maids now orbit the owner while strafing and firing, instead of standing still or chasing enemies:
- Too far from the target → closes the distance first
- Within weapon range → strafes around the owner while firing
- Owner moves away → maid follows
Adaptive gun range: for TAC-compatible guns, the strafe distance adapts to the gun type (pistol / rifle / sniper) using Touhou Little Maid's own gun range config.
🎪 Smart Targeting
Priority-based target selection:
- Enemies the owner is attacking / being attacked by
- Enemies attacking the maid
- Current locked target (won't switch randomly)
- Nearest visible enemy inside the active circle
✨ MaidSpell Compat (Optional)
With Touhou Little Maid: Spell installed:
- Spell melee maids: fights up close while casting
- Spell ranged maids: orbits the owner while casting
- Only targeting and movement are taken over — no spell-casting logic is modified
MaidSpell is an optional dependency; the mod works fine without it.
🔧 Other Fixes
- Owner's thrown trident hit now correctly triggers aggro expansion
- Maid locks onto the target right after throwing a trident
- Monster classification fixes (neutral / hostile)
- Attack target preserved when the maid teleports
- Stale combat memories cleared on pickup / place
Config
config/touhou_little_maid_combat-common.toml — same options as above.
Requirements
- Required: Touhou Little Maid 1.5.3+
- Optional: Touhou Little Maid: Spell
- Minecraft 1.20.1 + Forge 47+ / Minecraft 1.21.1 + NeoForge 21.1+
Notes
- This mod adds no new tasks; all enhancements are applied automatically to the maid's vanilla combat tasks.
- The AI runs on the server — installing it server-side is enough (client-side for singleplayer).

