tool paths configurable by environment (LLAMAMOD_CD, LAMA_WINEPREFIX, LAMA_MOD, APPTEST_ROOT, APPTEST_ISO; tools/lamapaths.py), music tracks without a file on the cd marked in the editor and the tutorial uses kronk, levelbuild.py accepts the english texture names

docs/tools.md

@@ -82,8 +82,22 @@ The reverse-engineering toolkit the project started with. Python 3.8+ with `nump
 Level scripts in [`levels/`](../levels/): `testwelt.py` (the original test world),
 `sprunglabor.py` (jump lab used to measure the llama), `testwelt_parkour.seq` (scripted run).
 
-Several scripts have **hard-coded paths** to the original author's Wine setup at the top (see
-[Levels from scripts](guide/levels-in-code.md#a-python-level)).
+### Paths
+
+The tools find the original game files through these environment variables
+([`tools/lamapaths.py`](../tools/lamapaths.py)); the defaults match a hand-made Wine setup.
+Command-line options (`--base`, `--src`, `--root`, `--iso`) win over them.
+
+| Variable | Used by | Default |
+|---|---|---|
+| `LLAMAMOD_CD` | `levelbuild.py`, `debugviz.py`, `debugviz_check.py`, Gradle tests (`-Dllamamod.cd`) | `$LAMA_WINEPREFIX/iso-dk/Setup/Eng/Cd` – the CD folder (`wads/`, `music/`, `*.cor`) |
+| `LAMA_WINEPREFIX` | `lamatest.py`, `levelbuild.py --install` | `~/.wine-lama` |
+| `LAMA_MOD` | `lamatest.py` | `~/.local/bin/lama-mod`, else `tools/lama-mod` |
+| `APPTEST_ROOT` | `apptest.py` (session folders) | `$CLAUDE_JOB_DIR/tmp` if set, else `~/.cache/llamamod-apptest` |
+| `APPTEST_ISO` | `apptest.py` (first install) | `~/Downloads/GROOVE_DK.iso` |
+| `LAMATEST_DIR` | `lamatest.py` (state, logs) | `/tmp/lamatest-$USER` |
+
+A missing folder stops the tool with a message naming the variable to set.
 
 ## Testing in the game
 
@@ -93,8 +107,8 @@ Several scripts have **hard-coded paths** to the original author's Wine setup at
 | [`tools/lamatest.py`](../tools/lamatest.py) | the older harness for a hand-made Wine setup: loads a WAD as TestLevel and runs a key sequence | [notes/testharness.md](../notes/testharness.md) |
 
 Linux only; needs Wine, Xvfb, xdotool, ImageMagick, tesseract (German data, for reading menu
-texts) and PulseAudio. `apptest.py` defaults to a session root inside the author's job folder –
-set `APPTEST_ROOT`.
+texts) and PulseAudio. Session folders and the ISO: `APPTEST_ROOT`, `APPTEST_ISO` (see
+[Paths](#paths)).
 
 ```bash
 ./gradlew fatJar