TLM Formation Tactics

> **This is an add-on for [Touhou Little Maid](https://www.curseforge.com/minecraft/mc-mods/touhou-little-maid) and requires it to run.**
> Requires: [GeckoLib](https://www.curseforge.com/minecraft/mc-mods/geckolib) · [Superb Warfare](https://www.curseforge.com/minecraft/mc-mods/superb-warfare) · [SimpleBedrockModel](https://www.curseforge.com/minecraft/mc-mods/simplebedrockmodel)

# TLM Formation Tactics

Squad management, formation follow, tactical command wheel and Black Hawk airdrop support for **Touhou Little Maid** on Minecraft 1.20.1 / Forge.

## Features

- **Squad manager (F9)** — dynamic teams, per-team rally points, summon / takeover, squad withdrawal, death coordinates.
- **Formation follow** — maids form up around their owner; front/side guards with 4+ maids, follow radius, dispersion when idle, path prediction at speed.
- **Tactical command wheel (F8)** — follow, retreat, guard, focus-fire, marked positions (applies to the active team only).
- **Tactical HUD** — squad status, roles overview, downed/unloaded indicators, logistics status.
- **Black Hawk air support** — deploy a squad by helicopter with rappelling insertion, extract by rope ascent, and *swap deployments*: when you deploy a new team while another is still on the field, the old team boards the same helicopter and flies home.
- **Hard rescue** — if the squad is left behind (death, respawn, dimension change, far teleport with no event), it is force-located across dimensions and teleported back; a periodic reconcile check covers teleports that fire no event.
- **Squad force-loading** — while a squad is deployed, its 3x3 chunks stay loaded (configurable).
- **Friendly-fire protection** — owners and same-owner maids are protected from melee, arrows, crossbows, tridents, bullets and danmaku.
- **Bilingual** — all interface, item and message text is available in Chinese and English (in-game language setting).

## Requirements (all required)

| Mod | Version |
|---|---|
| Minecraft | 1.20.1 |
| Forge | 47.x (tested on 47.4.28) |
| Touhou Little Maid | 1.5.3 (1.6+ not supported) |
| GeckoLib | 4.8.4 (4.9+ not supported) |
| SuperbWarfare | 0.8.9.x (0.8.9 <= version < 0.9) - install it together with its own dependencies (Kotlin for Forge for the Modrinth build, SimpleBedrockModel 2.5.1+ for the CurseForge build) |
| Java | 17 |

Client and server must run the **same** tlmformation version.

## Configuration

Config file: `config/tlmformation-common.toml`

- `squadRescue` — hard rescue on respawn / dimension change, reconcile interval, max distance, cooldown, revive downed.
- `squadChunks` — per-squad 3x3 force-loading (radius / ticking / max chunks).

## License and source

GPL-3.0. This mod is a derivative work of SuperbWarfare (GPL-3.0) and therefore must be distributed under GPL-3.0 with corresponding source available.

- Source: *(fill in your repository URL)*
- Bundled asset notices: `THIRD_PARTY_NOTICES.md` inside the jar.

## Credits

- Touhou Little Maid — TartaricAcid and contributors
- SuperbWarfare — its authors (Black Hawk vehicle base, engine/rotor audio samples under GPL-3.0)
- GeckoLib — Tslat and contributors