ferravex
GitHub

Ironclad Tactics

Three borrowed machines liberate the Copper Coast across six authored squad-tactics operations. Plan an entire squad turn, move out of telegraphed attacks, spend action points on fire or specialist skills, and choose five permanent upgrades before the final Warden battle.

This is a complete campaign with mission briefings, distinct objectives, bounded enemy turns, reserve waves, limited mission retries, score/medals, and a liberation ending. The game uses the first-party Ferravex arcade host, renderer, math and four-neighbor navigation grid; it has no added dependencies or external assets.

Play

cargo run -p ironclad-tactics --offline --locked -j 2

The shared host supplies title/start, pause, help, remapping, sound, whole-campaign restart, records and native/browser presentation. Game-specific rules are renderer-independent. Rendering is procedural: riveted bulkheads, striped cover, tracked squad machines, enemy chassis, route dots, reserve markers and fixed enemy aim lines.

ControlAction
Space/EnterDeploy from briefing; execute the cursor's contextual order
1 / 2 / 3Select BRASS / KESTREL / MICA; choose upgrade at debrief
Arrows or WASD, tappedMove targeting cursor; does not spend AP
Click boardSelect friendly machine, shoot an enemy, interact with objective, or move
Click squad cardSelect that machine
Click an order rowSame as Space (order), X (skill) or C (end turn)
Click a patient buttonWith MICA selected: aim at that machine and repair it, exactly like cursor + X
X/ESelected machine's specialist skill
C/Q or 4End the entire squad turn
Space/X or click Retry after setbackSpend one retry and restart the current operation
C or click Concede after setbackConcede the campaign
Click an upgrade cardSame as its 1 / 2 / 3 key at debrief
Esc/P / H / M / R / F2Host pause / help / sound / whole-campaign restart / remap

Aim at an ally with the cursor and press X to repair it while MICA remains selected, or click that ally's patient button in MICA's skill row. Clicking an ally on the board selects it. If no living ally occupies the cursor, MICA repairs herself.

Reading the screen

The play screen speaks in icons, meters and previews rather than sentences.

Squad and rules

MachineHullAP each turnCannon damage / rangeX skill
BRASS, Vanguard1844 / 4 tilesBrace: 1 AP; incoming hits reduced by 2 until next turn; moving cancels brace
KESTREL, Scout1453 / 6 tilesFocus: 1 AP; next shot gains 2 damage; cannot stack
MICA, Engineer1543 / 4 tilesPatch: 2 AP + one kit; repair up to 6 hull within Manhattan distance 2

Authored operations

Each board is 11 by 8 tiles, with three controllable roles and at most eight enemy slots.

OperationEnemiesObjectiveDeadline
Breakwater4Disable the coastal patrol20 turns
The Captive Signal4Rescue the operator at O; escort the carrier to E24 turns
Relay Nine5Activate O, then guard it for 2 enemy phases24 turns
Bridge of Sparks5 totalActivate O; guard for 4 phases and survive through turn 624 turns
Foundry Warden4Disable O and P, then clear the patrol26 turns
The Last Engine6Defeat the Warden and guard, then activate O28 turns

Bridge reserves arrive on turns 3 and 5. An occupied marked entry uses the nearest empty floor, with deterministic tie-breaking; newly arrived reserves telegraph before their next action. Rescue, capture and hold do not require eliminating every enemy. The final objective and guard may be completed in either order.

Score is 100 per disabled enemy, plus 1,000 per operation, 150 per surviving machine and 25 per remaining deadline turn. Earn three medals for all three survivors within half the deadline; two medals for at least two survivors otherwise; one for completing with one survivor. Failed-mission points are discarded on retry. The shared host retains completed-run records; there is no mid-campaign save.

Strategy

Disable a marked attacker before ending the turn, or move off its target square. A full squad has enough AP to combine advancing, concentrated fire and protection. Use KESTREL's range to remove sentries while BRASS crosses gaps. Reserve enough AP for a shot after moving; spend leftover AP on focus or brace. Keep MICA close enough to repair a damaged escort carrier. Leave corridors open for extraction, and keep a guard beside an activated relay instead of chasing every remaining enemy. Cannon upgrades shorten patrol battles; armor and drive upgrades support riskier captures and faster escorts.

Verification and replay

cargo test -p ironclad-tactics --offline --locked -j 2
cargo clippy -p ironclad-tactics --all-targets --offline --locked -j 2 -- -D warnings
cargo run -p ironclad-tactics --offline --locked -j 2 -- --headless

Executed: 26 behavioral tests and 1 runnable rustdoc example passed, strict all-target Clippy passed, and owned Rust files passed formatting. Tests cover authored content, AP/path costs, idle/invalid inputs, symmetric LOS, cover, shot rewards, focus/repair/brace resources, fixed enemy fire, enemy movement, occupied reserve entries, loss/retry/score rollback, objective contests/deadlines, upgrade caps, controller edge cases, full campaign completion, deterministic command replay and terminal-state invariance. Presentation tests cover progress pips at the first and last operation, effects requested for deploys, shots and hits (and none on idle ticks), the delayed operation card, previews that match what the rules then do, sidebar/patient/setback clicks that mirror their keys, the one-tick event list, the header copy and the four-bullet guide.

The headless controller submits ordinary selection, cursor, click, skill and end-turn inputs to Game::step; it neither modifies game state nor grants invulnerability. Its complete run reaches all six operations, keeps all three retries, earns 18 medals, and wins at model tick 2420 with 14,175 points. Mission starts occur at ticks 0, 311, 821, 1171, 1631 and 1991.

Parent native smoke commands can use:

cargo run -p ironclad-tactics --offline --locked -j 2 -- --autoplay --smoke-frames 240 --screenshot target/games20/ironclad-tactics-240.png

Useful model-tick capture windows are 180 (first board), 500 (rescue), 1000 (relay), 1400 (bridge), 2100 (final battle) and 2500 (ending). Native frame counts and model ticks can differ. The autoplay controller chooses upgrades within ten ticks, so autoplay captures rarely show the debrief card, which arrives half a second after an operation ends.

Limits: automated legal-input completion demonstrates one successful build and route, not exhaustive human balance testing. Individual mechanic tests use isolated fixtures; the complete-campaign test starts from Game::new() and uses only legal commands. Browser/Wasm, touch devices, native audio, remapping and shared persistence are integration checks owned by the parent and were not separately exercised by this implementation agent. No workspace build or shared staging was run.