mintopia/blur
Watch
1
0
Fork
You've already forked blur
 0
Code Issues Pull requests Projects Releases 1 Packages 1 Wiki Activity Actions

Test-race scenarios and race bot in scripts/ #33

New issue
Closed
opened 2026-10-20 18:41:24 +00:00 by mintopia · 5 comments
mintopia commented 2026-10-20 18:41:24 +00:00
Owner
Copy link

Runnable race scenarios in scripts/ (ADR 0020 layout; tools stay in tools/, tools/modes/plans stays).

Acceptance

  • Scenarios: single-player race, split-screen, N-instance LAN; each instance takes its own mod loadout (ADR 0014), e.g. Bribe, Decoy_Drop.
  • Each instance gets its own game config by default: windowed, 1280x720, lowest graphics preset, no MSAA, vsync off; overridable (e.g. perf runs). Via the instance's profile, not host flags; dev-only host flag only if the game config can't express it.
  • Bot per racer via BLUR_PADFILE: full throttle (RT 255), fires each held powerup within ~1 s of it appearing in the feed's powerups, presses reset after ~3 s near 0 mph. No steering logic.
  • Padfile gains a left-stick X column (src/host/input/macos.mm vpad).
  • Menu navigation uses the dev-only menu state (#32).

Rules

  • Wire format: ADR 0019 (docs/decisions/0019-feed-message-contract.md). Repo data/tools: ADR 0020.
  • Fix and verify on BLUR_ENGINE=recomp only.
  • Update docs/state-websocket.md and examples/live-timing for any feed change.
  • Test races: use the scripts/ scenarios (windowed, low settings) once #33 exists.
Runnable race scenarios in `scripts/` (ADR 0020 layout; tools stay in `tools/`, `tools/modes/plans` stays). ## Acceptance - Scenarios: single-player race, split-screen, N-instance LAN; each instance takes its own mod loadout (ADR 0014), e.g. Bribe, Decoy_Drop. - Each instance gets its own game config by default: windowed, 1280x720, lowest graphics preset, no MSAA, vsync off; overridable (e.g. perf runs). Via the instance's profile, not host flags; dev-only host flag only if the game config can't express it. - Bot per racer via `BLUR_PADFILE`: full throttle (RT 255), fires each held powerup within ~1 s of it appearing in the feed's `powerups`, presses reset after ~3 s near 0 mph. No steering logic. - Padfile gains a left-stick X column (`src/host/input/macos.mm` `vpad`). - Menu navigation uses the dev-only `menu` state (#32). ## Rules - Wire format: ADR 0019 (`docs/decisions/0019-feed-message-contract.md`). Repo data/tools: ADR 0020. - Fix and verify on `BLUR_ENGINE=recomp` only. - Update `docs/state-websocket.md` and `examples/live-timing` for any feed change. - Test races: use the `scripts/` scenarios (windowed, low settings) once #33 exists.
mintopia commented 2026-10-21 02:34:24 +00:00
Author
Owner
Copy link

Implemented scripts/race.py single|split|lan (+ racelib.py, test_racelib.py) and the padfile left-stick X column (macos.mm vpad, docs/dev-flags.md, README).

  • Config: per-instance settings.xml in a copied save: windowed 1280x720, graphical_detail 0, no MSAA, vsync off; --set key=val overrides. LAN windows cascade.
  • Loadouts: LAN instances get --mods (default Bribe / Decoy_Drop) written to the loadouts_* store; roster confirmed bribe on racer0, decoy_drop on racer1.
  • Bot: RT 255, fires when a held powerup is >=0.5 s old, resets after ~3 s under 2 mph. Fire = pad A (found live: powerups vanished only after A pulses; RB did nothing).
  • Menu nav uses feed screen + dev_menu_item.
  • Verified on BLUR_ENGINE=recomp: single-player race, 2-pad split-screen, 2-instance LAN all finish with race_result final.

Known limits:

  • RESET = pad Y, not observed firing in a race.
  • Split-screen: feed marks only pad 0's racer local, so pads 1+ get throttle only.
  • --mods only applies to LAN (no selectable loadout in SP/split, ADR 0014).
  • LAN verified with 2 instances, not N>2.
  • No feed change, so no feed docs change.
Implemented `scripts/race.py single|split|lan` (+ `racelib.py`, `test_racelib.py`) and the padfile left-stick X column (`macos.mm` vpad, `docs/dev-flags.md`, README). - Config: per-instance `settings.xml` in a copied save: windowed 1280x720, graphical_detail 0, no MSAA, vsync off; `--set key=val` overrides. LAN windows cascade. - Loadouts: LAN instances get `--mods` (default Bribe / Decoy_Drop) written to the `loadouts_*` store; roster confirmed bribe on racer0, decoy_drop on racer1. - Bot: RT 255, fires when a held powerup is >=0.5 s old, resets after ~3 s under 2 mph. Fire = pad A (found live: powerups vanished only after A pulses; RB did nothing). - Menu nav uses feed `screen` + `dev_menu_item`. - Verified on BLUR_ENGINE=recomp: single-player race, 2-pad split-screen, 2-instance LAN all finish with race_result final. Known limits: - RESET = pad Y, not observed firing in a race. - Split-screen: feed marks only pad 0's racer local, so pads 1+ get throttle only. - `--mods` only applies to LAN (no selectable loadout in SP/split, ADR 0014). - LAN verified with 2 instances, not N>2. - No feed change, so no feed docs change.
mintopia commented 2026-10-21 02:36:41 +00:00
Author
Owner
Copy link

Comment-check fixes (6217be7): race.py exit docstring now states it checks a final race_result per instance (also sent on timeout/quit; pads 1+ unchecked); removed file-describing module docstrings in racelib.py and test_racelib.py. test_racelib passes.

Comment-check fixes (6217be7): race.py exit docstring now states it checks a final race_result per instance (also sent on timeout/quit; pads 1+ unchecked); removed file-describing module docstrings in racelib.py and test_racelib.py. test_racelib passes.
mintopia commented 2026-10-21 03:25:18 +00:00
Author
Owner
Copy link

Split: every pad now runs the full bot (pad k drives pad 0 racer + k). Verified on recomp split n=2: pad 0 fired 15 powerups, pad 1 fired 17, race finished. Feed JSON-string values are now decoded in Feed.get. Not verified in a live race: reset button (Y) firing after ~3 s stuck (covered by test_racelib; a forced-stuck run hung at the HUD) and LAN with N>2 (tested with 2 instances).

Split: every pad now runs the full bot (pad k drives pad 0 racer + k). Verified on recomp split n=2: pad 0 fired 15 powerups, pad 1 fired 17, race finished. Feed JSON-string values are now decoded in Feed.get. Not verified in a live race: reset button (Y) firing after ~3 s stuck (covered by test_racelib; a forced-stuck run hung at the HUD) and LAN with N>2 (tested with 2 instances).
mintopia removed their assignment 2026-10-21 03:29:10 +00:00
mintopia commented 2026-10-21 05:36:03 +00:00
Author
Owner
Copy link

Rebased onto a51e589 (develop slim README). Resolved README conflict: kept slim table + added scripts row; moved the full scripts row into docs/repo-structure.md (dropped stale ADR 0020 link; 0020 is game-lookup-data). test_racelib passes. No code change vs prior verified work.

Rebased onto a51e589 (develop slim README). Resolved README conflict: kept slim table + added `scripts` row; moved the full `scripts` row into `docs/repo-structure.md` (dropped stale ADR 0020 link; 0020 is game-lookup-data). test_racelib passes. No code change vs prior verified work.
mintopia commented 2026-10-21 05:36:48 +00:00
Author
Owner
Copy link

Completed and merged by Harmonic (task 35).

Completed and merged by Harmonic (task 35).
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
develop
main
v0.1.0
Labels
Clear labels   
needs-info
Waiting on reporter for more information

  
needs-triage
Maintainer needs to evaluate this issue

  
ready-for-agent
Fully specified, ready for an AFK agent

  
ready-for-human
Requires human implementation

  
wontfix
Will not be actioned

No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wontfix
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
mintopia
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#34 Spike: game race ID shared across LAN instances
mintopia/blur
#35 Feed: use and collect events, per-racer totals
mintopia/blur
#38 Game award stats and awards in the feed
mintopia/blur
#49 JSON Schema for the game-state feed
mintopia/blur
Depends on
#32 Feed: dev-only debug state for scripts
mintopia/blur
Reference
mintopia/blur#33
No description provided.