BOAM - Bot On A Mission

BOAM — Bot On A Mission

Version: 2. 0. 4 | Documentation | Changelog

AI behavior analysis and modification mod for Menace.

Modifies enemy AI movement through configurable behaviour nodes, captures tactical data for offline heatmap rendering, provides a real-time in-game minimap overlay, and records full battle sessions (player actions + AI decisions + combat outcomes).

Features

• []AI Behaviour — Configurable behaviour nodes that influence enemy AI movement

  []Tactical Minimap — In-game IMGUI overlay showing unit positions on the captured map background

  []Heatmap Renderer — Offline heatmap generation from deferred render jobs — tile scores, decisions, movement

  []Action Logging — Records player actions, AI decisions, and combat outcomes to JSONL battle logs

  []Configuration — Versioned JSON5 configs with user/mod-default two-tier system

  Components

  • []BOAM-modpack — In-game mod (MelonLoader/Wine): Harmony patches, minimap overlay, map capture, action forwarding

    []BOAM-engine — External companion (. NET 10, port 7660): heatmap renderer, action logger, auto-navigation

    []Icon Generator — CLI tool: resizes game badge art into heatmap/minimap icons

    The BOAM-modpack works standalone — the minimap needs no engine. Start the BOAM-engine only when you want heatmaps or action logging.

    First time? Follow the Installation Guide.

    Downloads

    Pre-built engine binaries (Linux and Windows) are available on the Releases page. This is the only distribution channel — binaries are not hosted elsewhere.

    Each release includes:

    • []BOAM-modpack — C# source (compiled at deploy time by the Menace Modkit)

      []BOAM-tactical-engine — pre-built binaries for Linux and Windows (bundled and slim variants)

      Prefer to build yourself? See Building from Source.

      Install Layout

      ├── Mods/BOAM/

      │ ├── dlls/BOAM.dll C# bridge (compiled by ModpackLoader)

      │ ├── modpack.json Mod manifest

      │ ├── configs/ Mod default configs (reset on deploy)

      │ │ ├── engine.json5 Engine ports, rendering, heatmaps toggle

      │ │ ├── behaviour.json5 AI behaviour node chains and tuning presets

      │ │ ├── tactical_map.json5 Minimap keybindings, visual defaults

      │ │ ├── tactical_map_presets.json5 Display presets (sizes, styles, anchors)

      │ │ └── icon-config.json5 Icon generation source mappings

      │ ├── tactical_engine/ Engine binary + runtime

      │ │ └── TacticalEngine(.exe)

      │ ├── start-tactical-engine.sh Launcher (opens terminal, logs to file)

      │ ├── boam-icons(.exe) Icon generator

      │ ├── boam-launch.sh(.bat) Steam launch helper

      │ └── logs/ Engine log (overwritten each run)

      │ └── tactical_engine.log

      └── UserData/BOAM/

      ├── configs/ User configs (persistent, checked first)

      ├── icons/ Generated heatmap/minimap icons

      │ ├── factions/

      │ └── templates/

      └── battle_reports/ Recorded battles (auto-created per sessio