Fighting Game · Guides & deep dives

V2 Bot Coverage Mapping

position emitted from a bot result.

3sections1 minread
Markdown source
On this page

V2BotCoverageMapping covers TODOS.phase-72.72.19.1.3: it tracks which world positions bots have visited, generates a coverage heatmap, and identifies unexplored areas from bot result samples.

Runtime Surface#

  • FV2BotCoverageSample stores the bot id, frame number, and visited world position emitted from a bot result.
  • FV2BotCoverageArea defines the world-space bounds and heatmap cell size.
  • AnalyzeBotCoverage projects visited positions into grid cells, increments visit counts, computes heatmap intensity, and marks unvisited cells as unexplored areas.
  • FV2BotCoverageMappingResult returns samples, heatmap cells, unexplored cells, total and visited cell counts, coverage percentage, and verification flags proving the run tracked positions, generated a heatmap, and identified unexplored areas.

QA Behavior#

Coverage mapping is intentionally data-first. It does not render an image in automation; it creates heatmap cells that UI, reports, or later bot result reporting can visualize. The default sample adapter consumes V2RandomExplorationBot movement steps so random exploration immediately produces coverage evidence.

Required capabilities: track which world positions bots have visited, generate coverage heatmap, identify unexplored areas, visited cells, heatmap intensity, and unexplored cells.

It can generate coverage heatmap data for reports.

Validation Commands#

bash
python3 V2/ue/Tools/check-v2-bot-coverage-mapping.py
python3 V2/ue/Tools/check-v2-random-exploration-bot.py
python3 V2/ue/Tools/check-v2-bot-harness.py
python3 V2/ue/Tools/check-v2-tests-module.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/QA/BotCoverageMapping_V2_Contract.json
python3 -m json.tool V2/ue/Build/Horde/v2-buildgraph-job.json
python3 V2/tools/validate-v2-docs.py