j126: read bot settings from a .env file (default ./.env, --env-file flag, TR_ENV_FILE); file wins over shell leftovers, boot report labels (source: .env)

2026-09-26 09:08:39 +02:00
parent 8e109bae0b
commit 2d8b7d7875
10 changed files with 495 additions and 6 deletions
@@ -0,0 +1,53 @@
+# Copy this file to `.env` (same folder as the bot) and edit what you need.
+# The bot reads `.env` automatically when you start it from its folder.
+# To use a different file:  ./out/ModularBot --env-file /path/to/my.env
+#
+# The file WINS over variables you exported in the shell. If a shell value
+# differs, the bot prints a warning line so you know it was overridden.
+#
+# Everything is optional. Leave a line out (or commented, with #) to keep the
+# built-in default. Values shown are the defaults.
+
+# ── movement ─────────────────────────────────────────────────────────────────
+# Which dodging engine to run: strafe (default), tfil, tfil_ring, surf.
+TR_MOVEMENT=strafe
+
+# ── gun rack: which guns the bot may choose (off | 1v1 | melee | both) ───────
+# The shipped default is Pattern only. Turn a gun on with `both`.
+TR_RACK_PATTERN=both
+#TR_RACK_TMHORIZON=both
+#TR_RACK_HEADON=both
+
+# Drop whole guns by number (comma separated ids; empty = keep all).
+GUN_RACK_DISABLE=
+
+# ── power / energy policy ────────────────────────────────────────────────────
+# 1 = use the energy-aware power cap (default). 0 = no cap (for experiments).
+TR_POWER_POLICY=1
+# Lowest cap when our own energy is low. NOTE: this is a CEILING, not a floor.
+TR_POWER_ENERGY_MIN=0.5
+
+# ── logs (set the value to 1; presence alone turns some of them on) ──────────
+# Print one line per power decision.
+#TR_POWER_LOG=1
+# Print one line per ram start/stop and why.
+#TR_RAM_LOG=1
+# Print movement band/class changes.
+#TR_MOVEMENT_LOG=1
+# Print the per-shot thinking of the TM horizon gun.
+#TR_TMHORIZON_LOG=1
+# Print one line per round result.
+TR_RESULT_LOG=1
+
+# Where the per-round gun stats and the per-shot log are written.
+GUN_STATS_PATH=/tmp/gun_stats.jsonl
+GUN_SHOTLOG_PATH=/tmp/shot_log.jsonl
+
+# ── measurement helpers (leave off unless you are measuring) ─────────────────
+#TR_RECORD_WORLDSTATE=1
+#TR_RADAR_SCANLOG=1
+#TR_TRACKER_PROBE=1
+
+# ── boot report ──────────────────────────────────────────────────────────────
+# 1 = print the [env] report on startup (default). 0 = do not print it.
+TR_ENV_REPORT=1