Maneuver Reference

Tactical tasks coordinate positions and attack requests. The surrounding graph owns target acquisition, health decisions, weapon selection, and emergency priority.

Direct engagement

Attack moves into range reported by IAttackAgent and engages. Charge forms an advancing group before direct contact. Marching Fire advances while attacking, so its weapon implementation must support firing while moving and expose cooldown state accurately.

Use Charge when group presentation matters before engagement. Use Marching Fire only when pathfinder, animation, and attack implementation can operate concurrently without fighting for rotation or movement.

Positional engagement

Flank approaches from multiple sides, while Surround distributes members around the target. Both need navigable space around the target. Walls, cliffs, and corridors can make ideal slots invalid.

Ambush holds until its engagement condition. Shoot and Scoot alternates attacks with relocation. Test moving targets and decide when the graph should cancel or restart the maneuver.

Leapfrog alternates advancing and covering roles. Spacing must leave reachable positions and useful lines of fire for both halves.

Holding and withdrawal

Defend protects Defend Object and stops pursuit when the agent exceeds Max Distance from it. Hold moves agents onto a ring around Defend Object. It acquires targets within Defend Radius and continues pursuing them until they die, without Defend’s maximum pursuit-distance limit. Neither task guarantees that agents remain at their original positions. Their attack implementation should still reject invalid or dead targets.

Retreat moves away from the threat. Define a fallback for enclosed areas where no valid route away exists.

Reinforcements

Request Reinforcements and Reinforcements Response form a paired protocol. The requester signals a need and the responder determines whether supporting agents can join.

Scope request data so unrelated squads do not respond. Define what happens when no responder is available or the target dies before support arrives.

Choose by environment

Use direct engagement in confined space. Use positional maneuvers only when their generated slots fit the available navigation data. A tactical shape that works in an open test scene may stall when the real target stands near a wall.