Fix: add move method to _BridgeMouse, add tkinter

* fix: raise maintenance budget for cross-act routes; document Trav findings

Travincal leaves the character in Act 3, but maintenance relocates it to
Act 4 (stash at a4_tyrael_stash, repair at a4_halbu) and the next run then
needs the A3 waypoint again -- two cross-act waypoint trips per game.

That travel is not attributed to any timed step, so a FAIL> trail can show
~38s of work inside a 250s maintenance window. The 240s budget (tuned when
Pindle kept all town business in one act) was tripped 5 times in one
session, each costing a whole game. Raised to 420s.

Also documents, in HANDOVER.md:

- The open_wp failures are NOT a stale template. Scored a5_wp.png against
  all three real failure frames: 0.96-0.98 full-frame, but that match is
  the belt/mana-orb HUD false positive the a5.py comment already documents.
  Inside the real cut_skill_bar ROI it scores 0.436-0.480 against a 0.55
  threshold at scattered positions -- noise. The waypoint is genuinely not
  on screen; the character never reaches it. Recapturing would fix nothing.
  Scoring a template without the ROI the code actually uses produces a
  confident wrong answer.

- PR #39's pather abort is merged, live, and finally firing (1 abort in 21
  games, after being 0-for-152 while it looked correct).

- Keeping Trav town business in Act 3 is the real fix for both the timeouts
  and the waypoint failures. a3.py already reports can_buy_pots/can_heal/
  can_stash as True, so the Act 4 trip is not a missing capability.

- FoH vs hammerdin on the council, and the [fohdin]/[paladin] section trap:
  concentration and redemption lived in [fohdin], which hammerdin does not
  read, so both would have gone silently unbound after a respec.

Co-Authored-By: Claude Opus 5 <[email protected]>

* docs: post-mortem for the hell Travincal / hammerdin session

Narrative write-up of 29 Aug 2026: run_trav on hell, FoHdin -> hammerdin.

Outcome: health chickens 3-in-8 -> 0-in-11, battle 64-68s -> 41-60s,
failure rate 12% -> 9%, zero deaths throughout.

The document covers the four times the obvious answer was wrong:

1. Battle time did not move after the respec, which looked like failure.
   hammerdin.kill_council casts for a FIXED duration with no kill detection,
   so the clock cannot report damage -- loot proved the respec worked.

2. a5_wp.png scored 0.96-0.98 full-frame on every failure frame, which reads
   as "template fine, search broken". That match is the belt/mana-orb HUD
   false positive the a5.py comment already documents. Inside the real
   cut_skill_bar ROI it scores 0.436-0.480 against a 0.55 threshold at
   wandering positions -- noise. The waypoint was never on screen.

3. Ormus: not masked (4-channel but fully opaque, so no mask is passed), and
   not a threshold problem (in-ROI best 0.342, background level -- lowering
   the bar would recreate the Bug 4 false-positive clicks). A3 town has
   frames with ZERO pather landmarks over threshold, so the character never
   arrives. One cause, three symptoms.

4. Reverses this session's own earlier recommendation to move Trav town
   business into Act 3. That was reasoned from a3.py reporting can_buy_pots/
   can_heal/can_stash as True -- a capability check, not evidence about
   pathing. A3 is the worst-supported town in the project.

Also documents three settings that were live but inert: binds under [fohdin]
which hammerdin never reads, casting_frames=8 (unreachable -- a paladin's
fastest cast is 10 frames, so every cast was cut short), and repair_npc=
a5_larzuk, which Bug 12 set to keep repair in-act for Pindle but which forces
a cross-act trip on Trav (35.8s vs 9.0s).

And a caution on the key auto-detector: it reported the wrong stand_still
bind both before and after a live remap, consistent with a stale .keyo read.

Co-Authored-By: Claude Opus 5 <[email protected]>

* docs: correct stale hammerdin migration notes in HANDOVER (Codex review)

Addresses Codex feedback on PR #40: the handover still described the character
as needing conversion to hammerdin with both skills blank, while the same commit
verified type=hammerdin and concentration='f6' loading live.

The conflict was worse than reported. The stale "Two things only you can do"
section instructed the operator to rebind F7 -> Concentration, but F7 is
Battle Orders (CTA). Following it would have overwritten the CTA bind and cost a
large share of the life pool -- the exact problem this session was fixing.

- Replaces the migration paragraph with the verified end state, and records that
  Blessed Hammer lives on LEFT-CLICK, not an F-key (_cast_hammers puts the aura
  on the right slot, so a hammer hotkey would replace it).
- Notes that concentration/redemption had to move into [paladin]; under [fohdin]
  a hammerdin never reads them and both would be silently unbound.
- Adds the full verified bind map so F7 cannot be reassigned by mistake.
- Rewrites the operator TODOs: fire resist is superseded (Zaka + Mara took
  chickens 3-in-8 -> 0-in-11); the live items are lightning/poison resist and
  the 75% FCR breakpoint, with the casting_frames mapping (75%=11, 60%=12,
  <48%=13) so cast timing tracks any gear change.

Co-Authored-By: Claude Opus 5 <[email protected]>

* feat: baal_xp farm — game browser join, hide-and-wait state, config

- src/ui/game_browser.py: retry-wrapped join flow (Play -> Join Game tab ->
  OCR game list -> click row -> loading/InGame confirm), wait_for_in_game
- src/bot.py: 'baal_xp' state + run_baal_xp/end_run transitions;
  on_run_baal_xp: fast_save_and_exit -> hero select -> join public game ->
  corpse/nopickup/pre_buff -> walk to hide spot -> wait loop (XP every 30s,
  HP check, death recovery, InGame-miss re-anchor) -> leave -> recover to
  own game; on_end_run short-circuit straight to maintenance
- src/config.py: [baal_xp] section (enabled, game_name_filter, max_wait_s,
  xp_threshold, min_hp_pct, hide_x/y, join_timeout_s) with profile overrides
- config/params.ini: [baal_xp] section, order=run_baal_xp, run_trav
- profile paladalla: order=run_baal_xp, run_trav (profile routes override
  base config — without this the route never activates)
- stealth: daily budget cap (persisted, restart-proof), buy at A4 Jamella
  from A3 too (Ormus measured unreliable), session budget 20h

* fix: import mouse in bot.py (baal_xp hide-spot click)

* feat(stealth): hard per-day runtime cap that survives restarts, and quit D2R

session_budget_h is per PROCESS. Every restart re-rolls it, so a bot that gets
restarted -- by the user, or by the restart-on-crash path -- can run all day and
never trip it. That is exactly the signal a runtime cap is meant to remove. It
also silently failed in practice: params.ini still carried the temporary
levelling value session_budget_h = 20, which rolls 13-27h, so the live config
could not stop the bot within a day at all. Restored to 8.

Adds daily_budget_h, keyed on the CALENDAR DATE and persisted to
log/.daily_runtime.json, so restarts cannot hand out a fresh allowance.

Design points that matter:

- The rolled target is stored WITH the date. Re-rolling per process would make
  restarting a way to draw a bigger budget; once a day's target is chosen it is
  fixed until the date changes.
- Jitter subtracts ONLY. daily_budget_h is a ceiling, not an average: a
  two-sided roll on 8h could hand out 9h, which is not what "cap it at 8 hours"
  means. 8 with 0.12 jitter now runs 7.0-8.0h and never more. Verified over 300
  rolls: min 7.04h, max exactly 8.00h.
- Time before the first tick in a process is not counted, so a crash
  under-counts rather than over-counts -- the safe direction for a cap.

Also closes D2R when the cap trips (daily_budget_close_game, default on). The
check runs in on_end_game AFTER save-and-exit, so the character is at the menu
with nothing in progress and nothing is lost -- this is not the mid-game force
kill that leaves D2R unenterable. A bot parked at character select for 16h is
itself the pattern the cap exists to remove; a real player quits the game.

The stealth manifest reports daily_budget by checking the CALL SITE in bot.py,
not just the config value -- the lesson from chicken_variance and the AFK break
that was 0-for-225 while the manifest said "wired".

Co-Authored-By: Claude Opus 5 <[email protected]>

---------

Co-authored-by: alexpolo1 <[email protected]>
Co-authored-by: Claude Opus 5 <[email protected]>

.coveragerc

@@ -1,8 +1,21 @@
 # .coveragerc to control coverage.py
 [run]
 branch = True
+source = src
+# Exclude conda/xonsh internal shims that leak into coverage data. The phantom
+# is an absolute path like D:\a\...\config-3.py, so a bare "config-3.py" omit
+# never matches — use a glob that matches any path ending in config-<n>.py.
+omit =
+    *config-*.py
+    */site-packages/*
+    */conda-meta/*
+
+[xml]
+output = coverage.xml
 
 [report]
+# Ignore missing source files (conda shims reference files not in tree)
+ignore_errors = True
 # Regexes for lines to exclude from consideration
 exclude_lines =
     # Have to re-enable the standard pragma

.env

@@ -1 +0,0 @@
-PYTHONPATH=./src

.env.example

@@ -0,0 +1,25 @@
+# Botty personal environment overrides.
+# Copy this file to ".env" in the repo root and edit your values there.
+# ".env" is ignored by git and should never be committed.
+#
+# Format: BOTTY_<CONFIG_KEY>=<value>
+# These override values from config/params.ini and config/custom.ini at runtime.
+#
+# Common personal settings:
+
+# Bot display/account name used in logs/Discord usernames.
+# BOTTY_NAME=zapzap
+
+# Main Discord webhook (status/death/chicken/general messages).
+# BOTTY_CUSTOM_MESSAGE_HOOK=https://discord.com/api/webhooks/...
+
+# Optional dedicated loot webhook for item drops.
+# BOTTY_CUSTOM_LOOT_MESSAGE_HOOK=https://discord.com/api/webhooks/...
+
+# Optional auto-login credentials (keep private).
+# BOTTY_BNET_NAME=your-battlenet-email-or-name
+# BOTTY_BNET_PASS=your-battlenet-password
+# BOTTY_CHAR_NAME=your-character-name
+
+# Optional path override if you reference it in params.ini:
+# BOTTY_SAVED_GAMES_FOLDER=C:\Users\you\Saved Games\Diablo II Resurrected

.github/workflows/ci.yml

@@ -1,52 +1,209 @@
-name: Botty - CI
-on: [pull_request]
+name: CI
+
+on:
+  push:
+    branches: [main, stable]
+  pull_request:
+    branches: [main, stable]
+
+# Cancel in-progress runs on new push
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
 jobs:
-  tests:
-    runs-on: windows-latest
+  install-and-test:
+    name: Install & Test
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - name: Setup Miniconda Python 3.10
-        uses: actions/setup-python@v2
+      - name: Checkout (skipped - workspace pre-populated)
+        run: echo "Using pre-populated workspace"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          python-version: '3.10'
-      # TODO: The below setp only chaches conda packages, need to cache pip seperatly
-      - name: Cache conda
-        uses: actions/cache@v2
+          python-version: "3.10"
+          # cache disabled for act_runner
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Install Tesseract OCR
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y tesseract-ocr libgl1 libglib2.0-0 python3-tk
+
+      - name: Python version
+        run: python -c "import sys; print(sys.version)"
+
+      - name: Syntax check
         env:
-          # Increase this value to reset cache if environment.yml has not changed
-          CACHE_NUMBER: 1
-        with:
-          path: ~/conda_pkgs_dir
-          key: conda-${{ env.CACHE_NUMBER }}-${{hashFiles('environment.yml') }}
-      - name: Cache pip
-        uses: actions/cache@v2
+          PYTHONPATH: ./src
+        run: python -m compileall -q src tools test scripts
+
+      - name: Verify core imports
         env:
-          # Increase this value to reset cache if environment.yml has not changed
-          CACHE_NUMBER: 1
+          PYTHONPATH: ./src
+        run: |
+          python -c "
+          import sys
+          sys.path.insert(0, 'src')
+          modules = [
+              'config',
+              'logger',
+              'screen',
+              'pather',
+              'template_finder',
+              'game_stats',
+              'health_manager',
+              'death_manager',
+              'd2r_image',
+              'item',
+              'item.pickit',
+              'transmute',
+              'shop',
+              'char',
+              'utils',
+              'utils.os_detect',
+              'messages',
+          ]
+          for mod in modules:
+              try:
+                  __import__(mod)
+                  print(f'  {mod}: OK')
+              except ImportError as e:
+                  print(f'  {mod}: FAILED - {e}')
+                  sys.exit(1)
+          print('All core imports successful.')
+          "
+
+      - name: Verify botty runs (import main modules)
+        env:
+          PYTHONPATH: ./src
+        run: |
+          python -c "
+          import sys, os
+          sys.path.insert(0, 'src')
+          import ssl
+          ssl.SSLContext.load_default_certs = lambda *a, **k: None
+
+          from version import __version__
+          print(f'  Version: {__version__}')
+
+          from config import Config
+          print('  Config: OK')
+
+          from game_controller import GameController
+          print('  GameController: OK')
+
+          from bot import Bot
+          print('  Bot: OK')
+
+          from run.diablo import Diablo
+          print('  Diablo run: OK')
+
+          from run.pindle import Pindle
+          print('  Pindle run: OK')
+
+          from run.arcane import Arcane
+          print('  Arcane run: OK')
+
+          from run.vizier import Vizier
+          print('  Vizier run: OK')
+
+          print('All botty entry modules import successfully.')
+          "
+
+      - name: Verify OCR (pytesseract)
+        env:
+          PYTHONPATH: ./src
+        run: |
+          python -c "
+          import sys, os, tempfile
+          sys.path.insert(0, 'src')
+
+          import pytesseract
+          pytesseract.pytesseract.tesseract_cmd = '/usr/bin/tesseract'
+
+          import cv2
+          import numpy as np
+
+          version = pytesseract.get_tesseract_version()
+          print(f'  Tesseract version: {version}')
+
+          # Create a simple test image with text
+          img = np.full((50, 200), 255, dtype=np.uint8)
+          cv2.putText(img, 'Hello Botty', (20, 35),
+              cv2.FONT_HERSHEY_SIMPLEX, 0.8, (0, 0, 0), 1)
+
+          with tempfile.NamedTemporaryFile(suffix='.png', delete=False) as f:
+              cv2.imwrite(f.name, img)
+              text = pytesseract.image_to_string(f.name, lang='eng').strip()
+              print(f'  OCR result: {text}')
+
+          print('OCR pytesseract: OK')
+          "
+
+      - name: Verify OCR (botty ocr module)
+        env:
+          PYTHONPATH: ./src
+          PYTESSERACT_TESSERACT_CMD: /usr/bin/tesseract
+        run: |
+          python -c "
+          import sys, os
+          sys.path.insert(0, 'src')
+
+          # Import the botty OCR module - it reads PYTESSERACT_TESSERACT_CMD from env
+          from d2r_image.ocr import image_to_text, pytesseract
+          import cv2
+          import numpy as np
+          import tempfile
+
+          if pytesseract is None:
+              print('  pytesseract not available — skipping')
+              sys.exit(0)
+
+          # Create test image (3-channel for invert)
+          img = np.full((50, 200, 3), 255, dtype=np.uint8)
+          cv2.putText(img, '123', (80, 35),
+              cv2.FONT_HERSHEY_SIMPLEX, 1.0, (0, 0, 0), 2)
+
+          # Run through botty's image_to_text
+          results = image_to_text(
+              [img],
+              model='hover-eng_inconsolata_inv_th_fast',
+              psm=7,
+              crop_pad=False,
+              invert=True,
+              threshold=25,
+          )
+          result_text = results[0].text if results else 'empty'
+          print(f'  OCR result: {result_text}')
+          print('OCR botty module: OK')
+          "
+
+      - name: Log analyzer tests (self-healing framework)
+        env:
+          PYTHONPATH: ./src:.
+          RUN_ENV: test
+        run: |
+          python -m pytest test/auto/test_log_analyzer.py -v --tb=short
+
+      - name: Tests with coverage
+        env:
+          PYTHONPATH: ./src:.
+          RUN_ENV: test
+        run: |
+          python -m coverage run -m pytest -v --tb=short --ignore=test/auto/test_self_healing.py --ignore=test/smoke_test.py --ignore=test/test_version_consistency.py
+          python -m coverage xml --ignore-errors || true
+
+      - name: Upload coverage
+        uses: actions/upload-artifact@v4
+        if: always()
+        continue-on-error: true
         with:
-          path: ~/pip
-          key: pip-${{ env.CACHE_NUMBER }}-${{ hashFiles('environment.yml') }}
-      - name: Install Miniconda
-        uses: conda-incubator/setup-miniconda@v2
-        with:
-          python-version: '3.10'
-          activate-environment: botty
-          channel-priority: strict
-          environment-file: environment.yml
-          use-only-tar-bz2: true # Needed for caching
-      - name: Activate conda
-        shell: powershell
-        run: |
-          C:\Miniconda\condabin\conda.bat init powershell
-          set PYTHONPATH=./src
-      - name: Pytest & Coverage
-        shell: powershell
-        run: |
-          C:\Miniconda\condabin\conda.bat activate botty
-          python -c "import sys; print(sys.version)"
-          coverage run --source=./src -m pytest -v -s
-      - name: Coverage Report Generation
-        shell: powershell
-        run: |
-          C:\Miniconda\condabin\conda.bat activate botty
-          coverage xml
+          name: coverage-report
+          path: coverage.xml
+          retention-days: 7

.gitignore

@@ -15,18 +15,79 @@ botty_v*/
 custom.ini
 config/custom.ini
 config/custom.*.ini
+config/*.local.ini
 .vscode
 .vs/
-test/assets/
+# Logs and run reports
+log/
+log/archive/
+log/runs/
+log/stats/
+*.log
+
+# Scraped data (cached web pages, URLs)
+data/d2jsp_pages/
+data/d2jsp_topic_urls.txt
+
+# Debug files
+debug_*.png
+debug_forum.html
+
+# Dev tools (moved to tools/)
+asset_extractor.py
+asset_manager.py
+build.py
+desktop_snap.py
+development.md
+quest_debug.py
+quest_plan.md
+quest_screenshot_tool.py
+references/improvements.md
+run_asset_extractor.bat
+run_chipped_gems.bat
+run_gems_all.bat
+run_quest_debug.bat
+screenshot_tool.py
+start_bot_detached.bat
+start_botty.ps1
+test_plan.md
+update.bat
+
+# Generated/runtime price data (updated automatically by bot)
+config/fg_daily_estimates.json
+config/fg_prices.json
+config/fg_prices.db
+config/daily_prices.json
+config/daily_prices_history.json
+config/traderie_prices.json
+
+# Screenshots (debug/test captures)
+screenshots/
+
+# Tools dev cache
+tools/__pycache__/
+
+# Build artifacts
+botty_v*/
+botty_v*.zip
+
 .venv
+.env
+.env.*
+!.env.example
 *.bak
 .coverage
 htmlcov/
+
+# Secrets / account-specific — never commit
+cookies.txt
+cookies_temp*
+*.cookies
+config/custom.ini
 coverage.xml
 utils/live-view/
-config/nip/*
-!config/nip/.gitkeep
-
+config/bnip/*
+!config/bnip/.gitkeep
 stats/
 info_screenshots/
 item_error_screenshots/
@@ -34,5 +95,32 @@ loot_screenshots/
 pickit_screenshots/
 *info_log_parsed.txt
 *info_*.png
-*.log
-log/
+blizzpw.txt
+
+# Local user/workspace files
+.claude/
+GEMINI.md
+test_config_load.py
+
+# Debug directory
+botty_debug/
+
+# per-user character profiles (survive git pulls)
+config/profiles/
+config/active_profile.txt
+
+# Docker / dev-only files (not production)
+.dockerignore
+Dockerfile
+docker-compose.yml
+docker-*.bat
+DOCKER.md
+botty_next/
+src/bridge_server.py
+src/input_layer/bridge_input.py
+.hermes/
+fixtures/
+test/run/
+
+# Installer output (generated by run_install_capture.bat)
+install_log.txt

ARCHITECTURE.md

@@ -0,0 +1,345 @@
+# Botty Architecture
+
+## Overview
+
+Botty is an autonomous bot for Diablo II Resurrected (D2R) that uses computer vision and native Windows API input to run endgame content without kernel drivers. It's built in Python 3.10 and distributed as a PyInstaller onefile executable.
+
+## Entry Points
+
+Two standalone executables are built from the same source:
+
+| Executable | Source | Purpose |
+|---|---|---|
+| `main.exe` | `src/main.py` | Main bot controller |
+| `shop.exe` | `src/shopper.py` | Standalone vendor shopping |
+
+## Threading Model
+
+main.py spawns three concurrent threads:
+
+```
+main.py (main thread)
+├── game_controller.py (bot loop thread)
+│   └── bot.py (state machine thread)
+├── health_manager.py (background thread)
+└── death_manager.py (background thread)
+```
+
+- **Main thread**: Shows UI, registers hotkeys (F7-F12), calls `keyboard.wait()` to block
+- **Game Controller**: Orchestrates the bot loop - starts/stops the bot thread, handles game recovery, tracks stats
+- **Health Manager**: Polls health/mana/merc every ~1s, auto-potions, chickens when low
+- **Death Manager**: Polls every ~1s for "You Have Died" screen, triggers recovery
+
+## Core Modules
+
+### Input Layer (`src/input_layer/`)
+
+Native Windows API input replacement designed to evade kernel-level anti-cheat (Warden). It bypasses common Python libraries like `pyautogui` or `pynput` which can be easily detected.
+
+| File | Purpose |
+|---|---|
+| `win_input.py` | Low-level `ctypes` wrappers for `SendInput`, `GetAsyncKeyState`, `GetCursorPos`. Uses standard Windows user-mode APIs. |
+| `mouse_impl.py` | Humanized mouse controller. Features include: Bezier curve trajectories, Gaussian noise (hand tremor), endpoint wobble, and randomized arrival-to-click delays. |
+| `hotkey.py` | Polling-based hotkey manager that avoids global hooks. All polling intervals include micro-jitter. |
+| `__init__.py` | Drop-in API that shims standard input calls with stealth timing and variable duration automatically. |
+
+All key presses include stealth micro-pauses and variable press duration automatically.
+
+### Screen Capture (`src/screen.py`)
+
+Handles D2R window detection and screenshot capture via MSS library. Converts between coordinate systems: Monitor (top-left first monitor), Screen (per-monitor), Absolute (character center), Relative (template-matched).
+
+### Image Recognition (`src/template_finder.py`)
+
+Template matching via OpenCV (`cv2.matchTemplate`). Searches against pre-captured asset templates in `assets/templates/`. Returns match position and validity.
+
+**Asset conventions — read before adding or recapturing any template:**
+
+- Every `.png` under the `TEMPLATE_PATHS` roots is loaded recursively and keyed by its
+  **uppercased filename** (`a5_red_portal.png` → `A5_RED_PORTAL`). Keys are one flat
+  namespace across all roots, so filenames must be globally unique — and **never leave a
+  backup or scratch `.png` anywhere under `assets/`**, or it silently becomes a live
+  template.
+- **Keep templates fully opaque (3-channel, or 4-channel with no zero-alpha pixel).**
+  `alpha_to_mask` only produces a mask when the image has 4 channels *and* contains a
+  fully transparent pixel; that mask is then passed to
+  `cv2.matchTemplate(..., TM_CCOEFF_NORMED, mask=...)`. **OpenCV only properly supports
+  masks for `TM_SQDIFF` and `TM_CCORR_NORMED`** — masked `TM_CCOEFF_NORMED` returns
+  unreliable scores and wandering match positions. A masked template will appear to
+  "work" in isolation and then fail at random. See CLAUDE.md Bug 23.
+- Crop something **structurally stable and unoccluded**. Animated or partly hidden
+  features (a swirling portal's interior, a ring occluded by scenery) make poor anchors.
+- **Validate on held-out frames**: build the crop from one capture, score it against
+  *other* captures, and — critically — against frames where the subject is **absent**.
+  A template that scores high on both is matching background, not the subject. Aim for a
+  clear gap straddling the 0.68 default threshold.
+
+### UI Detection (`src/ui/`)
+
+| File | Detects |
+|---|---|
+| `main_menu.py` | Main menu buttons (play, save & exit) |
+| `character_select.py` | Character portraits and selection |
+| `skills.py` | Skill bar state, skill availability |
+| `meters.py` | Health/mana globes, potion charges |
+| `player_bar.py` | Player status bar, XP bar |
+| `view.py` | Minimap, inventory screen detection |
+| `waypoint.py` | Waypoint portal selection |
+| `error_screens.py` | Error dialogs, death screen |
+| `loading.py` | Loading screen detection |
+
+### Pathing (`src/pather.py`)
+
+Pathfinding via reference template matching with relative coordinates. Each location has numbered nodes with template references. The `Location` class defines named destinations (towns, dungeons). Path definitions map (start, end) pairs to node sequences.
+
+### Character System (`src/char/`)
+
+Inheritance hierarchy:
+
+```
+IChar (abstract base)
+├── Basic / Basic_Ranged
+├── Paladin
+│   ├── Hammerdin
+│   └── FoHdin
+├── Sorceress (base for all sorc builds)
+│   ├── BlizzSorc
+│   ├── BlizzorbSorc
+│   ├── NovaSorc
+│   ├── LightSorc
+│   └── HydraSorc
+├── Amazon
+│   └── Javazon
+├── Trapsin
+├── Barbarian
+├── Necro
+├── Poison_Necro
+├── Bone_Necro
+└── Warlock
+    ├── FireLock
+    ├── EchoLock
+    └── AbyssLock
+```
+
+Each character class implements: run methods, skill usage, attack patterns, position-specific behavior.
+
+### Run System (`src/run/`)
+
+| File | Run |
+|---|---|
+| `pindle.py` | Pindle of Purity |
+| `shenk_eld.py` | Shenk + Eldritch |
+| `trav.py` | Travincal |
+| `nihlathak.py` | Nihlathak's Temple |
+| `arcane.py` | Arcane Sanctuary |
+| `diablo.py` | Chaos Sanctuary + Diablo |
+| `vizier.py` | Vizier (Seal Boss) |
+| `baal.py` | Baal |
+| `mephisto.py` | Mephisto |
+| `andariel.py` | Andariel |
+| `countess.py` | Countess |
+| `level.py` | General leveling runs |
+
+### Town System (`src/town/`)
+
+`TownManager` orchestrates act-specific town routines. Each act (A1-A5) has its own module with NPC interactions, waypoint usage, and stash handling.
+
+### Inventory (`src/inventory/`)
+
+| File | Purpose |
+|---|---|
+| `belt.py` | Belt slot management, potion detection |
+| `personal.py` | Personal inventory grid, item positions |
+| `vendor.py` | Vendor trade window |
+| `stash.py` | Personal stash, shared stash |
+| `cube.py` | Horadric Cube |
+| `common.py` | Shared inventory utilities |
+
+### Item Recognition (`src/item/`)
+
+| File | Purpose |
+|---|---|
+| `pickit.py` | Pickup decisions, item filtering |
+| `consumables.py` | Potion and consumable identification |
+
+BNIP parser (`src/bnip/`) handles item filter rules from `.bnip` files.
+
+### Transmute (`src/transmute/`)
+
+Gem transmutation: collects gems from inventory/stash, performs cube recipes, manages stash destinations.
+
+### Messages (`src/messages/`)
+
+| File | Purpose |
+|---|---|
+| `messenger.py` | Message dispatcher |
+| `discord_embeds.py` | Discord webhook formatting |
+| `generic_api.py` | Generic HTTP webhook support |
+
+### Configuration (`src/config.py`)
+
+Singleton that merges config files in priority order:
+`custom.ini` > `params.ini` > `game.ini` > `shop.ini` > `transmute.ini`
+
+Supports variable substitution via `[variables]` sections.
+
+### Stealth System (`src/utils/stealth.py`)
+
+A multi-tiered approach to mimicking human behavior and evading detection:
+
+- **Tier 1: Input Stealth**: Automatic micro-pauses (20-120ms), variable key press durations (20-200ms), and non-linear mouse paths via `input_layer`.
+- **Tier 2: Behavioral Stealth**: Probabilistic "mistakes" such as clicking the wrong waypoint (2.5% chance) or skill hesitation (80-300ms) before casting.
+- **Tier 3: Session Stealth**: Randomized run durations (+/-15%), AFK breaks (2-12 mins), and shuffling of farming routes between rotations.
+
+All timing across the bot is routed through `utils.misc.wait()`, which applies Gaussian jitter to every sleep call.
+
+### Utilities (`src/utils/`)
+
+| File | Purpose |
+|---|---|
+| `misc.py` | Window management, DPI awareness, timing utilities |
+| `restart.py` | Game launch/kill, D2R always-on-top |
+| `auto_settings.py` | D2R game settings adjustment |
+| `key_detector.py` | Auto-detect skill bindings from `.key`/`.keyo` files |
+| `graphic_debugger.py` | Visual debugging overlay |
+| `node_recorder.py` | Record new path nodes |
+| `stealth.py` | Stealth behavior randomization |
+
+### Auxiliary Tools
+
+Standalone tools located in the root directory for project maintenance and development:
+
+- `asset_manager.py`: Unified interface for auditing, searching, and optimizing template assets.
+- `asset_extractor.py`: Screenshot capture and AI-assisted entity cropping workflow.
+- `build.py`: PyInstaller wrapper for building production executables.
+- `desktop_snap.py`: Lightweight tool for capturing full desktop screenshots.
+- `quest_debug.py`: Debugging interface for the questing system.
+- `screenshot_tool.py`: Simple utility for taking D2R client area screenshots.
+
+## Data Flow
+
+```
+D2R Game Window
+       │
+       ▼
+  screen.grab() ──→ Image (numpy array)
+       │
+       ▼
+  template_finder.search() ──→ Position + Validity
+       │
+       ▼
+  ui_manager.detect_screen_object() ──→ Current UI state
+       │
+       ▼
+  bot.py (state machine) ──→ Decides next action
+       │
+       ▼
+  char.run() / pather.go_to() ──→ Movement + Interaction
+       │
+       ▼
+  input_layer.keyboard.send() / mouse.click() ──→ SendInput API
+       │
+       ▼
+  D2R Game Window (response captured on next grab)
+```
+
+## Build System
+
+- **Build script**: `build.py` (PyInstaller with `--onefile --noconsole`)
+- **Dependencies**: `pyproject.toml`
+- **Distribution**: Random exe name, no console window, no kernel drivers
+- **Assets**: `assets/` directory copied to build output
+
+## Key Detection
+
+At startup, `key_detector.py` reads the character's `.key`/`.keyo` file from `Saved Games/Diablo II Resurrected/` to auto-detect skill bindings and non-skill keys (inventory, show items, etc.). This eliminates manual key configuration.
+
+Slot-to-key mapping (`CHAR_BINDING_SLOTS`):
+| Slot | Config key |
+|---|---|
+| 41 | `show_belt` |
+| 36 | `stand_still` |
+| 44 | `weapon_switch` |
+| 43 | `force_move` |
+
+If params.ini and the `.keyo` file disagree, params.ini wins and a `"Keeping configured key binding"` line is logged. No disagreement = no log line.
+
+## Coordinate Systems
+
+| System | Origin | Used By |
+|---|---|---|
+| Monitor | Top-left of first monitor | `screen.grab()` |
+| Screen | Per-monitor client area | UI detection |
+| Absolute | Character at screen center | Pathing, target detection |
+| Relative | Template match position | Inventory grid, NPC interaction |
+
+Conversion functions in `screen.py`: `convert_monitor_to_screen()`, `convert_screen_to_abs()`, etc.
+
+## State Machine
+
+`bot.py` uses the `transitions` library. States and transitions are defined at `Bot.__init__` time.
+
+**States**: `initialization`, `hero_selection`, `town`, `level`, `pindle`, `shenk`, `trav`, `nihlathak`, `arcane`, `diablo`, `vizier`, `baal`, `mephisto`, `andariel`, `countess`
+
+**Key transitions**:
+
+| Trigger | Source | Dest | Notes |
+|---|---|---|---|
+| `init` | initialization | initialization | Screen detection, routes to create_game or start_from_town |
+| `select_character` | initialization | hero_selection | |
+| `start_from_town` | initialization/hero_selection | town | |
+| `maintenance` | town | town | Heal, buy pots, stash, repair, resurrect merc |
+| `run_pindle` | town | pindle | |
+| `run_arcane` | town | arcane | |
+| `end_run` | any run state | town | TP back; calls `on_end_run` which TPs to town |
+| `end_game` | town/any run state | initialization | Save & exit; use when no TP scrolls or unrecoverable |
+
+`end_run` requires working TP scrolls. If charges = 0, trigger `end_game` instead — otherwise the bot loops trying to TP back indefinitely.
+
+## HealthManager — Internal Timing
+
+The background health monitor (`src/health_manager.py`) polls at:
+
+```
+interval = max(0, (3/25 - fn_elapsed) * jitter(0.8–1.2))
+```
+
+That's approximately every 3 game frames (96–144ms at 25 FPS). The jitter prevents perfectly regular polling patterns from being detectable.
+
+**Rejuv logic**:
+1. Minimum 0.60s between rejuv drinks (hit recovery guard).
+2. Drinks rejuv if `health ≤ take_rejuv_potion_health` OR `mana ≤ take_rejuv_potion_mana`.
+3. "Double rejuv" chicken fires only if `last_drink < 8s` **AND** `health ≤ take_rejuv_potion_health`.
+   - The HP check is critical: mana-triggered rejuvs can legitimately fire back-to-back at full HP (Hammerdin spending mana fast). Without the HP check, false chickens occur at 99.9% HP.
+
+## PickIt — Item Identity
+
+`GroundItem` has two identity fields:
+
+| Field | Formula | Purpose |
+|---|---|---|
+| `ID` | `slugify(Name + all as_dict() values including Amount)` | Pickit cache key; different gold amounts = different IDs |
+| `UID` | `ID + screen center position` | Deduplication within a single items list; same pile at same coords = same UID |
+
+The fail-detection in `_pick_up_item` uses `item.ID == prev.ID` for gold and `item.UID == prev.UID` for everything else. Two nearby gold piles with different amounts bypass the ID check since they produce different IDs.
+
+`_yoink_item()` always returns `PickedUpResult.PickedUp` regardless of actual success. True pickup failures surface only through `_pick_up_item`'s same-ID/UID repeat detection. On confirmed failure, the item's `ID` is blacklisted in `_cached_pickit_items` so it isn't retried in the same session.
+
+## Configuration Priority
+
+Merge order (highest priority first):
+
+```
+custom.ini > params.ini > game.ini > shop.ini > transmute.ini
+```
+
+`Config` is a singleton (`__new__` + `data_loaded` class variable). First instantiation loads all files; subsequent calls return the same instance. Key detection runs during `__init__` after `self.char` is populated.
+
+## Known Architectural Issues
+
+See `IMPROVEMENTS.md` for the full list. Highest-priority unresolved items:
+
+- **C10**: `kill_thread()` uses `PyThreadState_SetAsyncExc` (CPython private API). Can corrupt locks/GIL. Replace with `threading.Event` cooperative shutdown.
+- **H12/H14**: Health/death managers use module-level globals for state. HealthManager now has a `_state_lock`; death manager does not yet.
+- **M14**: `PickedUpResult` enum has a gap (values 0,1,3,4,5 — missing 2).
+- **H10/H11**: `pather.py` (750 lines) and `config.py` are oversized and should be split.

DEPENDENCIES.md

@@ -0,0 +1,44 @@
+# Botty working-state dependencies (verified 2026-06-11)
+
+Everything required for the bot to run as well as it did during the verified
+full Diablo runs on 2026-06-11. If a future setup misbehaves, diff against this.
+
+## Runtime stack
+| Layer | Requirement | Verified value |
+|---|---|---|
+| Python env | conda env `botty` | `C:\ProgramData\miniforge3\envs\botty` (python 3.10.14) — NOTE: `C:\Users\alex\miniforge3\envs\botty` is a broken leftover (no python.exe); `find_python.bat` skips it correctly |
+| OCR binary | Tesseract 5.5.0 (winget) | `C:\Program Files\Tesseract-OCR\tesseract.exe` — wired in `src/d2r_image/ocr.py` (env var `PYTESSERACT_TESSERACT_CMD` → PATH → this default). Conda tesseract must stay UNINSTALLED (access violations) |
+| OCR backend | pytesseract fallback | tesserocr wheel is DLL-broken (needs Tesseract 4.x libs) — pytesseract is the working path; startup logs `OCR backend: pytesseract (fallback)` |
+| Launcher | `run_botty.bat` | sets conda-like PATH, UTF-8, TESSDATA. No exe build exists — bot always runs current source |
+
+## Key python packages (installed, working)
+```
+opencv-python==4.5.5.64   numpy==1.26.4        pytesseract==0.3.13
+mss==7.0.1                beautifultable==1.1.0 colorama==0.4.6
+discord.py==2.7.1         aiohttp==3.14.1       certifi==2026.5.20
+pillow==12.2.0            rapidfuzz==2.15.1     pywin32==312
+psutil==7.2.2             cryptography==48.0.1
+```
+
+## D2R requirements (template matching breaks without these)
+- Settings must match `assets/d2r_settings.json` — startup warns loudly if not.
+  Verified in-game 2026-06-11: 1280x720 windowed, resolution scale 100, DLSS OFF,
+  AA OFF, AO OFF, texture HIGH, character/environment/transparency/shadow LOW.
+  (DLSS ON was the root cause of the CS template failures earlier that day.)
+- Window: bot enforces client area at (5, 98) size 1280x720 (`enforce_d2r_window`).
+- Keybinds file: `C:\Users\alex\Saved Games\Diablo II Resurrected\Fistman*.keyo`
+  (auto-parsed at startup). Skill hotkeys in `config/params.ini` must match the
+  in-game skill assignments: blessed_hammer=f1, holy_shield=f2, redemption=f3,
+  vigor=f4, conviction=f5, concentration=f8, teleport=b, BO=7, BC=8.
+  Use `tools/capture_skill_hotkeys.py` to verify/capture them from the live game.
+- Char: hammerdin "fistman", Hell, CTA swap on weapon slot 2.
+
+## Host specifics
+- Windows 11 build 26200, display 1920x1200 physical at 125% scaling (1536x960
+  logical). D2R renders 1:1 physical. Any DPI-unaware automation (PowerShell
+  SetCursorPos/mouse_event) lands 1.25x off — use the bot's input_layer from the
+  conda env with `SetProcessDPIAware()` instead.
+- Mouse mode: relative (Win11) with SetCursorPos retry fallback (`win_input.py`).
+- `max_consecutive_fails=5`, `max_game_length_s=900`, maintenance timeout ~280s,
+  per-game WP failure budget = 2 (town_manager) are the safety nets that keep a
+  bad game cheap.

FIRST-RUN.md

@@ -0,0 +1,171 @@
+# Botty First Run Guide
+
+After running `install.bat` and seeing "Installation complete!", follow these steps.
+
+---
+
+## Step 1 — Create your character profile
+
+Botty uses **profiles** to store your character setup. Each profile is a single file in `config/profiles/`.
+
+### Find your character type
+
+Open `config/params.ini` in Notepad, scroll to `[char]`, find `type=`:
+
+| If you play... | Set `type=` to |
+|---|---|
+| Hammerdin Paladin | `hammerdin` |
+| FoH Paladin | `fohdin` |
+| Blizzard Sorceress | `sorceress` |
+| Bone Necromancer | `necro` |
+| Traps Assassin | `trapsin` |
+| Amazon | `amazon` |
+| Barbarian | `barbarian` |
+| Warlock Druid | `warlock` |
+
+### Set your keybinds
+
+In `config/params.ini`, scroll to `[char]` and match these to your D2R key bindings:
+
+```ini
+[char]
+type=hammerdin              ; your build (see table above)
+tp_key=b                    ; Teleport key
+stand_still=capslock        ; Hold to stand still (capslock is common)
+show_belt=k                 ; Open belt
+weapon_switch=w             ; Swap weapons (for CTA builds)
+force_move=e                ; Force movement through mobs
+```
+
+**Important:** `stand_still` cannot be `shift` (conflicts with merc healing). `capslock` is the recommended default.
+
+### Pick your runs
+
+Scroll to `[routes]` in `config/params.ini`:
+
+```ini
+[routes]
+; Enable the runs you want (1 = on, 0 = off)
+run_pindle=1                ; Act 5 Nihlathak temple red portal boss
+run_countess=0              ; Act 1 Forgotten Tower
+run_andariel=0              ; Act 1 Catacombs
+run_arcane=0                ; Act 2 Arcane Sanctuary / Summoner (teleport recommended)
+run_trav=0                  ; Act 3 Travincal council
+run_mephisto=0              ; Act 3 Durance of Hate
+run_diablo=0                ; Act 4 Chaos Sanctuary (teleport recommended)
+run_vizier=0                ; Act 4 Chaos, Vizier only (faster than full Diablo)
+run_nihlathak=0             ; Act 5 Halls of Vaught (teleport recommended)
+run_eldritch=0              ; Act 5 Frigid Highlands, Eldritch only
+run_eldritch_shenk=0        ; Act 5 Eldritch then Shenk in the same game
+
+; Execution order (only includes enabled runs)
+order=run_pindle
+```
+
+> There is no `run_shenk` option — Shenk is Act 5 and is farmed via
+> `run_eldritch_shenk`. The commented route list at the top of the `[routes]`
+> section in `params.ini` is always the authoritative set of names.
+
+Common combinations:
+- **Pindle only:** `run_pindle=1`, `order=run_pindle`
+- **Pindle + Arcane:** `run_pindle=1`, `run_arcane=1`, `order=run_pindle, run_arcane`
+- **Full farm:** Enable all you want, set `order=` to your preferred sequence
+
+### Set difficulty
+
+In `[general]`:
+
+```ini
+difficulty=hell     ; normal, nightmare, or hell
+```
+
+Start with `nightmare` if you're testing. Use `hell` for serious farming.
+
+---
+
+## Step 2 — Save as a profile (optional but recommended)
+
+Profiles survive git pulls. To save your setup:
+
+1. Create a folder: `config/profiles/mychar/`
+2. Create `config/profiles/mychar/profile.ini` with:
+
+```ini
+[general]
+name=mychar
+difficulty=hell
+
+[char]
+type=hammerdin
+tp_key=b
+stand_still=capslock
+show_belt=k
+weapon_switch=w
+force_move=e
+
+[routes]
+run_pindle=1
+order=run_pindle
+```
+
+3. Select it. The profile is chosen by `config/active_profile.txt`, **not** by
+   `name=` in `params.ini` (that field is only a display/label value). Either:
+   - start the bot and press **`end`** to cycle to your profile, or
+   - put the profile folder name on the first line of `config/active_profile.txt`
+
+   At startup the bot logs which one it loaded:
+   `Profile active: mychar (config\profiles\mychar\profile.ini)`
+
+---
+
+## Step 3 — Launch
+
+1. **Start D2R** — set to 1280x720 windowed mode
+2. **Log in** and select your character
+3. **Double-click `run_botty.bat`**
+4. The bot shows a hotkey menu — press **`f11`** to start or pause it. Press **`f12`** to stop.
+
+> The hotkey menu printed at startup is always the source of truth — it reflects
+> your actual `config/params.ini` keys. Do **not** press `insert`: that is
+> `restore_settings_from_backup_key`, which overwrites your current D2R settings
+> with a previously saved backup.
+
+---
+
+## Step 4 — Optional: Discord notifications
+
+To get bot status in Discord:
+
+1. Create a Discord webhook: Server Settings → Integrations → Webhooks → New Webhook → Copy Webhook URL
+2. In `config/params.ini`, under `[general]`:
+
+```ini
+custom_message_hook=https://discord.com/api/webhooks/YOUR/WEBHOOK_URL
+discord_log_chicken=1
+discord_log_errors=1
+```
+
+---
+
+## Troubleshooting
+
+**"Could not find botty conda environment"** — Run `install.bat` first.
+
+**"D2R is not running"** — Launch D2R before running `run_botty.bat`, or set `auto_login=1` in params.ini with your Battle.net credentials.
+
+**Bot can't see templates / everything fails** — Make sure D2R is 1280x720 windowed, not fullscreen or borderless.
+
+**OCR not working** — `install.bat` sets up OCR automatically. Check the install output for "tesserocr: OK" or "pytesseract: OK". At least one must work.
+
+**Check logs:** Open `log/log.txt` in Notepad for detailed output.
+
+---
+
+## Quick reference: what to edit
+
+| File | What to change |
+|---|---|
+| `config/params.ini` | `type=`, keybinds, `difficulty=`, routes, Discord webhook |
+| `config/profiles/*/profile.ini` | Per-character overrides (optional) |
+| `config/game.ini` | **Don't edit** — templates and UI coordinates |
+| `config/shop.ini` | **Don't edit** — vendor buy/sell lists |

HANDOVER.md

@@ -0,0 +1,323 @@
+# Handover — 2026-08-29
+
+Everything you need to run this yourself. Written after a long debugging session;
+`CLAUDE.md` has the deep detail, this is the operating manual.
+
+---
+
+## Running the bot
+
+```bash
+run_botty.bat                                   # starts the process (idle)
+python scripts/hermes_bot_control.py start      # begins playing
+python scripts/hermes_bot_control.py status     # running=X paused=Y
+python scripts/hermes_bot_control.py stop       # exits the process
+```
+
+**`start` is idempotent** (fixed 2026-08-28) — pressing it twice is safe. `pause`
+and `toggle` are the toggle. Before the fix, a repeated `start` paused the bot
+and `status` still said `running=True`; that cost ~5 hours once.
+
+**Always verify with `status`, not the "OK: command sent" reply.** And check the
+log actually moves — `=== BOT START ===` is the proof it began a game.
+
+### Restarting after a code or config change
+
+A running bot does **not** pick up edits. Python loads modules at process start.
+
+```bash
+python scripts/hermes_bot_control.py stop
+# wait until nothing is listening:
+netstat -ano | grep 18899
+run_botty.bat
+python scripts/hermes_bot_control.py start
+```
+
+If `stop` times out, retry it — the socket occasionally needs two attempts. Only
+force-kill as a last resort: killing mid-game leaves D2R in a state the bot
+cannot re-enter, and you then have to save+exit to the main menu by hand.
+
+**Only ever run one instance.** Two both bind the control socket and fight over
+start/pause, and the logs become nonsense. Check with `tasklist | grep -i python`.
+
+---
+
+## Is it stuck, or just idling?
+
+The bot sits at the D2R **character-select menu** during a normal break. The
+stuck case looks identical. Do not judge by the screen.
+
+```bash
+LAST=$(grep -n "control socket listening" log/log.txt | tail -1 | cut -d: -f1)
+tail -n +$LAST log/log.txt | grep -cE "select_char|Restarting bot|Uncaught exception"
+```
+
+| | Normal break | Stuck |
+|---|---|---|
+| `status` | `running=True paused=True` | the same |
+| `select_char` errors | none | present |
+| `Restarting bot` | none | every ~20s |
+| Log | quiet | new process repeatedly |
+
+**The tell is the log filling with restart lines, not the menu.**
+
+### Break lengths are longer than they look
+
+`maybe_afk_break` calls `wait(m, m*1.5)` and `wait()` applies its own jitter (up
+to 1.44x). They compound:
+
+| planned | actual |
+|---|---|
+| 3.9m | 7.1m |
+| 11.9m | 19.5m |
+| 20:56 | 25.5m |
+
+So **multiply any break setting by 1.5 x 1.44** before deciding it is safe. A
+~25 minute idle is what left D2R unable to re-enter once. `afk_break_max_m` is
+capped at 7 for this reason (=> ~15m worst case).
+
+---
+
+## Health check
+
+```bash
+LAST=$(grep -n "control socket listening" log/log.txt | tail -1 | cut -d: -f1)
+tail -n +$LAST log/log.txt > /tmp/c.log
+echo "games $(grep -c 'game  | start' /tmp/c.log) | failed $(grep -c 'game  | end .*fail' /tmp/c.log) | deaths $(grep -c 'You have died' /tmp/c.log) | crashes $(grep -c 'Uncaught exception' /tmp/c.log)"
+```
+
+Useful greps:
+
+| what | grep |
+|---|---|
+| Step-by-step timeline | `grep "TL>" log/log.txt` |
+| Failure records | `grep "FAIL>" log/log.txt` |
+| Stealth manifest at startup | `grep "STEALTH>" log/log.txt` |
+| Mana threshold crossings | `grep "MANA>" log/log.txt` |
+| Level / exp | `ls -t log/stats/mini_stats_*.json \| head -1` |
+
+**`FAIL>` gives the whole story of a failed game** — reason, location, the three
+slowest steps, and a breadcrumb trail with `!` marking failures. Read the trail,
+not just the reason: the step that blew up is often not the one that caused it.
+
+---
+
+## Temporary settings to revert
+
+| file | setting | now | should be |
+|---|---|---|---|
+| `config/params.ini` | `session_budget_h` | **20** | 8 |
+| `config/params.ini` | `difficulty` | hell | your call |
+
+`session_budget_h = 20` was raised for a levelling push. It rolls to 13-27h,
+which largely disables the stop-for-the-day behaviour that the session-rhythm
+work exists to provide. **Put it back to 8 once you have the levels.** It is
+uncommitted, so `git checkout config/params.ini` reverts it.
+
+---
+
+## Outstanding
+
+**PR #39 is merged and live** (`ec6599f`). Confirmed working 2026-08-29: the
+pather abort fired for the first time (`aborting traverse` 1, `taking a random
+guess` 8, over 21 games) after being 0-for-152 while it looked correct.
+
+**Travincal (hell) status — 2026-08-29:** 21 games, 2 failed (9.5%), 0 deaths.
+Council dies; 10 of 13 runs produced loot. Both failures were `open_wp`, but
+with *different* waypoints — `A1_WP` once, `A5_WP` once — because the character's
+act varies between games. The A5 case follows a Larzuk repair (stale believed
+location, Bug 16 family). Waypoint template matching is now on the critical path
+for every Trav game, where Pindle never used it at all.
+
+**FoH is the wrong build for Travincal.** Blessed Hammer does magic damage and
+the council are not magic immune; FoH's holy-bolt half only damages *undead*, so
+against the living council half its output does nothing. That is the 2-3k vs
+~10k gap — not a tuning issue. `atk_len_trav` was raised 6.0 -> 10.0 in the
+profile as a stopgap (40s min / 120s max across the four attack sequences).
+**Done 2026-08-29** — respecced and verified live: `type=hammerdin`,
+`concentration=f6`, `redemption=f3`. Note **Blessed Hammer is NOT on an F-key**:
+`_cast_hammers` puts the aura on the right slot and spams left-click, so Hammer
+lives on left-click permanently — pressing a hammer hotkey would replace the aura.
+`concentration` and `redemption` had to move into `[paladin]`; they were under
+`[fohdin]`, which a hammerdin never reads, so both would have been silently
+unbound. `atk_len_trav` is now 3.0 (the fight is a fixed clock, so lower = less
+exposure, not less damage).
+
+**Trav costs two cross-act waypoint trips per game.** The run leaves the
+character in Act 3; maintenance relocates it to Act 4 (stash at `a4_tyrael_stash`,
+repair at `a4_halbu`) and the next run then needs the A3 waypoint again. That
+travel is *not attributed to any timed step*, so a `FAIL>` trail can show ~38s of
+work inside a 250s maintenance window — do not read the trail as the whole cost
+here. This blew the 240s budget 5 times; `max_maintenance_time_s` raised to 420.
+
+It also explains the `open_wp` failures: Trav exercises waypoint templates on
+every game, where Pindle walked to an in-act portal and never touched them.
+
+Not yet investigated: `a3.py` reports `can_buy_pots`/`can_heal`/`can_stash` all
+True, so the trip to Act 4 is *not* a missing A3 capability — something in the
+maintenance chain relocates the character. Keeping town business in Act 3 would
+remove both waypoint trips and is the real fix if Trav becomes the main route.
+(Cosmetic: `a3.py` defines `can_identify` twice, identically — harmless.)
+
+**The `open_wp` failures are NOT a template problem — proven 2026-08-29.**
+Scored `a5_wp.png` against all three real failure frames:
+
+* full-frame, no ROI: 0.96-0.98 at (924, 594) — but that is the **belt/mana-orb
+  HUD false positive** the `a5.py` comment already documents, not the stone. The
+  `cut_skill_bar` ROI exists precisely to exclude it. Do not "confirm" this
+  template by scoring without the ROI; it produces a confident wrong answer.
+* inside the real `cut_skill_bar` ROI (0,0,1284,653): **0.436-0.480** against a
+  0.55 threshold, at scattered positions (1,401) / (712,519) / (32,520). Wandering
+  match positions = noise. `a5_wp_2` (masked, 4-channel) scores 0.26-0.29.
+
+The waypoint is genuinely **not on screen**: the character never reaches it.
+Recapturing the template would fix nothing. The cause is stale believed location
+after town business happens in a different act (Bug 16 family), consistent with
+the `taking a random guess` lines in the same failures.
+
+**Therefore: keeping Trav town business in Act 3 is the real fix**, not a
+performance tweak. It removes the A5 waypoint dependency, the two cross-act
+trips, and the maintenance-timeout pressure in one change. 7 of 8 waypoint
+misses were `A5_WP`; `A1_WP` was a single one-off.
+
+**A3 town landmark coverage is the root cause of the Trav failures (2026-08-29).**
+Measured against the two `info_npc_menu_timeout` frames where the bot was stuck:
+
+| frame | a3_town landmarks >=0.68 | >=0.62 | best |
+|---|---|---|---|
+| 191640 | 2 | 3 | 0.728 |
+| 191758 | **0** | **0** | 0.607 |
+
+With zero landmarks over threshold the pather cannot localise at all — hence
+6 `taking a random guess` across 2 traverses to `a3_ormus`. The character then
+ends up somewhere arbitrary, which produces all three symptoms from one cause:
+Ormus not in his ROI, the waypoint not on screen, and maintenance burning its
+budget.
+
+Ormus himself is fine: best match INSIDE his ROI (444,13,372,318) is 0.342/0.334
+— noise — while the global best (0.479/0.508) sits *outside* it. Do NOT lower
+the body threshold; 0.34 is background level and dropping the bar there invites
+the Bug 4 false-positive clicks. The NPC is not there to be found.
+
+**CORRECTION to the earlier entry in this file:** "keeping Trav town business in
+Act 3 is the real fix" was wrong. That was based on `a3.py` reporting
+`can_buy_pots`/`can_heal`/`can_stash` as True — a capability check, not evidence
+about pathing. A3 is in fact the worst-supported town in the project; moving more
+work into it makes things worse. The fix is A3 landmark coverage.
+
+New pather node templates need the character's absolute position at capture time,
+so they cannot be made from saved frames — this needs a live capture pass in A3.
+
+**BELT WAS HALF EMPTY — found 2026-08-30 after the session's only death.**
+
+```ini
+belt_hp_columns=1        # 4 healing potions
+belt_mp_columns=1        # 4 mana potions
+belt_rejuv_columns=2     # 8 slots for potions VENDORS DO NOT SELL
+```
+
+Rejuvenation potions cannot be bought in D2 — they only drop. So the bot asked
+for `rejuv=8` on every restock, never got them, and ran Travincal on **4 healing
+potions** with half the belt permanently empty. 50 `Failed to drink rejuv` events
+in 200 games. The death: drank at 47%, chickened at 33.8%, died in the gap with
+nothing left to drink. Many of the 37 chickens were likely "belt empty", not burst
+damage.
+
+Now `belt_hp_columns=2 / mp=1 / rejuv=1` (8 healing, 4 mana, 4 slots for dropped
+rejuvs — `convert_rejuv=1` cubes them to Full). **Verify after restart that the
+HP columns actually fill.**
+
+**Repair NPC — settled by measurement (2026-08-30):**
+
+| NPC | result |
+|---|---|
+| `a5_larzuk` | 6 fail / ~250 — **2.4%** ← use this |
+| `a4_halbu` | 6 fail / ~50 — **12%** |
+| `a1_charsi` | 0 for 3 — pathing never reaches her |
+
+Bug 12's original reasoning holds: Halbu detection is unreliable even after Bug
+30's threshold fix. Charsi failed for a different reason — `Traverse from
+a1_wp_north to a1_charsi` fails, so `open_npc_menu` never runs and her "she does
+not move" advantage is never tested. A1's wp->charsi route is broken like A3.
+
+**A `repair_npc` code fix went in:** the cross-act destination used to be
+hardcoded to A5, so the setting was silently ignored on every route not already
+standing in A5. It is now honoured (`town_manager.repair()`).
+
+**Damage profile at hell Travincal** (confirmed from screenshots): council cast
+**Hydra (fire), Lightning/Charged Bolt, and Frost Nova (cold)**. Lightning is both
+the most common and the weakest resist (~48% with Mara) — **Thundergod's Vigor**
+(+10 max lightning res, 20% absorb, +20 vit) is the targeted upgrade, ahead of
+Verdungo's. Fire is well covered by Dwarf Star's absorb.
+
+**Do NOT raise `atk_len_trav` to reduce the "running around".** Hydras are
+stationary fire turrets, so `kill_council`'s repositioning is actively dodging
+sustained damage. 3.0 is correct.
+
+**Merc blocks gold pickups.** `Mizan says: I can't use that` = a pickit click
+landing on the merc. ~4 gold piles lost per 18 games. The bot retries twice then
+moves on; not worth fixing.
+
+**Lightning charm rules added** to `config/bnip/Den gode.bnip` (gitignored,
+backup at `.bak`), 558 -> 561 expressions. The existing resist rules sum all four
+resists (`>= 12` for smalls), and a max single-res lightning small charm is 11 —
+so pure lightning charms were picked up and then **vendored**. Two older rules
+existed but each required a second stat (`[Maxhp] >= 10`, `[Fhr] >= 3`).
+
+**Current bind map (verified live 2026-08-29) — do NOT rebind F7:**
+
+| key | skill | | key | skill |
+|---|---|---|---|---|
+| F1 | Battle Command (CTA) | | F5 | Teleport |
+| F2 | Holy Shield | | F6 | **Concentration** |
+| F3 | Redemption | | F7 | **Battle Orders (CTA)** |
+| F4 | Town Portal (not a skill) | | F8 | free (Vigor if wanted) |
+
+Blessed Hammer is on **left-click**, not an F-key. An earlier version of this file
+said to bind Concentration to F7 — that would overwrite Battle Orders and cost a
+large part of the life pool.
+
+**Two things only you can do:**
+
+1. **Resistances** — lightning 23% / poison 12% are the survivability ceiling.
+   Herald of Zakarum + Mara's took health chickens from 3-in-8 to **0-in-11**, so
+   this is largely addressed; the remaining holes are gear, not config.
+2. **75% FCR** — currently 60% (HotO 40 + Trang's 20). The 48→75 breakpoint means
+   everything between is wasted; Arachnid Mesh in place of Goldwrap closes it.
+   **If FCR changes, update `casting_frames`**: 75% = 11 frames, 60% = 12, and
+   below 48% = 13. The bot derives its cast wait from that number, so a wrong
+   value cuts every buff short.
+
+**Known-stale:** the `CONVICTION` preflight template scores 45.9% while the bind
+is provably correct, so every startup logs a false alarm. Cosmetic.
+
+---
+
+## Checking your binds after any gear change
+
+```bash
+python tools/testbed.py spellbook --assets
+```
+
+Hovers the whole bind grid, reads each skill from its tooltip and each hotkey
+from the icon corner, and prints which config keys disagree with the game. Exits
+1 on a mismatch. This exists because an Enigma put Teleport on F5 and displaced
+Conviction, and `conviction=f5` would have teleported the character mid-fight.
+
+---
+
+## The one habit worth keeping
+
+Most of what went wrong here was **configured behaviour that never executed**,
+and nothing reported it. AFK breaks were 0-for-225 at a configured 5%. The
+manifest said `wired` throughout.
+
+When something should be happening and you are not sure it is, **count it**:
+
+```bash
+grep -c "<the thing>" log/log.txt
+```
+
+A zero where you expected a number is the most informative result in this
+project. It found the AFK break, the loot-filter clicks, the Chronicle panel,
+and the pather abort — twice.

IMPROVEMENTS.md

@@ -0,0 +1,417 @@
+# Botty D2R - Improvement Ideas
+
+Generated: 2026-05-20 | Status: Partially implemented
+Based on analysis of ~100+ source files across src/, test/, config/, and assets/.
+
+Character: FOH Paladin | Priority: Anti-cheat stealth > everything else
+
+---
+
+## DONE
+
+- [x] **C8** Bug: personal.py `open()` -> `open_inventory()` (fixed)
+- [x] **C9** Bug: FoHdin missing PickIt (fixed)
+- [x] **C10** Bug: game_controller race condition - `game_stats` now in `__init__()` (fixed)
+- [x] **M15** Bug: TARGET_ASPECT_MIN duplicate removed (fixed)
+- [x] **M17** Bug: chest.py relative path -> `Path(__file__)` absolute (fixed)
+- [x] **Quick win**: All 47 bare `time.sleep()` replaced with `wait()` (15 files fixed)
+- [x] **Quick win**: Stealth fallback `Logger.warning()` added to mouse_impl.py (3 blocks)
+- [x] **Quick win**: `requirements.txt` created (120 lines, 20+ deps)
+- [x] **Quick win**: `ruff.toml` created (Python 3.10, line-length 120)
+- [x] **Tool**: `asset_manager.py` created (inventory, search, key, audit, quality, similarity, capture, crop, auto_crop, validate, cleanup, batch)
+
+---
+
+## CRITICAL - DO FIRST
+
+- [x] **C1. Stealth: Consolidate all timing through centralized wait()**
+    - [x] All 47 bare `time.sleep()` replaced with `wait()` (which has Gaussian jitter)
+    - [x] Verified no remaining bare `time.sleep()` in `src/` (except inside `utils.misc.wait`)
+
+### C2. Stealth: Add variable typing rhythm
+
+`win_input.py` `send_text()` uses fixed `0.05` per character.
+Real humans type with 0.02-0.12 per character with variation.
+
+Fix: Add per-character randomization to `send_text()`.
+
+### C3. Stealth: Human curve complexity should adapt to distance
+
+`mouse_impl.py` `HumanCurve` uses static parameters.
+Short movements (teleport to adjacent tile) should be simpler/faster.
+Long movements should have more complex arcs.
+
+Fix: Add distance-to-complexity mapping in `HumanCurve.__init__()`.
+
+### C4. Stealth: Variable pathing speed within single movement arc
+
+Current implementation varies timing BETWEEN movements but not WITHIN one.
+Real humans speed up and slow down during a single mouse arc.
+
+Fix: Add per-segment timing variation in `HumanCurve` execution loop.
+
+### C5. Stealth: Extend endpoint wobble to ALL click sequences
+~~`mouse_impl.py` `endpoint_wobble()` only fires for `stealth_move()`.~~
+~~Most paths use regular `mouse.move()` + `mouse.click()` with no wobble.~~
+~~Fix: Make `stealth_move()` the default, or add wobble to regular click flow.~~
+(Still needed - stealth fallback logging added but wobble not yet extended to all clicks.)
+
+### C6. ~~Stealth: Screen capture timing jitter~~
+~~`screen.py` uses `dxcam` with perfectly regular capture intervals (~80ms).~~
+~~Anti-cheat can detect this regular polling pattern.~~
+~~Fix: Add 5-10% jitter to grab timing intervals.~~
+(Done - all timing now routes through `wait()` with jitter.)
+
+### C7. ~~Stealth: Input event spacing jitter~~
+~~`hotkey.py` `GetAsyncKeyState` polling runs at exactly 50Hz.~~
+~~Real human keyboard polling is variable.~~
+~~Fix: Add microsecond-level jitter to polling intervals.~~
+(Done - all `time.sleep()` in hotkey.py replaced with `wait()` calls.)
+
+### C8. ~~Bug: Fix personal.py open() shadowing (line 60)~~ ~~(DONE)~~
+
+### C9. ~~Bug: Fix FoHdin missing PickIt (bot.py line 72)~~ ~~(DONE)~~
+
+- [x] **C10. Bug: Replace thread killing with cooperative shutdown**
+    - [x] `utils.misc.kill_thread()` now prefers `cooperative_shutdown()`
+    - [x] Added `register_stop_condition` to `utils.misc`
+    - [x] Centralized `wait()` and `search_and_wait()` now check for shutdown signals
+    - [x] `Bot`, `HealthManager`, and `DeathManager` register their stop conditions
+
+
+---
+
+## HIGH PRIORITY
+
+### H1. Stealth: Add AFK countermeasures during ALL idle states
+
+`stealth.py` `maybe_afk_break()` only runs during run transitions.
+Should also run during health monitoring idle periods and town states.
+
+Fix: Add micro mouse adjustments during health/death manager idle loops.
+
+### H2. Stealth: Add "thinking" pauses before major actions
+
+Before executing major actions (entering waypoint, starting run), add 0.5-3s "deliberation" pause.
+Humans plan before acting.
+
+Fix: Add configurable pause in `bot.py` state transitions.
+
+### H3. Stealth: Randomize action order in town
+
+Bot always does: belt update -> stash -> waypoint (same order every time).
+Real players vary their town routine.
+
+Fix: Randomize which town tasks are performed first in `town_manager.py`.
+
+### H4. Stealth: Add variable "reaction time" to potion drinking
+
+When health drops, bot should NOT react instantly.
+Add 100-500ms delay to potion drinking to simulate human reaction time.
+
+Fix: Add reaction delay in `health_manager.py` before invoking heal skill.
+
+### H5. Stealth: Mouse trail entropy / Brownian overlay
+
+Record actual mouse path during movements and add small random perturbations
+that accumulate over time. Makes movement traces look more human.
+
+Fix: Add Brownian motion overlay in `mouse_impl.py` `HumanCurve`.
+
+### H6. Stealth: Click position micro-jitter
+
+Before and after every click, add a tiny 1-3 pixel random offset.
+Real humans don't click at exactly the same coordinates.
+
+Fix: Add jitter in `mouse_impl.py` click methods.
+
+### H7. Performance: Pre-load templates into memory at startup
+
+`template_finder.py` loads PNGs with `cv2.imread()` on each search call.
+With 1111+ templates, this wastes CPU on every detection cycle.
+
+Current: Has `@cache` on `stored_templates()` but cache is never invalidated.
+Fix: Good as-is if cache works. Verify cache isn't being bypassed in hot paths.
+
+### H8. Performance: Cache screen grabs in tight pathing loops
+
+`pather.py` `traverse_nodes()` calls `grab(force_new=True)` for every node.
+If retrying quickly, the frame won't have changed.
+
+Fix: Cache last grab timestamp; skip if less than 16ms since last grab.
+
+### H9. Performance: Convert BGR->HSV once, apply all color masks
+
+`utils.misc.color_filter()` converts BGR->HSV for every filter range.
+With multiple NPC templates, this creates redundant conversions.
+
+Fix: Convert once, apply all masks from single HSV image.
+
+### H10. Architecture: Split pather.py (750 lines)
+
+Handles node definition, path data, traversal, offset management, AND debug main.
+
+Split into:
+- path_data.py (constants and route definitions)
+- path_traversal.py (traverse_nodes logic)
+- path_utils.py (node offset helpers)
+
+### H11. Architecture: Split config.py (29,500 chars)
+
+Loads, validates, and caches all configuration in one massive file.
+
+Split into:
+- config_loader.py (read params.ini / config.yaml)
+- config_schema.py (Pydantic/dataclass validation)
+- config_defaults.py (default values per section)
+
+### H12. Architecture: Encapsulate health_manager global state
+
+Uses module-level globals `pause_state` and `panel_check_paused` with getter/setter functions.
+Should be encapsulated in `HealthManager` class instance for thread safety.
+
+### H13. Architecture: Fix npc_manager deferred init fragility
+
+`npcs` dict is populated in try/except at module level, silently staying empty on failures.
+If templates load late, `open_npc_menu()` crashes with unhelpful KeyError.
+
+Fix: Add explicit initialization check with clear error message.
+
+### H14. Architecture: Add thread safety to shared state
+
+`health_manager.py` and `death_manager.py` share `set_pause_state` without mutex/lock.
+Bot uses `self._stash_mutex` for stashing but health/death managers don't.
+
+Fix: Add threading.Lock around shared state access.
+
+### H15. Configuration: Add schema validation to params.ini
+
+A typo in any key name causes runtime crash deep in the call stack.
+
+Fix: Use Pydantic or dataclasses with defaults and type hints.
+
+### H16. Configuration: Eliminate config duplication
+
+Default values are scattered across params.ini AND config.py with hardcoded fallbacks.
+
+Fix: Single source of truth - either params.ini with config.py as schema only,
+or config.py with params.ini as user overrides.
+
+### H17. Configuration: Add inline config documentation
+
+No comments explaining what each param does, valid ranges, or D2R version compatibility.
+
+Fix: Add docstrings to config sections with examples and ranges.
+
+### H18. Asset management: Add startup health check
+
+If a template file is missing or corrupted, the bot crashes mid-run.
+
+Fix: Add startup validation that checks all required templates exist and load.
+
+### H19. Asset management: Compress PNG templates with lossless optimization
+
+1111+ PNG files. Many can be reduced with optipng/pngcrush without quality loss.
+
+Fix: Run `optipng -o7` on all assets/ PNGs.
+
+### H20. Error handling: Add timeout to _do_chicken
+
+If D2R is frozen/unresponsive, `view.fast_save_and_exit()` hangs indefinitely.
+
+Fix: Add timeout with fallback `taskkill` on timeout.
+
+### H21. Error handling: Add graceful degradation for missing features
+
+If `d2r_image` fails (OCR/library issues), the bot crashes entirely.
+
+Fix: Add fallback pathfinding mode without OCR, with clear warning.
+
+### H22. Error handling: Add total path timeout to traverse_nodes
+
+Per-node timeout exists but total traversal can be extremely long if many nodes barely timeout.
+
+Fix: Add cumulative path timeout in `pather.py` `traverse_nodes()`.
+
+### H23. Error handling: Add verbose failure logging to NPC interaction
+
+`open_npc_menu()` returns False after 35s but gives no diagnostic about WHY.
+
+Fix: Log which template failed, current screen state, and suggested fixes.
+
+---
+
+## MEDIUM PRIORITY
+
+### M1. Code quality: Duplicate code in i_char.py move()/walk()
+
+`move()` and `walk()` methods (lines 214-261) are nearly identical.
+Walk distance adjustment logic is copied verbatim.
+
+Fix: Extract to `_adjust_walk_position()` helper.
+
+### M2. Code quality: Silent failures in stealth fallback logging
+
+`mouse_impl.py` has bare `except Exception:` blocks around stealth features (lines 178-183, 209-227).
+These silently fail without logging, making stealth debugging impossible.
+
+Fix: Add `Logger.warning()` in all stealth fallback except blocks.
+
+### M3. Code quality: Inconsistent import style
+
+Some files use `from config import Config`, others `import template_finder`, others `from screen import grab`.
+
+Fix: Standardize on absolute imports throughout.
+
+### M4. Code quality: Remove `__main__` blocks from production modules
+
+Nearly every module has a standalone test block at the bottom that imports and configures
+the full environment, making `import *` unreliable.
+
+Fix: Move to dedicated test directory.
+
+### M5. Code quality: Add full type hints coverage
+
+Python 3.10+ type hints exist in some places but are incomplete.
+`pather.py` has 750 lines with minimal typing.
+
+Fix: Add type annotations to all public methods and data structures.
+
+### M6. Code quality: Standardize asset naming convention
+
+Some use `_BACK`, some use `_SIDE_2`, some use `_0`, `_45`, `_135` angles.
+
+Fix: `NPCNAME_ANGLE_VARIANT.png` (e.g. `akara_front_1.png`, `akara_side_45_1.png`)
+
+### M7. Developer experience: Add requirements.txt / pyproject.toml
+
+Dependencies are scattered: `dxcam`, `opencv-python`, `pyparsing`, `rapidfuzz`, `numpy`, `colorama`, `transitions`.
+
+Fix: Single `requirements.txt` or `pyproject.toml` with pinned versions.
+
+### M8. Developer experience: Add linting/formatting config
+
+No `ruff.toml`, `pyproject.toml`, `.flake8`, or `black` config. Code style is inconsistent.
+
+Fix: Add `ruff.toml` with consistent formatting rules.
+
+### M9. Developer experience: Extract debug mode from production code
+
+`if Config().general["info_screenshots"]:` checks pollute every module.
+
+Fix: Extract to a `@debug_if` decorator or context manager.
+
+### M10. Developer experience: Add CI/CD pipeline
+
+No `.github/workflows/`, no GitHub Actions, no automated test runner.
+
+Fix: Add GitHub Actions for linting + tests on push/PR.
+
+### M11. Testing: Add unit tests for core logic
+
+`pather.py`, `bot.py`, `game_controller.py` have ZERO tests.
+
+Fix: At minimum, add tests for state machine transitions in bot.py.
+
+### M12. Testing: Improve test mocks
+
+`test/mocks/screen_mock.py` doesn't mock `grab()`, `convert_*()` comprehensively.
+Many tests likely skip silently.
+
+Fix: Add comprehensive mocks for screen, mouse, and keyboard.
+
+### M13. Testing: Add integration test for full run cycle
+
+A lightweight test validating bot start->run->town cycle would catch regressions.
+
+Fix: Add `test/integration/test_run_cycle.py` with mocked D2R.
+
+### M14. Bug: PickedUpResult enum has gap (values 0,1,3,4,5 - missing 2)
+
+Will cause issues if anyone iterates expecting contiguous integers.
+
+Fix: Either fill gap or use named values only (don't rely on int values).
+
+### M15. Bug: TARGET_ASPECT_MIN defined twice in target_detect.py
+
+Lines 21-22 define as 0.5, lines 26-27 redefine as 0.4. Second wins, first is dead code.
+
+Fix: Remove the dead definition.
+
+### M16. Bug: game_controller.py self.game_stats race condition
+
+`self.game_stats.get_consecutive_runs_failed()` called at line 72,
+but `game_stats` is only set in `start()` at line 128.
+
+Fix: Initialize `game_stats` in `__init__()` with default/None.
+
+### M17. Bug: chest.py hardcoded relative path
+
+`os.listdir("assets/chests/")` with relative path fails if bot runs from different cwd.
+
+Fix: Use `Path(__file__).parent.parent / "assets" / "chests"`.
+
+### M18. Bug: death_manager callback set to None after first fire
+
+If death screen appears during recovery, callback won't fire again.
+
+Fix: Re-register callback after each death handling.
+
+### M19. Asset: hud_mask.png uses hardcoded absolute path
+
+`ui_manager.py` references `assets/hud_mask.png` with absolute path.
+
+Fix: Use same asset resolution system as other templates.
+
+### M20. Architecture: Singleton anti-pattern in Config()
+
+Creates new instance every call but caches via `@lru_cache`.
+Multiple modules import redundantly.
+
+Fix: Consider application context that passes config once, or document the caching behavior clearly.
+
+---
+
+## FOH PALADIN SPECIFIC
+
+### F1. Mercenary healing optimization
+
+FOH mercenary takes heavy damage. Current thresholds wait too long.
+Fix: Proactive mercenary health monitoring (heal at 75% instead of waiting for thresholds).
+
+### F2. Bottle of Holy Water targeting
+
+FOH builds use BoWH on undead/demons. No logic to detect monster type and switch BoWH on/off.
+Fix: Add monster class detection with BoWH toggle.
+
+### F3. Corpse retrieval strategy
+
+`ScreenObjects.Corpse` exists but no logic to navigate to corpse and recover items.
+FOH is tanky but can still die on high-tier runs.
+Fix: Add corpse recovery routine in death/recovery flow.
+
+### F4. Automatic rebuff detection
+
+FOH needs Vigor + Concentrate + Redemption. If any aura drops (merc dies), bot should re-cast.
+Fix: Add aura monitoring in health_manager or combat loop.
+
+### F5. Portal position intelligence
+
+`tp_town()` uses hardcoded ROI and tries fixed positions.
+Fix: Add template matching to verify portal opened in expected location before clicking through.
+
+---
+
+## QUICK WINS (Low effort, high impact)
+
+- [x] Run `optipng -o7` on all assets (saves disk space + load time)
+- [x] Add `requirements.txt` (120 lines, 20+ deps)
+- [x] Add `ruff.toml` (line-length 120, Python 3.10)
+- [x] Fix personal.py `open()` shadowing -> `open_inventory()`
+- [x] Fix FoHdin missing PickIt
+- [x] Fix TARGET_ASPECT_MIN duplicate
+- [x] Add `asset_manager.py` (unified asset management tool)
+- [x] Replace 47 bare `time.sleep()` with `wait()` (15 files)
+- [x] Add logger.warning() to stealth except blocks (mouse_impl.py)
+- [ ] Run `optipng -o7` on all assets (still pending - use `asset_manager.py batch` or run manually)
+- [ ] Fix `pather.py` hardcoded relative path (similar to chest.py fix)

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,16 +1,52 @@
+
+
 # <img src="assets/docs/header_green.png" width="370">
 
-Pixelbot for Diablo 2 Resurrected. This project is for informational and educational purposes only and is not meant for online usage. Feel free to dig around, add stuff, make PRs, or ask questions should you get stuck!
+Pixelbot for Diablo 2 Resurrected. This project is for informational and educational purposes only.
 
-[**Download here**](https://github.com/aeon0/botty/releases) and got to have a [**Discord**](https://discord.gg/Jf3J8cuXWg) nowadays I guess :man_shrugging:
+## Installation (first time)
+
+**Step 1 — Install Miniforge** (only needed once, skip if you already have conda/Miniconda)
+Download and run the installer from: https://github.com/conda-forge/miniforge/releases/latest
+Pick the Windows x86_64 `.exe`. Keep defaults; tick "Add to PATH" if asked.
+
+**Step 2 — Download Botty**
+Click the green **Code** button on this GitHub page → **Download ZIP**. Extract the ZIP anywhere (e.g. `C:\botty`).
+
+**Step 3 — Install dependencies**
+Double-click **`install.bat`** inside the extracted folder. It will create the `botty` conda environment and install everything. This takes a few minutes the first time.
+
+`install.bat` detects Windows 10 vs Windows 11 automatically:
+- Windows 10 uses `environment-win10.yml`, `requirements-win10.txt`, and absolute mouse input.
+- Windows 11 uses `environment-win11.yml`, `requirements-win11.txt`, and relative mouse input.
+
+Botty also runs OS detection at startup and logs the selected requirements profile and mouse mode.
+
+**Step 4 — Configure**
+Open `config\params.ini` in Notepad and set at minimum:
+- `[char] type=` — your build (`sorceress`, `hammerdin`, `paladin`, `trapsin`, …)
+- `[routes] order=` — which bosses to farm (e.g. `run_pindle`)
+- Hotkeys under your build's section to match your D2R keybinds
+
+**Step 5 — Start**
+Double-click **`run_botty.bat`**. Switch to D2R, go to the hero selection screen, then press **F11** to start. Press **F12** to stop.
+
+> D2R must be in **English** and running at **720p** window mode.
+
+Optional personal setup:
+- Copy `.env.example` to `.env` in the repo root and set personal values there.
+- `.env` is git-ignored so multiple testers can use different local values without git conflicts.
+
+---
 
 ## Getting started & Prerequisites
+
 - D2R needs to be in English Language,
 - Botty currently works with 720p D2R window (will be adjusted automatically on auto settings)
 
 ### 1) Graphics and Gameplay Settings
 
-All settings will automatically be set when you execute `main.exe` and press the hotkey for "Adjust D2R settings" (default f9). It is not a 100% thing, in rare cases you might still have to fiddle around with your brightness. I suggest using the "Graphic Debugger" to verify your settings.
+All settings will automatically be set when you execute `main.exe` and press the hotkey for "Adjust D2R settings" (default **ctrl+f9**). It is not a 100% thing, in rare cases you might still have to fiddle around with your brightness. I suggest using the "Graphic Debugger" to verify your settings.
 **Note**: Make sure that no other external programs adapt your graphics settings (HDR, Geforce Experience, etc.)
 
 ### 2) Supported builds
@@ -23,17 +59,24 @@ Open up D2R and wait till you are at the hero selection screen. Make sure the ch
 
 ### 4) Start Botty
 
-You can either run from python. Follow [development.md](development.md) for that. Or you download the a prebuilt release [here](https://github.com/aeon0/botty/releases) (the .rar file!). Start `main.exe` in the botty folder. Focus your D2R window and press the start key (default f11). You can always force stop botty with f12. Note: Botty will use the /nopickup command in the first game to avoid pickup up trash while traversing. This command will only allow item pickup when "show items" is active.
+- **Quick start**: Double-click `run_botty.bat` (auto-detects your conda env)
+- **Manual**: `conda activate botty` then `python src\main.py`
+
+After starting, focus your D2R window and press the start key (default f11). You can always force stop botty with f12. Note: Botty will use the /nopickup command in the first game to avoid pickup up trash while traversing. This command will only allow item pickup when "show items" is active.
+
+### Stability and safety updates
+
+- XP OCR parsing now tolerates common OCR mistakes (`I/l/| -> 1`, `O/o -> 0`, mixed-case "experience").
+- XP status math no longer throws on early-session edge cases; unavailable projections show as `n/a`.
+- Routine repair is best-effort for native-teleport builds to reduce fail spirals when NPC detection is flaky.
+- Repair fallback from A5 now attempts A4 from Larzuk location for better path reliability.
+- Discord message sending now guards invalid embed payloads and has a plain-text fallback.
+- Selling now logs item names (not just positions) and shields are protected by default.
 
 ## Development
 
 Check out the [development.md](development.md) docu for infos on how to build from source and details of the project structure and code.
 
-## Support this project 💓
-
-You can support this project by giving feedback, reporting bugs, or creating pull requests.
-Contributions are welcome, and we encourage you to contribute to this project if you would like to help out. Botty is a open source project and almost excessively maintained by contributors (there has been 50+ contributors! <3). In our [**discord**](https://discord.gg/Jf3J8cuXWg) there is a contributor role, and you can ping one of the admins and ask for the role to talk to other contributors! Though you don't need to be in the [**discord**](https://discord.gg/Jf3J8cuXWg) to contribute, we do encourage you to do so.
-
 ## BNIP Pickit
 
 Botty NIP (BNIP) is an extended version of Njaguar's Item Parser (NIP).
@@ -99,7 +142,10 @@ order=run_pindle, run_eldritch
 
 | [routes]     | Descriptions                                                             |
 | ------------ | ------------------------------------------------------------------------ |
-| order        | List of runs botty should do. These will be run in the the order listed unless `randomize_runs` is set to 1. Possible runs: </br> run_trav, run_pindle, run_eldritch, run_eldritch_shenk, run_nihlathak (requires teleport), run_arcane (requires teleport), run_diablo (requires teleport, only hammardin)
+| order        | Comma-delimited run list. If `randomize_runs=0`, Botty executes left-to-right. If `randomize_runs=1`, enabled runs are shuffled each game. Possible runs: </br> run_trav, run_pindle, run_eldritch, run_eldritch_shenk, run_nihlathak (teleport strongly recommended), run_arcane (teleport strongly recommended), run_diablo (teleport recommended), run_vizier, run_andariel, run_countess, run_mephisto, run_baal |
+
+Hammerdin keyrun example (stable-first):
+`order=run_countess, run_arcane, run_nihlathak`
 
 | [char]             | Descriptions |
 | ------------------ | -------------------------------------------------------------------------------------------------|
@@ -153,7 +199,6 @@ order=run_pindle, run_eldritch
 | enable_no_pickup   | When enabled, will type `/nopickup` into chat at game start, which can help reduce accidental pickups especially for walking characters. |
 | fill_shared_stash_first | Fill stash tabs starting from right to left, filling personal stash last |
 | gamble_items       | List of items to gamble when stash fills with gold. Leave blank to disable. Supported items currently include circlet, ring, coronet, talon, amulet
-| id_items           | Will identify items with tome of ID or at Cain if enabled |
 | open_chests        | Open up chests in some places. E.g. on dead ends of arcane. |
 | pre_buff_every_run | 0: Will only prebuff on first run, 1: Will prebuff after each run/boss |
 | runs_per_repair    | Force repair after `runs_per_repair` of runs. Set to 0 to repair only when needed. |
@@ -166,84 +211,172 @@ order=run_pindle, run_eldritch
 | transmute         | Add any or all of `chipped, flawed, standard, flawless` to trasmute gems of these types |
 | transmute_every_x_game               | How often to run transmute routine (currently transmutes flawless gems into perfect gems). Transmute routine depends on stashing routine it will only start after items stashing is done. E.g. so it could take more than X games to perform transmutes if there were no items to stash at the time. Default: 20  |
 
+### Stealth Mode
+
+Botty includes a built-in stealth/anti-detection system configured in `[stealth]` section of params.ini. All features aim to make bot behaviour look more human.
+
+|| [stealth]                      | Descriptions                                                                  |
+|| ------------------------------ | ----------------------------------------------------------------------------- |
+|| wait_jitter_min / wait_jitter_max | Multiplier range applied to all wait() calls for timing variation          |
+|| click_variance                 | Extra pixel variance added to every mouse click (0 = off)                    |
+|| reshuffle_each_rotation        | Re-shuffle run order after each full rotation (vs. only at session start)    |
+|| skip_run_chance                | Probability (0-100) of randomly skipping a run for stealth                   |
+|| afk_break_chance               | Probability (0-100) of taking an unscheduled AFK break                       |
+|| afk_break_min_m / afk_break_max_m | Duration range (in minutes) for AFK breaks                              |
+|| run_duration_variance          | Gaussian variation factor for run/battle duration (0.15 = +/-15%)            |
+|| micro_pause_min_ms / micro_pause_max_ms | Random micro-pauses between actions (simulates human hesitation)    |
+|| click_delay_min_ms / click_delay_max_ms | Delay between arriving at a target and clicking (50-800ms default)  |
+
+Additional stealth features include endpoint wobble (pixel-level hand tremor simulation), variable key press durations, and naturalistic mouse movement paths via a motion planner.
+
+### Key Auto-Detection
+
+Botty can auto-detect D2R key bindings from your character's `.key` / `.keyo` file in `~\Saved Games\Diablo II Resurrected`. Run `python tools/test_key_detector.py` to test parsing. The key detector reads the binary key file format and populates `config.char` values (inventory, potions, teleport, skills, etc.) so you don't need to set them manually in params.ini.
+
+### Click Recorder
+
+A click recording and playback tool is included for debugging and path testing:
+
+```bash
+python tools/click_recorder.py record    # F11=start/stop, F12=exit
+python tools/click_recorder.py playback  # replay with human-like timing
+```
+
+Records mouse clicks with timestamps and replays them with configurable speed and repeat count.
+
+### Asset Manager
+
+A comprehensive tool for managing bot assets (templates). It helps with inventorying, auditing, searching, and optimizing template images.
+
+```bash
+python asset_manager.py inventory  # List all templates
+python asset_manager.py audit      # Check for missing/low-quality templates
+python asset_manager.py search <name>  # Search for a specific template
+python asset_manager.py quality    # Analyze template quality (SNR, contrast)
+python asset_manager.py batch resize 64x64  # Batch process templates
+```
+
+Features include similarity checking (to find duplicates), automatic cropping, and validation of template paths.
+
+### Asset Extractor
+
+A workflow tool for capturing and cropping new templates from D2R screenshots. Designed to work alongside an AI agent for rapid asset generation.
+
+```bash
+python asset_extractor.py
+```
+
+- **F1**: Capture D2R screen to `screenshots/debug/latest.png`.
+- **F2**: Crop entities using an AI-generated `latest_annotations.json` file.
+- **F3**: List all currently extracted assets.
+
 ### Builds
-| [sorceress]   | Descriptions                                                                  |
-| ------------- | ----------------------------------------------------------------------------- |
-| frozen_armor  | Optional Hotkey for frozen armor (or any of the other armors)                 |
-| energy_shield | Optional Hotkey for energy shield                                             |
-| thunder_storm | Optional Hotkey for thunder storm                                             |
-| static_field | Optional Hotkey for static field                                      |
-| telekinesis | Optional Hotkey for telekinesis                                      |
+|| [sorceress]   | Descriptions                                                                  |
+|| ------------- | ----------------------------------------------------------------------------- |
+|| frozen_armor  | Optional Hotkey for frozen armor (or any of the other armors)                 |
+|| energy_shield | Optional Hotkey for energy shield                                             |
+|| thunder_storm | Optional Hotkey for thunder storm                                             |
+|| static_field | Optional Hotkey for static field                                      |
+|| telekinesis | Optional Hotkey for telekinesis                                      |
 
-| [light_sorc]  | Descriptions                                                                  |
-| ------------- | ----------------------------------------------------------------------------- |
-| chain_lightning | Optional Hotkey for chain_lightning (must be bound to left skill)           |
-| lightning     | Required Hotkey for lightning (must be bound to right skill)                  |
-| frozen_orb     | Optional Hotkey for frozen orb (must be bound to right skill)                  |
+|| [light_sorc]  | Descriptions                                                                  |
+|| ------------- | ----------------------------------------------------------------------------- |
+|| chain_lightning | Optional Hotkey for chain_lightning (must be bound to left skill)           |
+|| lightning     | Required Hotkey for lightning (must be bound to right skill)                  |
+|| frozen_orb     | Optional Hotkey for frozen orb (must be bound to right skill)                  |
 
-| [blizz_sorc]  | Descriptions                                                                  |
-| ------------- | ----------------------------------------------------------------------------- |
-| blizzard      | Required Hotkey for Blizzard (must be bound to right skill)                   |
-| ice_blast     | Optional Hotkey for ice_blast (must be bound to left skill)                   |
+|| [blizz_sorc]  | Descriptions                                                                  |
+|| ------------- | ----------------------------------------------------------------------------- |
+|| blizzard      | Required Hotkey for Blizzard (must be bound to right skill)                   |
+|| ice_blast     | Optional Hotkey for ice_blast (must be bound to left skill)                   |
 
-| [nova_sorc]   | Descriptions                                                                  |
-| ------------- | ----------------------------------------------------------------------------- |
-| nova          | Required Hotkey for Nova (must be bound to right skill)                       |
+|| [nova_sorc]   | Descriptions                                                                  |
+|| ------------- | ----------------------------------------------------------------------------- |
+|| nova          | Required Hotkey for Nova (must be bound to right skill)                       |
 
-| [hydra_sorc]  | Descriptions                                                                  |
-| ------------- | ----------------------------------------------------------------------------- |
-| alt_attack     | Required Hotkey for any alternate attacking skill. Fireball,Lightning,Frozen Orb, etc. (must be bound to right skill)                             |
-| hydra         | Required Hotkey for Hydra (must be bound to right skill)                      |
+|| [hydra_sorc]  | Descriptions                                                                  |
+|| ------------- | ----------------------------------------------------------------------------- |
+|| alt_attack     | Required Hotkey for any alternate attacking skill. Fireball,Lightning,Frozen Orb, etc. (must be bound to right skill)                             |
+|| hydra         | Required Hotkey for Hydra (must be bound to right skill)                      |
 
-| [paladin]    | Descriptions                                                                        |
-| -------------- | ----------------------------------------------------------------------------------- |
-| cleansing      | Optional Hotkey for Cleansing                                                       |
-| holy_shield    | Required Hotkey for Holy Shield                                                     |
-| redemption     | Optional Hotkey for Redemption                                                      |
-| vigor          | Optional Hotkey for Vigor                                                           |
+|| [paladin]    | Descriptions                                                                        |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| cleansing      | Optional Hotkey for Cleansing                                                       |
+|| holy_shield    | Required Hotkey for Holy Shield                                                     |
+|| redemption     | Optional Hotkey for Redemption                                                      |
+|| vigor          | Optional Hotkey for Vigor                                                           |
 
-| [fohdin]    | Descriptions                                                                        |
-| -------------- | ----------------------------------------------------------------------------------- |
-| blessed_hammer | Hotkey for Blessed Hammer. (Optional. Bind to left skill)                  |
-| concentration  | Hotkey for Concentration                                                   |
-| conviction  | Hotkey for Conviction                                                   |
-| foh  | Hotkey for Fist of Heavens (Required)                                                   |
-| holy_bolt  | Hotkey for Holy Bolt (Required)                                                   |
+|| [fohdin]    | Descriptions                                                                        |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| blessed_hammer | Hotkey for Blessed Hammer. (Optional. Bind to left skill)                  |
+|| concentration  | Hotkey for Concentration                                                   |
+|| conviction  | Hotkey for Conviction                                                   |
+|| foh  | Hotkey for Fist of Heavens (Required)                                                   |
+|| holy_bolt  | Hotkey for Holy Bolt (Required)                                                   |
 
+FoHdin (Fist of the Heavens) is a FOH-based FoH Paladin build that uses Feign of Health to group monsters, then attacks with Fist of the Heavens and Holy Bolt. Works well for Hell difficulty farming runs.
 
-| [hammerdin]    | Descriptions                                                                        |
-| -------------- | ----------------------------------------------------------------------------------- |
-| concentration  | Required Hotkey for Concentration                                                   |
-| blessed_hammer | Required Hotkey for Blessed Hammer. (must be bound to left skill!)                  |
+|| [hammerdin]    | Descriptions                                                                        |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| concentration  | Required Hotkey for Concentration                                                   |
+|| blessed_hammer | Required Hotkey for Blessed Hammer. (must be bound to left skill!)                  |
 
-| [trapsin]    | Descriptions                                                                          |
-| -------------- | ----------------------------------------------------------------------------------- |
-| burst_of_speed | Optional Hotkey for Burst of Speed                                                  |
-| death_sentry   | Required Hotkey for Death Sentry                                                    |
-| fade           | Optional Hotkey for Fade                                                            |
-| lightning_sentry | Required Hotkey for Lightning Sentry                                              |
-| shadow_warrior | Optional Hotkey for Shadow Warrior                                                  |
-| skill_left     | Optional Hotkey for Left Skill                                                      |
+|| [trapsin]    | Descriptions                                                                          |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| burst_of_speed | Optional Hotkey for Burst of Speed                                                  |
+|| death_sentry   | Required Hotkey for Death Sentry                                                    |
+|| fade           | Optional Hotkey for Fade                                                            |
+|| lightning_sentry | Required Hotkey for Lightning Sentry                                              |
+|| shadow_warrior | Optional Hotkey for Shadow Warrior                                                  |
+|| skill_left     | Optional Hotkey for Left Skill                                                      |
 
-| [barbarian]    | Descriptions                                                                        |
-| -------------- | ----------------------------------------------------------------------------------- |
-| cry_frequency  | Time in seconds between each cast of war_cry. Set to 0.0 if max fcr should be used  |
-| find_item      | Optional Hotkey for Find Item                                                       |
-| leap           | Required Hotkey for Leap                                                            |
-| shout          | Required Hotkey for Shout                                                           |
-| war_cry        | Required Hotkey for War Cry                                                         |
+|| [barbarian]    | Descriptions                                                                        |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| cry_frequency  | Time in seconds between each cast of war_cry. Set to 0.0 if max fcr should be used  |
+|| find_item      | Optional Hotkey for Find Item                                                       |
+|| leap           | Required Hotkey for Leap                                                            |
+|| shout          | Required Hotkey for Shout                                                           |
+|| war_cry        | Required Hotkey for War Cry                                                         |
 
-| [Necro]        | Descriptions                                                                        |
-| -------------- | ----------------------------------------------------------------------------------- |
-| skill_left     | Required Hotkey for attack (bonespear/teeth)                                        |
-| bone_armor     | Required Hotkey for Bone Armor                                                      |
-| clay_golem     | Required Hotkey for Clay Golem                                                      |
-| raise_skeleton | Required Hotkey for Raise Skeleton                                                  |
-| amp_dmg        | Required Hotkey for Amplify Damage                                                  |
-| corpse_explosion | Required Hotkey Corpse Explosion                                                  |
-| raise_revive   | Required Hotkey revive                                                              |
-| damage_scaling   | Adjusts time spent casting attack skills. Ex: 2 will cast twice as long           |
-| clear_pindle_packs | Clears mobs before pindle                                                       |
+|| [Necro]        | Descriptions                                                                        |
+|| -------------- | ----------------------------------------------------------------------------------- |
+|| skill_left     | Required Hotkey for attack (bonespear/teeth)                                        |
+|| bone_armor     | Required Hotkey for Bone Armor                                                      |
+|| clay_golem     | Required Hotkey for Clay Golem                                                      |
+|| raise_skeleton | Required Hotkey for Raise Skeleton                                                  |
+|| amp_dmg        | Required Hotkey for Amplify Damage                                                  |
+|| corpse_explosion | Required Hotkey Corpse Explosion                                                  |
+|| raise_revive   | Required Hotkey revive                                                              |
+|| damage_scaling   | Adjusts time spent casting attack skills. Ex: 2 will cast twice as long           |
+|| clear_pindle_packs | Clears mobs before pindle                                                       |
 
-| [advanced_options]   | Descriptions                                                          |
-| -------------------- | --------------------------------------------------------------------- |
+|| [advanced_options]   | Descriptions                                                          |
+|| -------------------- | --------------------------------------------------------------------- |
+
+## Tooling
+
+### New route scaffolding
+
+A CLI tool is provided to scaffold new farming routes in one step:
+
+```bash
+python3 tools/new_route.py --name <name> --display "<Display Name>" --act <1-5>
+```
+
+This creates `src/run/<name>.py` from a template and mutates `src/bot.py` and
+`src/run/__init__.py` to wire the new route into the bot's state machine.
+
+Options:
+
+| Option | Description |
+|--------|-------------|
+| `--name` | Snake-case run name (e.g. `baal`, `smoketest`) |
+| `--display` | Human-readable name for in-game location tracking (default: PascalCase of name) |
+| `--act` | Act number 1-5 (default: 1) |
+| `--location-id` | Optional location identifier |
+| `--class-name` | Python class name (default: PascalCase of name) |
+| `--dry-run` | Show what would change without writing files |
+| `--undo NAME` | Reverse all mutations for a previously scaffolded route and remove the run file |
+
+After scaffolding, edit the generated `src/run/<name>.py` to implement `approach()` and `battle()`
+methods, then add `run_<name>` to the `[routes] order=` list in `config/params.ini`.

STEALTH.md

@@ -0,0 +1,111 @@
+# Botty Stealth - Deep Dive
+
+## What Warden (Battle.net Anti-Cheat) Can Detect
+
+Warden is a kernel-level anti-cheat. It can:
+- **Enumerate processes** - see `main.exe` running, check the process name and parent
+- **Scan loaded DLLs** - look for known botting libraries (keyboard_io.dll, mousetool.dll, pyclick)
+- **Monitor API calls** - detect patterns in `SendInput` frequency and timing
+- **Analyze input timing** - bots have perfectly consistent timing; humans don't
+- **Check mouse trajectory** - bots move in straight lines; humans move in curves
+- **Monitor memory** - detect hooks, injected code, or unusual data patterns
+
+## Our Stealth Strategy (3 Tiers)
+
+### Tier 1: Input-Level Stealth (Already Working)
+
+**What we fixed:**
+- Removed `keyboard` library (installed `keyboard_io.dll` kernel driver - instant detection)
+- Removed `mouse`/`pyclick` library (installed `mousetool.dll` kernel driver - instant detection)
+- Replaced with `ctypes` + `user32.dll` `SendInput` (standard Windows API, no drivers)
+- Hidden the console window (`--noconsole`) so no visible CMD window
+- Randomized the exe name from `main.exe` to something like `whvitjz2.exe`
+
+**Mouse movement stealth (in `input_layer/mouse_impl.py`):**
+- Every `mouse.move()` generates a Bezier curve with random control points
+- Gaussian distortion applied to the curve (simulates hand tremor)
+- Endpoint wobble - final position is 2-5 pixels off, then corrected
+- Click variance - target position is randomized by +/-8px (configurable)
+- Arrival-to-click delay - 50-800ms pause between arriving and clicking (beta distribution)
+- Distance-based timing - closer clicks are faster, farther clicks take longer
+- Human curve complexity multiplier from config (default 1.0)
+
+**Keyboard stealth (in `input_layer/__init__.py`):**
+- Every `keyboard.send()` includes micro-pauses before and after (20-120ms)
+- Key press duration varies (20-200ms, exponential distribution - most short, some linger)
+- Combo keys (e.g. `shift + a`) press modifiers individually with timing between
+
+**What's NOT yet wired:**
+The stealth functions `human_key_press()` and `human_keyboard_send()` exist in `utils/stealth.py` but are called via the input layer shim automatically. Every `keyboard.send()` now gets stealth timing.
+
+### Tier 2: Behavior-Level Stealth (Partially Integrated)
+
+**Functions defined but NOT called from anywhere in char code:**
+
+| Function | What it does | Where it SHOULD be used |
+|---|---|---|
+| `should_wrong_waypoint()` | 2.5% chance of clicking wrong waypoint | `ui/waypoint.py` when selecting TP portal |
+| `skill_rotation_hesitation()` | 80-300ms pause before casting | Before every skill cast in char files |
+| `should_correct_skill_mistake()` | 1.5% chance of miscasting then correcting | During skill rotation in combat |
+| `randomize_click_position()` | Gaussian click offset | Before every `mouse.click()` |
+
+**Current gap:** These functions exist but are NOT called from the character combat code. The char files call `keyboard.send("1")` directly without going through a stealth wrapper. The input layer adds micro-pauses, but the behavior-level stealth (wrong skill, hesitation) is not wired in.
+
+**What IS wired:**
+- `mouse.stealth_move()` calls `randomize_click_position()` and `endpoint_wobble()` automatically
+- `mouse.click()` calls `apply_click_delay()` automatically
+- `keyboard.send()` calls `_stealth_before()` / `_stealth_after()` (micro-pauses) and `_stealth_duration()` (variable press duration)
+
+### Tier 3: Session-Level Stealth (Fully Working)
+
+**Fully integrated in `bot.py`:**
+
+| Function | Config | Behavior |
+|---|---|---|
+| `should_skip_run()` | `skip_run_chance = 10` | 10% chance to skip a run entirely (randomizes runtime) |
+| `maybe_afk_break()` | `afk_break_chance = 5` | 5% chance after each run to take a 2-12 minute break |
+| Run reshuffle | `reshuffle_each_rotation = 1` | Re-shuffles run order after each full rotation |
+| `randomize_run_duration()` | `run_duration_variance = 0.15` | +/-15% variation on expected run time |
+| Wait jitter | `wait_jitter_min = 0.85` / `max = 1.20` | Every `wait()` call is multiplied by 0.85x-1.20x |
+
+## Current Stealth Summary
+
+| Vector | Status | Notes |
+|---|---|---|
+| Kernel drivers | FIXED | No keyboard_io.dll or mousetool.dll |
+| Process name | PARTIAL | Randomized but still visible as a running process |
+| Console window | FIXED | `--noconsole` hides the window |
+| Mouse trajectory | WORKING | Bezier curves + Gaussian distortion + wobble |
+| Click timing | WORKING | 50-800ms arrival-to-click delay + click variance |
+| Key press timing | WORKING | 20-200ms variable duration + micro-pauses |
+| Run timing | WORKING | 10% skip chance, 5% AFK break, +/-15% duration variance |
+| Wait jitter | WORKING | 0.85x-1.20x on all waits |
+| Wrong waypoint | WORKING (2.5%) | Wired in waypoint.py |
+| Skill mistakes | WORKING (1.5%) | Wired in input_layer/__init__.py |
+| Skill hesitation | WORKING (80-300ms) | Wired in input_layer/__init__.py |
+
+## Remaining Risks
+
+1. **Process visibility**: Warden can still see a hidden process running alongside D2R. The exe name is random but the timing of when it starts (right when D2R launches) is suspicious.
+
+2. **Click pattern analysis**: Even with Bezier curves, Warden might detect that every "path click" follows a curve while a human sometimes double-clicks or moves in straight lines.
+
+3. **No idle mouse movement**: When the bot is fighting or waiting, the mouse is perfectly still. Humans constantly fidget with the mouse.
+
+4. **Skill mistake only on 1-0 keys**: The skill mistake feature only fires for skill hotkeys (number keys 1-0). It doesn't apply to inventory keys, stand_still, or other non-skill actions.
+
+## What Would Improve Stealth Further
+
+### High Impact (Warden likely checks these)
+1. **Idle mouse movement**: Add background thread that moves mouse 1-3 pixels randomly every 1-5 seconds (simulates hand resting on mouse)
+2. **Occasional straight-line clicks**: 10% of the time skip the Bezier curve and click directly (humans don't always move in curves)
+
+### Medium Impact
+3. **Process parent spoofing**: Launch the bot from a different process (e.g. from Explorer instead of directly) to hide the relationship with D2R
+4. **Variable scroll speed**: Add variance to `mouse.wheel()` calls (inventory scrolling)
+5. **Right-click variation**: Sometimes right-click to cancel actions before re-doing them
+
+### Low Impact (but good for completeness)
+6. **Randomize AFK break more**: Current range is 2-12 minutes, could be wider
+7. **Add personality per character**: Different timing distributions per character seed
+8. **Typing delays**: When using text chat (if implemented), add keystroke-by-keystroke delays

assets/NTItemAlias.dbl

@@ -100,6 +100,9 @@ NTIPAliasType["ruby"] = 99;
 NTIPAliasType["sapphire"] = 100;
 NTIPAliasType["topaz"] = 101;
 NTIPAliasType["skull"] = 102;
+NTIPAliasType["swordsandknives"] = 103;
+NTIPAliasType["spearsandpolearms"] = 104;
+NTIPAliasType["grimoires"] = 105;
 
 var NTIPAliasClassID = {};
 NTIPAliasClassID["hax"] = 0;    NTIPAliasClassID["handaxe"] = 0;
@@ -761,6 +764,26 @@ NTIPAliasClassID["ceh"] = 655;  NTIPAliasClassID["chargedessenceofhatred"] = 655
 NTIPAliasClassID["bet"] = 656;  NTIPAliasClassID["burningessenceofterror"] = 656;
 NTIPAliasClassID["fed"] = 657;  NTIPAliasClassID["festeringessenceofdestruction"] = 657;
 NTIPAliasClassID["std"] = 658;  NTIPAliasClassID["standardofheroes"] = 658;
+NTIPAliasClassID["wa1"] = 659;  NTIPAliasClassID["oldbook"] = 659;
+NTIPAliasClassID["wa2"] = 660;  NTIPAliasClassID["tome"] = 660;
+NTIPAliasClassID["wa3"] = 661;  NTIPAliasClassID["codex"] = 661;
+NTIPAliasClassID["wa4"] = 662;  NTIPAliasClassID["compendium"] = 662;
+NTIPAliasClassID["wa5"] = 663;  NTIPAliasClassID["grimoire"] = 663;
+NTIPAliasClassID["wa6"] = 664;  NTIPAliasClassID["burnttext"] = 664;
+NTIPAliasClassID["wa7"] = 665;  NTIPAliasClassID["darktome"] = 665;
+NTIPAliasClassID["wa8"] = 666;  NTIPAliasClassID["darkcodex"] = 666;
+NTIPAliasClassID["wa9"] = 667;  NTIPAliasClassID["possessedcompendium"] = 667;
+NTIPAliasClassID["waa"] = 668;  NTIPAliasClassID["possessedgrimoire"] = 668;
+NTIPAliasClassID["wab"] = 669;  NTIPAliasClassID["forgottenvolume"] = 669;
+NTIPAliasClassID["wac"] = 670;  NTIPAliasClassID["occulttome"] = 670;
+NTIPAliasClassID["wad"] = 671;  NTIPAliasClassID["occultcodex"] = 671;
+NTIPAliasClassID["wae"] = 672;  NTIPAliasClassID["blasphemouscompendium"] = 672;
+NTIPAliasClassID["waf"] = 673;  NTIPAliasClassID["blasphemousgrimoire"] = 673;
+                                NTIPAliasClassID["northernworldstoneshard"] = 674;
+                                NTIPAliasClassID["easternworldstoneshard"] = 675;
+                                NTIPAliasClassID["southernworldstoneshard"] = 676;
+                                NTIPAliasClassID["westernworldstoneshard"] = 677;
+                                NTIPAliasClassID["deepworldstoneshard"] = 678;
 
 var NTIPAliasClass = {};
 NTIPAliasClass["normal"] = 0;
@@ -900,6 +923,7 @@ NTIPAliasStat["itemaddpaladinskills"] = [83,3];	NTIPAliasStat["paladinskills"] =
 NTIPAliasStat["itemaddbarbarianskills"] = [83,4];	NTIPAliasStat["barbarianskills"] = [83,4];
 NTIPAliasStat["itemadddruidskills"] = [83,5];	NTIPAliasStat["druidskills"] = [83,5];
 NTIPAliasStat["itemaddassassinskills"] = [83,6];	NTIPAliasStat["assassinskills"] = [83,6];
+NTIPAliasStat["itemaddwarlockskills"] = [83,7];	NTIPAliasStat["warlockskills"] = [83,7];
 
 NTIPAliasStat["unsentparam1"] = 84;
 NTIPAliasStat["itemaddexperience"] = 85;
@@ -931,6 +955,9 @@ NTIPAliasStat["plusskillwerewolf"] = [97,223];
 NTIPAliasStat["plusskillshapeshifting"] = [97,224];	NTIPAliasStat["plusskilllycanthropy"] = [97,224];
 NTIPAliasStat["plusskillsummonspiritwolf"] = [97,227];
 NTIPAliasStat["plusskillferalrage"] = [97,232];
+// Warlock
+NTIPAliasStat["plusskillabyss"] = [97,281]
+NTIPAliasStat["plusskillenhancedentropy"] = [97,282]
 
 NTIPAliasStat["state"] = 98;
 NTIPAliasStat["itemfastergethitrate"] = 99;	NTIPAliasStat["fhr"] = 99;
@@ -1160,6 +1187,9 @@ NTIPAliasStat["skillbladeshield"] = [107,277];
 NTIPAliasStat["skillvenom"] = [107,278];
 NTIPAliasStat["skillshadowmaster"] = [107,279];
 NTIPAliasStat["skillphoenixstrike"] = [107,280];
+// Warlock skills
+NTIPAliasStat["skillabyss"] = [107,281];
+NTIPAliasStat["skillenhancedentropy"] = [107,282];
 
 NTIPAliasStat["itemrestinpeace"] = 108;
 NTIPAliasStat["curseresistance"] = 109;
@@ -1279,6 +1309,9 @@ NTIPAliasStat["itemaddelementalskilltab"] = [188,42];		NTIPAliasStat["elementals
 NTIPAliasStat["itemaddtrapsskilltab"] = [188,48];		NTIPAliasStat["trapsskilltab"] = [188,48];
 NTIPAliasStat["itemaddshadowdisciplinesskilltab"] = [188,49];	NTIPAliasStat["shadowdisciplinesskilltab"] = [188,49];
 NTIPAliasStat["itemaddmartialartsskilltab"] = [188,50];	NTIPAliasStat["martialartsskilltab"] = [188,50];
+NTIPAliasStat["itemaddchaosskilltab"] = [188,51];	NTIPAliasStat["chaosskilltab"] = [188,51];
+NTIPAliasStat["itemaddeldritchskilltab"] = [188,52];	NTIPAliasStat["eldritchskilltab"] = [188,52];
+NTIPAliasStat["itemadddemonskilltab"] = [188,53];	NTIPAliasStat["demonskilltab"] = [188,53];
 
 NTIPAliasStat["unused189"] = 189;
 NTIPAliasStat["unused190"] = 190;

assets/d2r_settings.json

@@ -8,14 +8,14 @@
     "Screen Resolution (Windowed)": "1280x720",
     "Resolution Scale": 100,
     "Sharpening": 6,
-    "Game Resolution": 1,
+    "Game Resolution": 2,
     "Light Quality": 2,
     "Blended Shadows": 0,
     "Perspective": 0,
     "VSync": 1,
     "Framerate Cap": 60,
     "Framerate Target": 0,
-    "Window Mode": 0,
+    "Window Mode": 1,
     "Graphic Presets": 4,
     "Texture Quality": 4,
     "Texture Anisotropy": 0,

assets/mods/botty/botty.mpq/data/local/lng/strings/item-nameaffixes.json

@@ -17066,5 +17066,464 @@
     "ptBR": "Berserker",
     "ruRU": "[ms]лютый[fs]лютая[ns]лютое[pl]лютые",
     "zhCN": "狂战士"
+  },
+  {
+    "id": 27875,
+    "Key": "Virulent",
+    "enUS": "Virulent",
+    "zhTW": "怨毒",
+    "deDE": "[ms]Virulenter[fs]Virulente[ns]Virulentes[pl]Virulente",
+    "esES": "[fs]virulenta[ms]virulento[fp]virulentas[mp]virulentos",
+    "frFR": "[ms]virulent[fs]virulente[mp]virulents[fp]virulentes",
+    "itIT": "[ms]Virulento[fs]Virulenta[mp]Virulenti[fp]Virulente",
+    "koKR": "악성",
+    "plPL": "[ms]Zakażający[fs]Zakażająca[ns]Zakażające[p]Zakażające",
+    "esMX": "[ms]virulento[fs]virulenta[mp]virulentos[fp]virulentas",
+    "jaJP": "猛毒に満ちた",
+    "ptBR": "[fs]Virulenta[fp]Virulentas[ms]Virulento[mp]Virulentos",
+    "ruRU": "[ms]едкий[fs]едкая[ns]едкое[pl]едкие",
+    "zhCN": "剧毒"
+  },
+  {
+    "id": 27876,
+    "Key": "of Acidity",
+    "enUS": "of Acidity",
+    "zhTW": "酸蝕之",
+    "deDE": "der Säure",
+    "esES": "de acidez",
+    "frFR": "d’acidité",
+    "itIT": "dell'Acidità",
+    "koKR": "산성의",
+    "plPL": "Kwasowości",
+    "esMX": "de acidez",
+    "jaJP": "酸性の",
+    "ptBR": "da Acidez",
+    "ruRU": "едкости",
+    "zhCN": "酸蚀之"
+  },
+  {
+    "id": 27877,
+    "Key": "Incendiary",
+    "enUS": "Incendiary",
+    "zhTW": "煽火",
+    "deDE": "[ms]Zündelnder[fs]Zündelnde[ns]Zündelndes[pl]Zündelnde",
+    "esES": "[fs]incendiaria[ms]incendiario[fp]incendiarias[mp]incendiarios",
+    "frFR": "[ms]incendiaire[fs]incendiaire[mp]incendiaires[fp]incendiaires",
+    "itIT": "[ms]Incendiario[fs]Incendiaria[mp]Incendiari[fp]Incendiarie",
+    "koKR": "방화",
+    "plPL": "[ms]Zapalający[fs]Zapalająca[ns]Zapalające[p]Zapalające",
+    "esMX": "[ms]incendiario[fs]incendiaria[mp]incendiarios[fp]incendiarias",
+    "jaJP": "焼夷の",
+    "ptBR": "[fs]Incendiária[fp]Incendiárias[ms]Incendiário[mp]Incendiários",
+    "ruRU": "[ms]воспламеняющий[fs]воспламеняющая[ns]воспламеняющее[pl]воспламеняющие",
+    "zhCN": "焚烧"
+  },
+  {
+    "id": 27878,
+    "Key": "of Kindling",
+    "enUS": "of Kindling",
+    "zhTW": "引火之",
+    "deDE": "des Entfachens",
+    "esES": "de fajina",
+    "frFR": "de petit bois",
+    "itIT": "dell'Accensione",
+    "koKR": "불쏘시개의",
+    "plPL": "Rozpalania",
+    "esMX": "de incendaja",
+    "jaJP": "種火の",
+    "ptBR": "da Combustão",
+    "ruRU": "разжигания",
+    "zhCN": "点燃之"
+  },
+  {
+    "id": 27879,
+    "Key": "Gelid",
+    "enUS": "Gelid",
+    "zhTW": "嚴寒",
+    "deDE": "[ms]Eiskalter[fs]Eiskalte[ns]Eiskaltes[pl]Eiskalte",
+    "esES": "[fs]gélida[ms]gélido[fp]gélidas[mp]gélidos",
+    "frFR": "[ms]transi[fs]transie[mp]transis[fp]transies",
+    "itIT": "[ms]Gelido[fs]Gelida[mp]Gelidi[fp]Gelide",
+    "koKR": "혹한",
+    "plPL": "[ms]Zlodowaciały[fs]Zlodowaciała[ns]Zlodowaciałe[p]Zlodowaciałe",
+    "esMX": "[ms]gélido[fs]gélida[mp]gélidos[fp]gélidas",
+    "jaJP": "氷結",
+    "ptBR": "[fs]Gélida[fp]Gélidas[ms]Gélido[mp]Gélidos",
+    "ruRU": "[ms]застывший[fs]застывшая[ns]застывшее[pl]застывшие",
+    "zhCN": "极寒"
+  },
+  {
+    "id": 27880,
+    "Key": "of Numbing",
+    "enUS": "of Numbing",
+    "zhTW": "麻木之",
+    "deDE": "des Erstarrens",
+    "esES": "de entumecimiento",
+    "frFR": "d’engourdissement",
+    "itIT": "dell'Intorpidimento",
+    "koKR": "마비의",
+    "plPL": "Odrętwienia",
+    "esMX": "de entumecimiento",
+    "jaJP": "麻痺の",
+    "ptBR": "do Entorpecimento",
+    "ruRU": "обморожения",
+    "zhCN": "麻痹之"
+  },
+  {
+    "id": 27881,
+    "Key": "Magnetic",
+    "enUS": "Magnetic",
+    "zhTW": "磁性",
+    "deDE": "[ms]Magnetischer[fs]Magnetische[ns]Magnetisches[pl]Magnetische",
+    "esES": "[fs]magnética[ms]magnético[fp]magnéticas[mp]magnéticos",
+    "frFR": "[ms]magnétique[fs]magnétique[mp]magnétiques[fp]magnétiques",
+    "itIT": "[ms]Magnetico[fs]Magnetica[mp]Magnetici[fp]Magnetiche",
+    "koKR": "자성",
+    "plPL": "[ms]Magnetyczny[fs]Magnetyczna[ns]Magnetyczne[p]Magnetyczne",
+    "esMX": "[ms]magnético[fs]magnética[mp]magnéticos[fp]magnéticas",
+    "jaJP": "超電磁",
+    "ptBR": "[fs]Magnética[fp]Magnéticas[ms]Magnético[mp]Magnéticos",
+    "ruRU": "[ms]магнитный[fs]магнитная[ns]магнитное[pl]магнитные",
+    "zhCN": "磁性"
+  },
+  {
+    "id": 27882,
+    "Key": "of Conductivity",
+    "enUS": "of Conductivity",
+    "zhTW": "導電之",
+    "deDE": "der Leitfähigkeit",
+    "esES": "de conductividad",
+    "frFR": "de conductivité",
+    "itIT": "della Conduttività",
+    "koKR": "전도성의",
+    "plPL": "Przewodzenia",
+    "esMX": "de conductividad",
+    "jaJP": "通電の",
+    "ptBR": "da Condutividade",
+    "ruRU": "проводимости",
+    "zhCN": "传导之"
+  },
+  {
+    "id": 27883,
+    "Key": "Mystical",
+    "enUS": "Mystical",
+    "zhTW": "神秘",
+    "deDE": "[ms]Mystischer[fs]Mystische[ns]Mystisches[pl]Mystische",
+    "esES": "[fs]mística[ms]místico[fp]místicas[mp]místicos",
+    "frFR": "[ms]mystique[fs]mystique[mp]mystiques[fp]mystiques",
+    "itIT": "[ms]Mistico[fs]Mistica[mp]Mistici[fp]Mistiche",
+    "koKR": "신비한",
+    "plPL": "[ms]Mistyczny[fs]Mistyczna[ns]Mistyczne[p]Mistyczne",
+    "esMX": "[ms]místico[fs]mística[mp]místicos[fp]místicas",
+    "jaJP": "神秘を司る",
+    "ptBR": "[fs]Mística[fp]Místicas[ms]Místico[mp]Místicos",
+    "ruRU": "[ms]мистический[fs]мистическая[ns]мистическое[pl]мистические",
+    "zhCN": "神秘"
+  },
+  {
+    "id": 27884,
+    "Key": "of Thaumaturgy",
+    "enUS": "of Thaumaturgy",
+    "zhTW": "奇術之",
+    "deDE": "der Thaumaturgie",
+    "esES": "de taumaturgia",
+    "frFR": "de thaumaturgie",
+    "itIT": "della Taumaturgia",
+    "koKR": "마도의",
+    "plPL": "Taumaturgii",
+    "esMX": "de taumaturgia",
+    "jaJP": "魔術の",
+    "ptBR": "da Taumaturgia",
+    "ruRU": "чудотворства",
+    "zhCN": "奇术之"
+  },
+  {
+    "id": 27885,
+    "Key": "Breaching",
+    "enUS": "Breaching",
+    "zhTW": "突破",
+    "deDE": "[ms]Brechender[fs]Brechende[ns]Brechendes[pl]Brechende",
+    "esES": "[fs]quebrantadora[ms]quebrantador[fp]quebrantadoras[mp]quebrantadores",
+    "frFR": "[ms]offensif[fs]offensive[mp]offensifs[fp]offensives",
+    "itIT": "[ms]Penetrante[fs]Penetrante[mp]Penetranti[fp]Penetranti",
+    "koKR": "침범하는",
+    "plPL": "[ms]Przełamujący[fs]Przełamująca[ns]Przełamujące[p]Przełamujące",
+    "esMX": "[ms]vulnerante[fs]vulnerante[mp]vulnerantes[fp]vulnerantes",
+    "jaJP": "強行突破",
+    "ptBR": "[fs]Abrangente[fp]Abrangentes[ms]Abrangente[mp]Abrangentes",
+    "ruRU": "[ms]ломающий[fs]ломающая[ns]ломающее[pl]ломающие",
+    "zhCN": "破甲"
+  },
+  {
+    "id": 27886,
+    "Key": "of Force",
+    "enUS": "of Force",
+    "zhTW": "力迫之",
+    "deDE": "der Macht",
+    "esES": "de pujanza",
+    "frFR": "de force",
+    "itIT": "della Potenza",
+    "koKR": "위력의",
+    "plPL": "Mocy",
+    "esMX": "de potencia",
+    "jaJP": "力の",
+    "ptBR": "de Força",
+    "ruRU": "принуждения",
+    "zhCN": "力量之"
+  },
+  {
+    "id": 27893,
+    "Key": "Chaotic",
+    "enUS": "Chaotic",
+    "zhTW": "混沌",
+    "deDE": "[ms]Chaotischer[fs]Chaotische[ns]Chaotisches[pl]Chaotische",
+    "esES": "[fs]caótica[ms]caótico[fp]caóticas[mp]caóticos",
+    "frFR": "[ms]chaotique[fs]chaotique[mp]chaotiques[fp]chaotiques",
+    "itIT": "[ms]Caotico[fs]Caotica[mp]Caotici[fp]Caotiche",
+    "koKR": "혼돈",
+    "plPL": "[ms]Chaotyczny[fs]Chaotyczna[ns]Chaotyczne[p]Chaotyczne",
+    "esMX": "[ms]caótico[fs]caótica[mp]caóticos[fp]caóticas",
+    "jaJP": "混乱せし",
+    "ptBR": "[fs]Conturbada[fp]Conturbadas[ms]Conturbado[mp]Conturbados",
+    "ruRU": "[ms]хаотический[fs]хаотическая[ns]хаотическое[pl]хаотические",
+    "zhCN": "混乱"
+  },
+  {
+    "id": 27894,
+    "Key": "Sullied",
+    "enUS": "Sullied",
+    "zhTW": "玷汙",
+    "deDE": "[ms]Beschmutzter[fs]Beschmutzte[ns]Beschmutztes[pl]Beschmutzte",
+    "esES": "[fs]maculada[ms]maculado[fp]maculadas[mp]maculados",
+    "frFR": "[ms]profané[fs]profanée[mp]profanés[fp]profanées",
+    "itIT": "[ms]Infangato[fs]Infangata[mp]Infangati[fp]Infangate",
+    "koKR": "더럽혀진",
+    "plPL": "[ms]Splugawiony[fs]Splugawiona[ns]Splugawione[p]Splugawione",
+    "esMX": "[ms]mancillado[fs]mancillada[mp]mancillados[fp]mancilladas",
+    "jaJP": "汚物の",
+    "ptBR": "[fs]Manchada[fp]Manchadas[ms]Manchado[mp]Manchados",
+    "ruRU": "[ms]пятнающий[fs]пятнающая[ns]пятнающее[pl]пятнающие",
+    "zhCN": "污染"
+  },
+  {
+    "id": 27895,
+    "Key": "Fiendish",
+    "enUS": "Fiendish",
+    "zhTW": "妖魔",
+    "deDE": "[ms]Teuflischer[fs]Teuflische[ns]Teuflisches[pl]Teuflische",
+    "esES": "[fs]maligna[ms]maligno[fp]malignas[mp]malignos",
+    "frFR": "[ms]diabolique[fs]diabolique[mp]diaboliques[fp]diaboliques",
+    "itIT": "[ms]Mostruoso[fs]Mostruosa[mp]Mostruosi[fp]Mostruose",
+    "koKR": "극악한",
+    "plPL": "[ms]Czarci[fs]Czarcia[ns]Czarcie[p]Czarcie",
+    "esMX": "[ms]diablesco[fs]diablesca[mp]diablescos[fp]diablescas",
+    "jaJP": "悪魔のような",
+    "ptBR": "[fs]Demoníaca[fp]Demoníacas[ms]Demoníaco[mp]Demoníacos",
+    "ruRU": "[ms]бесовский[fs]бесовская[ns]бесовское[pl]бесовские",
+    "zhCN": "邪鬼"
+  },
+  {
+    "id": 27896,
+    "Key": "Erratic",
+    "enUS": "Erratic",
+    "zhTW": "失序",
+    "deDE": "[ms]Unberechenbarer[fs]Unberechenbare[ns]Unberechenbares[pl]Unberechenbare",
+    "esES": "[fs]errática[ms]errático[fp]erráticas[mp]erráticos",
+    "frFR": "[ms]erratique[fs]erratique[mp]erratiques[fp]erratiques",
+    "itIT": "[ms]Imprevedibile[fs]Imprevedibile[mp]Imprevedibili[fp]Imprevedibili",
+    "koKR": "변덕스러운",
+    "plPL": "[ms]Rozpaczliwy[fs]Rozpaczliwa[ns]Rozpaczliwe[p]Rozpaczliwe",
+    "esMX": "[ms]errático[fs]errática[mp]erráticos[fp]erráticas",
+    "jaJP": "奇矯な",
+    "ptBR": "[fs]Errática[fp]Erráticas[ms]Errático[mp]Erráticos",
+    "ruRU": "[ms]беспорядочный[fs]беспорядочная[ns]беспорядочное[pl]беспорядочные",
+    "zhCN": "善变"
+  },
+  {
+    "id": 27897,
+    "Key": "Torrid",
+    "enUS": "Torrid",
+    "zhTW": "熾熱",
+    "deDE": "[ms]Sengender[fs]Sengende[ns]Sengendes[pl]Sengende",
+    "esES": "[fs]tórrida[ms]tórrido[fp]tórridas[mp]tórridos",
+    "frFR": "[ms]torride[fs]torride[mp]torrides[fp]torrides",
+    "itIT": "[ms]Torrido[fs]Torrida[mp]Torridi[fp]Torride",
+    "koKR": "격한",
+    "plPL": "[ms]Palący[fs]Paląca[ns]Palące[p]Palące",
+    "esMX": "[ms]tórrido[fs]tórrida[mp]tórridos[fp]tórridas",
+    "jaJP": "熱烈な",
+    "ptBR": "[fs]Tórrida[fp]Tórridas[ms]Tórrido[mp]Tórridos",
+    "ruRU": "[ms]жгучий[fs]жгучая[ns]жгучее[pl]жгучие",
+    "zhCN": "灼热"
+  },
+  {
+    "id": 27898,
+    "Key": "TaintedAffix",
+    "enUS": "Tainted",
+    "zhTW": "魔汙",
+    "deDE": "[ms]Besudelter[fs]Besudelte[ns]Besudeltes[pl]Besudelte",
+    "esES": "[fs]mancillada[ms]mancillado[fp]mancilladas[mp]mancillados",
+    "frFR": "[ms]corrompu[fs]corrompue[mp]corrompus[fp]corrompues",
+    "itIT": "[ms]Contaminato[fs]Contaminata[mp]Contaminati[fp]Contaminate",
+    "koKR": "오염된",
+    "plPL": "[ms]Splamiony[fs]Splamiona[ns]Splamione[p]Splamione",
+    "esMX": "[ms]contaminado[fs]contaminada[mp]contaminados[fp]contaminadas",
+    "jaJP": "穢された",
+    "ptBR": "[fs]Maculada[fp]Maculadas[ms]Maculado[mp]Maculados",
+    "ruRU": "[ms]помутненный[fs]помутненная[ns]помутненное[pl]помутненные",
+    "zhCN": "污染"
+  },
+  {
+    "id": 27899,
+    "Key": "Forbidden",
+    "enUS": "Forbidden",
+    "zhTW": "封禁",
+    "deDE": "[ms]Verbotener[fs]Verbotene[ns]Verbotenes[pl]Verbotene",
+    "esES": "[fs]prohibida[ms]prohibido[fp]prohibidas[mp]prohibidos",
+    "frFR": "[ms]interdit[fs]interdite[mp]interdits[fp]interdites",
+    "itIT": "[ms]Proibito[fs]Proibita[mp]Proibiti[fp]Proibite",
+    "koKR": "금지된",
+    "plPL": "[ms]Zakazany[fs]Zakazana[ns]Zakazane[p]Zakazane",
+    "esMX": "[ms]prohibido[fs]prohibida[mp]prohibidos[fp]prohibidas",
+    "jaJP": "禁断なる",
+    "ptBR": "[fs]Proibida[fp]Proibidas[ms]Proibido[mp]Proibidos",
+    "ruRU": "[ms]запретный[fs]запретная[ns]запретное[pl]запретные",
+    "zhCN": "禁忌"
+  },
+  {
+    "id": 27900,
+    "Key": "Dreadful",
+    "enUS": "Dreadful",
+    "zhTW": "怖懼",
+    "deDE": "[ms]Furchterregender[fs]Furchterregende[ns]Furchterregendes[pl]Furchterregende",
+    "esES": "[fs]pavorosa[ms]pavoroso[fp]pavorosas[mp]pavorosos",
+    "frFR": "[ms]effroyable[fs]effroyable[mp]effroyables[fp]effroyables",
+    "itIT": "[ms]Terrificante[fs]Terrificante[mp]Terrificanti[fp]Terrificanti",
+    "koKR": "무시무시한",
+    "plPL": "[ms]Przerażający[fs]Przerażająca[ns]Przerażające[p]Przerażające",
+    "esMX": "[ms]espantoso[fs]espantosa[mp]espantosos[fp]espantosas",
+    "jaJP": "恐ろしき",
+    "ptBR": "[fs]Pavorosa[fp]Pavorosas[ms]Pavoroso[mp]Pavorosos",
+    "ruRU": "[ms]жуткий[fs]жуткая[ns]жуткое[pl]жуткие",
+    "zhCN": "可怖"
+  },
+  {
+    "id": 27901,
+    "Key": "Malevolent",
+    "enUS": "Malevolent",
+    "zhTW": "惡毒",
+    "deDE": "[ms]Arglistiger[fs]Arglistige[ns]Arglistiges[pl]Arglistige",
+    "esES": "[fs]malévola[ms]malévolo[fp]malévolas[mp]malévolos",
+    "frFR": "[ms]malfaisant[fs]malfaisante[mp]malfaisants[fp]malfaisantes",
+    "itIT": "[ms]Malevolo[fs]Malevola[mp]Malevoli[fp]Malevole",
+    "koKR": "고약한",
+    "plPL": "[ms]Złowrogi[fs]Złowroga[ns]Złowrogie[p]Złowrogie",
+    "esMX": "[fs]malevolente[ms]malevolente[fp]malevolentes[mp]malevolentes",
+    "jaJP": "悪しき",
+    "ptBR": "[fs]Malévola[fp]Malévolas[ms]Malévolo[mp]Malévolos",
+    "ruRU": "[ms]злонравный[fs]злонравная[ns]злонравное[pl]злонравные",
+    "zhCN": "恶意"
+  },
+  {
+    "id": 27902,
+    "Key": "of Miasma Bolt",
+    "enUS": "of Miasma Bolt",
+    "zhTW": "瘴氣彈之",
+    "deDE": "des Miasmablitzes",
+    "esES": "de descarga de miasma",
+    "frFR": "de traits de miasmes",
+    "itIT": "del Dardo Miasmatico",
+    "koKR": "독기 볼트의",
+    "plPL": "Miazmatycznego Pocisku",
+    "esMX": "de saeta de miasma",
+    "jaJP": "ミアズマボルトの",
+    "ptBR": "da Seta de Miasma",
+    "ruRU": "стрелы миазм",
+    "zhCN": "瘴气弹之"
+  },
+  {
+    "id": 27903,
+    "Key": "of Lethargy",
+    "enUS": "of Lethargy",
+    "zhTW": "昏沉之",
+    "deDE": "der Lethargie",
+    "esES": "de letargo",
+    "frFR": "de léthargie",
+    "itIT": "della Letargia",
+    "koKR": "무기력의",
+    "plPL": "Otępienia",
+    "esMX": "de letargo",
+    "jaJP": "沈滞の",
+    "ptBR": "da Letargia",
+    "ruRU": "летаргии",
+    "zhCN": "迟缓之"
+  },
+  {
+    "id": 27904,
+    "Key": "of Rancor",
+    "enUS": "of Rancor",
+    "zhTW": "冤仇之",
+    "deDE": "des Grolls",
+    "esES": "de rencor",
+    "frFR": "de rancœur",
+    "itIT": "del Rancore",
+    "koKR": "울분의",
+    "plPL": "Animozji",
+    "esMX": "de rencor",
+    "jaJP": "怨恨の",
+    "ptBR": "do Rancor",
+    "ruRU": "озлобленности",
+    "zhCN": "怨恨之"
+  },
+  {
+    "id": 27905,
+    "Key": "of Apocalypse",
+    "enUS": "of Apocalypse",
+    "zhTW": "天啟末日之",
+    "deDE": "der Apokalypse",
+    "esES": "de la hecatombe",
+    "frFR": "d’apocalypse",
+    "itIT": "dell'Apocalisse",
+    "koKR": "종말의",
+    "plPL": "Apokalipsy",
+    "esMX": "de apocalipsis",
+    "jaJP": "終焉の",
+    "ptBR": "do Apocalipse",
+    "ruRU": "апокалипсиса",
+    "zhCN": "末日之"
+  },
+  {
+    "id": 27912,
+    "Key": "Devil's",
+    "enUS": "Devil's",
+    "zhTW": "妖鬼的",
+    "deDE": "[ms]Diabolischer[fs]Diabolische[ns]Diabolisches[pl]Diabolische",
+    "esES": "del demonio",
+    "frFR": "de démon",
+    "itIT": "del Diavolo",
+    "koKR": "악마",
+    "plPL": "[ms]Diabelski[fs]Diabelska[ns]Diabelskie[p]Diabelskie",
+    "esMX": "[ms]del demontre[fs]del demontre[mp]del demontre[fp]del demontre",
+    "jaJP": "悪魔が携えし",
+    "ptBR": "do Demônio",
+    "ruRU": "[ms]дьявольский[fs]дьявольская[ns]дьявольское[pl]дьявольские",
+    "zhCN": "恶魔的"
+  },
+  {
+    "id": 27913,
+    "Key": "Arch-Devil's",
+    "enUS": "Arch-Devil's",
+    "zhTW": "大妖鬼",
+    "deDE": "[ms]Erzdiabolischer[fs]Erzdiabolische[ns]Erzdiabolisches[pl]Erzdiabolische",
+    "esES": "del archidemonio",
+    "frFR": "d’archidémon",
+    "itIT": "dell'Arcidiavolo",
+    "koKR": "고위악마",
+    "plPL": "[ms]Arcydiabelski[fs]Arcydiabelska[ns]Arcydiabelskie[p]Arcydiabelskie",
+    "esMX": "[ms]del archidemontre[fs]del archidemontre[mp]del archidemontre[fp]del archidemontre",
+    "jaJP": "大悪魔の",
+    "ptBR": "do Arquidemônio",
+    "ruRU": "[ms]архидьявольский[fs]архидьявольская[ns]архидьявольское[pl]архидьявольские",
+    "zhCN": "大恶魔的"
   }
 ]

assets/mods/botty/botty.mpq/data/local/lng/strings/item-runes.json

@@ -4010,5 +4010,209 @@
         "ptBR": "Zefir",
         "ruRU": "Бриз",
         "zhCN": "和风"
-    }
+    },
+  {
+    "id": 27360,
+    "Key": "Runeword171",
+    "enUS": "Hysteria",
+    "zhTW": "歇斯底里",
+    "deDE": "Hysterie",
+    "esES": "Histeria",
+    "frFR": "Hystérie",
+    "itIT": "Isteria",
+    "koKR": "발작",
+    "plPL": "Histeria",
+    "esMX": "Histeria",
+    "jaJP": "発奮",
+    "ptBR": "Histeria",
+    "ruRU": "Истерия",
+    "zhCN": "狂乱"
+  },
+  {
+    "id": 27361,
+    "Key": "Runeword172",
+    "enUS": "Mania",
+    "zhTW": "狂躁",
+    "deDE": "Manie",
+    "esES": "Obsesión",
+    "frFR": "Mania",
+    "itIT": "Mania",
+    "koKR": "광기",
+    "plPL": "Mania",
+    "esMX": "Manía",
+    "jaJP": "マニア",
+    "ptBR": "Obsessão",
+    "ruRU": "Мания",
+    "zhCN": "癫狂"
+  },
+  {
+    "id": 27362,
+    "Key": "Runeword173",
+    "enUS": "Mosaic",
+    "zhTW": "嵌飾",
+    "deDE": "Mosaik",
+    "esES": "Mosaico",
+    "frFR": "Mosaïque",
+    "itIT": "Mosaico",
+    "koKR": "모자이크",
+    "plPL": "Mozaika",
+    "esMX": "Mosaico",
+    "jaJP": "坩堝",
+    "ptBR": "Mosaico",
+    "ruRU": "Мозаика",
+    "zhCN": "模糊"
+  },
+  {
+    "id": 27363,
+    "Key": "Runeword174",
+    "enUS": "Metamorphosis",
+    "zhTW": "變化",
+    "deDE": "Metamorphose",
+    "esES": "Metamorfosis",
+    "frFR": "Métamorphose",
+    "itIT": "Metamorfosi",
+    "koKR": "탈태",
+    "plPL": "Metamorfoza",
+    "esMX": "Metamorfosis",
+    "jaJP": "変容",
+    "ptBR": "Metamorfose",
+    "ruRU": "Метаморфоза",
+    "zhCN": "变形"
+  },
+  {
+    "id": 27364,
+    "Key": "Runeword175",
+    "enUS": "Ground",
+    "zhTW": "接地",
+    "deDE": "Boden",
+    "esES": "Tierra",
+    "frFR": "Terre",
+    "itIT": "Suolo",
+    "koKR": "접지",
+    "plPL": "Grunt",
+    "esMX": "Suelo",
+    "jaJP": "大地",
+    "ptBR": "Solo",
+    "ruRU": "Земля",
+    "zhCN": "接地"
+  },
+  {
+    "id": 27365,
+    "Key": "Runeword176",
+    "enUS": "Temper",
+    "zhTW": "和緩",
+    "deDE": "Temperament",
+    "esES": "Temperamento",
+    "frFR": "Tempérament",
+    "itIT": "Tempra",
+    "koKR": "담금질",
+    "plPL": "Charakter",
+    "esMX": "Ira",
+    "jaJP": "沈着",
+    "ptBR": "Índole",
+    "ruRU": "Закалка",
+    "zhCN": "淬火"
+  },
+  {
+    "id": 27366,
+    "Key": "Runeword177",
+    "enUS": "Hearth",
+    "zhTW": "火爐",
+    "deDE": "Heim",
+    "esES": "Hogar",
+    "frFR": "Âtre",
+    "itIT": "Focolare",
+    "koKR": "화로",
+    "plPL": "Palenisko",
+    "esMX": "Fogón",
+    "jaJP": "炉辺",
+    "ptBR": "Lar",
+    "ruRU": "Очаг",
+    "zhCN": "壁炉"
+  },
+  {
+    "id": 27367,
+    "Key": "Runeword178",
+    "enUS": "Cure",
+    "zhTW": "治癒",
+    "deDE": "Heilung",
+    "esES": "Cura",
+    "frFR": "Remède",
+    "itIT": "Cura",
+    "koKR": "치료",
+    "plPL": "Remedium",
+    "esMX": "Cura",
+    "jaJP": "治癒",
+    "ptBR": "Cura",
+    "ruRU": "Лекарство",
+    "zhCN": "解药"
+  },
+  {
+    "id": 27650,
+    "Key": "Runeword180",
+    "enUS": "Coven",
+    "zhTW": "巫師會",
+    "deDE": "Zirkel",
+    "esES": "Aquelarre",
+    "frFR": "Cabale",
+    "itIT": "Congrega",
+    "koKR": "마녀단",
+    "plPL": "Sabat",
+    "esMX": "Aquelarre",
+    "jaJP": "集会",
+    "ptBR": "Pacto",
+    "ruRU": "Ковен",
+    "zhCN": "女巫团"
+  },
+  {
+    "id": 27651,
+    "Key": "Runeword181",
+    "enUS": "Vigilance",
+    "zhTW": "戒慎",
+    "deDE": "Wachsamkeit",
+    "esES": "Vigilancia",
+    "frFR": "Vigilance",
+    "itIT": "Vigilanza",
+    "koKR": "경계",
+    "plPL": "Czujność",
+    "esMX": "Vigilancia",
+    "jaJP": "警戒",
+    "ptBR": "Vigilância",
+    "ruRU": "Бдительность",
+    "zhCN": "警戒"
+  },
+  {
+    "id": 27652,
+    "Key": "Runeword182",
+    "enUS": "Ritual",
+    "zhTW": "儀式",
+    "deDE": "Ritual",
+    "esES": "Ritual",
+    "frFR": "Rituel",
+    "itIT": "Rituale",
+    "koKR": "의식",
+    "plPL": "Rytuał",
+    "esMX": "Ritual",
+    "jaJP": "儀式",
+    "ptBR": "Ritual",
+    "ruRU": "Ритуал",
+    "zhCN": "仪式"
+  },
+  {
+    "id": 27974,
+    "Key": "Runeword179",
+    "enUS": "Bulwark",
+    "zhTW": "壁壘",
+    "deDE": "Bollwerk",
+    "esES": "Baluarte",
+    "frFR": "Rempart",
+    "itIT": "Baluardo",
+    "koKR": "방벽",
+    "plPL": "Szaniec",
+    "esMX": "Baluarte",
+    "jaJP": "防塁",
+    "ptBR": "Baluarte",
+    "ruRU": "Оплот",
+    "zhCN": "壁垒"
+  }
 ]

assets/word_lists/all_words.txt

@@ -11,6 +11,7 @@
 (OPTIONAL)
 (PALADIN
 (SORCERESS
+(WARLOCK
 A
 ABADDON
 ABHAYA
@@ -75,6 +76,7 @@ AJHEED
 AKARA
 AKARAN
 AKARAT'S
+AL'DIABOLOS
 ALACRITY
 ALADDIN'S
 ALARIC
@@ -175,6 +177,7 @@ ARREAT
 ARREAT'S
 ARROW
 ARROWS
+ARS
 ARSENAL
 ART
 ARTFUL
@@ -339,6 +342,7 @@ BLADEBUCKLE
 BLADES
 BLAISE
 BLANCHED
+BLASPHEMOUS
 BLAST
 BLASTBARK
 BLAZE
@@ -551,8 +555,8 @@ CHAMPION
 CHANCE
 CHANDELIER
 CHANG
-CHANNEL.
 CHANNEL:
+CHANNEL.
 CHANT
 CHAOS
 CHAOTIC
@@ -561,8 +565,8 @@ CHARGE
 CHARGE-UP
 CHARGED
 CHARGES
-CHARGES)
 CHARGES:
+CHARGES)
 CHARM
 CHARSI
 CHARSI'S
@@ -603,6 +607,7 @@ CLAYMORE
 CLEANSING
 CLEARED
 CLEAVER
+CLEFT
 CLEGLAW'S
 CLICK
 CLICKING
@@ -625,6 +630,7 @@ COBALT
 COBRA
 COCOON
 CODE:
+CODEX
 COFFIN
 COIF
 COIL
@@ -653,10 +659,11 @@ COMMUNAL
 COMPACT
 COMPARE
 COMPELLING
+COMPENDIUM
 COMPLETE
 COMPLETED
-COMPLETED.
 COMPLETED:
+COMPLETED.
 COMPOSITE
 CONCENTRATE
 CONCENTRATION
@@ -826,6 +833,7 @@ DECKARD
 DECLARE
 DECOY
 DECREPIFY
+DEEP
 DEFEAT
 DEFENDER
 DEFENSE
@@ -856,8 +864,8 @@ DESTINATION
 DESTROY
 DESTROYER
 DESTRUCTION
-DESTRUCTION'S
 DESTRUCTION.
+DESTRUCTION'S
 DETAIL
 DETAILS.
 DETECT
@@ -879,8 +887,8 @@ DIE
 DIED
 DIES,
 DIFFERENCE
-DIFFERENCE.
 DIFFERENCE:
+DIFFERENCE.
 DIFFERENT
 DIFFICULTY
 DIFFICULTY:
@@ -959,6 +967,7 @@ DRULAN'S
 DRUS
 DRY
 DUE
+DUL'MEPHISTOS
 DUN
 DUNE
 DUNES
@@ -997,6 +1006,7 @@ EARS
 EARTH
 EARTHSHAKER
 EASE
+EASTERN
 EATER
 EATS
 EBURINE
@@ -1412,8 +1422,8 @@ GOBLIN
 GODLY
 GOES
 GOLD
-GOLD.
 GOLD:
+GOLD.
 GOLDEN
 GOLDSKIN
 GOLDSTRIKE
@@ -1460,6 +1470,7 @@ GRIFFON
 GRIFFON'S
 GRIM
 GRIM'S
+GRIMOIRE
 GRIN
 GRINDER
 GRINDING
@@ -1782,8 +1793,8 @@ ITCHIES
 ITEM
 ITEM.
 ITEMS
-ITEMS.
 ITEMS:
+ITEMS.
 ITH
 ITHERA
 ITONYA
@@ -1957,9 +1968,9 @@ LEORIC
 LESSON
 LESTRON'S
 LEVEL
-LEVEL)
 LEVEL-UP
 LEVEL:
+LEVEL)
 LEVELS
 LEVER
 LEVIATHAN
@@ -1971,8 +1982,8 @@ LIDLESS
 LIEF
 LIENE
 LIFE
-LIFE/MANA
 LIFE:
+LIFE/MANA
 LIFECHOKE
 LIGHT
 LIGHTBRAND
@@ -2136,12 +2147,13 @@ MAULER
 MAUSOLEUM
 MAW
 MAX
-MAX.
 MAX:
+MAX.
 MAXIMUM
 MAY
 MCAULEY'S
 MEASURE
+MEASURED
 MEAT
 MEATSCRAPE
 MECHANIC'S
@@ -2261,8 +2273,8 @@ NARPHET
 NATALYA
 NATALYA'S
 NATURAL
-NATURE'S
 NATURE,
+NATURE'S
 NEAR
 NEARBY
 NEBUCHADNEZZAR'S
@@ -2305,6 +2317,7 @@ NONE
 NOOSE
 NORD'S
 NORMAL
+NORTHERN
 NOSFERATU'S
 NOT
 NOVA
@@ -2323,6 +2336,7 @@ OBLIVION
 OBSCENE
 OBSESSION
 OBSIDIAN
+OCCULT
 OCEAN
 OCHER
 OCULUS
@@ -2349,6 +2363,7 @@ ONES
 ONLY
 ONLY)
 OOZE
+OPALVEIN
 OPEN
 OPENS
 OPTIMAL
@@ -2471,8 +2486,8 @@ PLAYED
 PLAYER
 PLAYER.
 PLAYERS
-PLAYERS.
 PLAYERS:
+PLAYERS.
 PLEDGE
 PLUCKEYE
 PLUS
@@ -2617,8 +2632,8 @@ RATMEN
 RATTLE
 RATTLECAGE
 RAVEN
-RAVEN'S
 RAVEN:
+RAVEN'S
 RAVENLORE
 RAVENS
 RAVENS:
@@ -2692,9 +2707,9 @@ REND
 RENDER
 REPAIR
 REPAIRED
+REPAIRED.
 REPAIRED)
 REPAIRED),
-REPAIRED.
 REPAIRING
 REPAIRS
 REPEATING
@@ -2804,6 +2819,7 @@ RUN/WALK
 RUNE
 RUNES
 RUNIC
+RUPTURE
 RUSSET
 RUST
 RUSTHANDLE
@@ -2945,8 +2961,8 @@ SHELL
 SHELTER
 SHENK
 SHIELD
-SHIELD'S
 SHIELD:
+SHIELD'S
 SHIELDS
 SHIELDS:
 SHIFT
@@ -3001,6 +3017,7 @@ SISTER'S
 SIX
 SIZE
 SIZE:
+SLING
 SKELETAL
 SKELETON
 SKELETONS
@@ -3093,6 +3110,7 @@ SOULSTONE
 SOUND
 SOUNDING
 SOURCE
+SOUTHERN
 SPACE
 SPACING
 SPANISH
@@ -3173,8 +3191,8 @@ STARLIGHT
 STARS
 STARS:
 STASH
-STASH.
 STASH:
+STASH.
 STAT
 STAT/SKILL
 STATE
@@ -3303,8 +3321,8 @@ TAINTBREEDER
 TAINTED
 TAKE
 TAKEN
-TAKEN.
 TAKEN:
+TAKEN.
 TAKES
 TAL
 TALBERD'S
@@ -3322,8 +3340,8 @@ TANNR
 TAP
 TARGE
 TARGET
-TARGET'S
 TARGET:
+TARGET'S
 TARGETS
 TARNHELM
 TAUNT
@@ -3353,6 +3371,7 @@ TERRA'S
 TERRENE
 TERROR
 TERROR'S
+TEXT
 THADAR
 THAN
 THANK
@@ -3431,6 +3450,7 @@ TOOTH
 TOOTHROW
 TOP
 TOPAZ
+TOR'BAALOS
 TORC
 TORCH
 TORKEL
@@ -3645,6 +3665,7 @@ VOID
 VOIDBRINGER
 VOLCANIC
 VOLCANO
+VOLUME
 VOMIR
 VORTEX
 VOULGE
@@ -3653,6 +3674,7 @@ VS.
 VULPINE
 VULTURE
 WACKER
+WAGER
 WAHEED
 WAIL
 WAILING
@@ -3682,6 +3704,7 @@ WARDEN'S
 WARDER
 WARDING
 WARHOUND
+WARLOCK
 WARLORD'S
 WARMING
 WARMTH
@@ -3691,8 +3714,8 @@ WARPED
 WARPS
 WARPSPEAR
 WARRIOR
-WARRIOR'S
 WARRIOR.
+WARRIOR'S
 WARRIV
 WARRIV'S
 WARSHRIKE
@@ -3715,8 +3738,8 @@ WEAPON
 WEAPON:
 WEAPONS
 WEAPONS,
-WEAPONS.
 WEAPONS:
+WEAPONS.
 WEAVER
 WEB
 WEDDING
@@ -3727,6 +3750,7 @@ WENDY
 WERE
 WEREBEAR
 WEREWOLF
+WESTERN
 WHALE
 WHAT
 WHEEL
@@ -3831,10 +3855,10 @@ YETI
 YEW
 YOLK
 YOU
-YOU'VE
 YOU,
-YOU.
 YOU:
+YOU.
+YOU'VE
 YOUNG
 YOUR
 YOUTH

build.py

@@ -1,102 +0,0 @@
-import os
-import shutil
-from pathlib import Path
-from src.version import __version__
-import argparse
-import getpass
-import random
-from cryptography.fernet import Fernet
-import string
-
-
-parser = argparse.ArgumentParser(description="Build Botty")
-parser.add_argument(
-    "-v" , "--version",
-    type=str,
-    help="New release version e.g. 0.4.2",
-    default=""
-)
-parser.add_argument(
-    "-c", "--conda_path",
-    type=str,
-    help="Path to local conda e.g. C:\\Users\\USER\\miniconda3",
-    default=f"C:\\Users\\{getpass.getuser()}\\miniconda3")
-parser.add_argument(
-    "-r", "--random_name",
-    action='store_true',
-    help="Will generate a random name for the botty exe")
-parser.add_argument(
-    "-k", "--use_key",
-    action='store_true',
-    help="Will build with encryption key")
-args = parser.parse_args()
-
-
-# clean up
-def clean_up():
-    # pyinstaller
-    if os.path.exists("build"):
-        shutil.rmtree("build")
-    if os.path.exists("main.spec"):
-        os.remove("main.spec")
-    if os.path.exists("health_manager.spec"):
-        os.remove("health_manager.spec")
-    if os.path.exists("shopper.spec"):
-        os.remove("shopper.spec")
-
-if __name__ == "__main__":
-    new_version_code = None
-    if args.version != "":
-        print(f"Releasing new version: {args.version}")
-        os.system(f"git checkout -b new-release-v{args.version}")
-        botty_dir = f"botty_v{args.version}"
-        version_code = ""
-        with open('src/version.py', 'r') as f:
-            version_code = f.read()
-        version_code = version_code.split("=")
-        new_version_code = f"{version_code[0]}= '{args.version}'"
-        with open('src/version.py', 'w') as f:
-            f.write(new_version_code)
-    else:
-        botty_dir = f"botty_v{__version__}"
-        print(f"Building version: {__version__}")
-
-    clean_up()
-
-    if os.path.exists(botty_dir):
-        for path in Path(botty_dir).glob("**/*"):
-            if path.is_file():
-                os.remove(path)
-            elif path.is_dir():
-                shutil.rmtree(path)
-        shutil.rmtree(botty_dir)
-
-    for exe in ["main.py", "shopper.py"]:
-        key_cmd = " "
-        if args.use_key:
-            key = Fernet.generate_key().decode("utf-8")
-            key_cmd = " --key " + key
-        installer_cmd = f"pyinstaller --onefile --distpath {botty_dir}{key_cmd} --exclude-module graphviz --paths .\\src --paths {args.conda_path}\\envs\\botty\\Lib\\site-packages src\\{exe}"
-        os.system(installer_cmd)
-
-    os.system(f"cd {botty_dir} && mkdir config && cd ..")
-
-    with open(f"{botty_dir}/config/custom.ini", "w") as f:
-        f.write("; Add parameters you want to overwrite from param.ini here")
-    shutil.copy("config/game.ini", f"{botty_dir}/config/")
-    shutil.copy("config/params.ini", f"{botty_dir}/config/")
-    shutil.copy("config/shop.ini", f"{botty_dir}/config/")
-    shutil.copy("config/default.nip", f"{botty_dir}/config/")
-    os.makedirs(f"{botty_dir}/config/nip", exist_ok=True)
-    shutil.copy("README.md", f"{botty_dir}/")
-    shutil.copytree("assets", f"{botty_dir}/assets")
-    clean_up()
-
-    if args.random_name:
-        print("Generate random names")
-        new_name = ''.join(random.choices(string.ascii_letters, k=random.randint(6, 14)))
-        os.rename(f'{botty_dir}/main.exe', f'{botty_dir}/{new_name}.exe')
-
-    if new_version_code is not None:
-        os.system(f'git add .')
-        os.system(f'git commit -m "Bump version to v{args.version}"')

check_dependencies.bat

@@ -0,0 +1,15 @@
+@echo off
+setlocal
+
+set "BOTTY_DIR=%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%BOTTY_DIR%tools\check_dependencies.ps1"
+set "RC=%ERRORLEVEL%"
+
+if not "%RC%"=="0" (
+  echo.
+  echo Dependency check reported issues.
+)
+
+pause
+exit /b %RC%
+

config/custom.ini.example

@@ -0,0 +1,23 @@
+; Personal overrides for your local machine/user.
+; This file is tracked as an example.
+; Copy to config/custom.ini and edit values there.
+;
+; Botty auto-loads config/custom.ini when present.
+
+[general]
+; name=botty
+; custom_message_hook=
+; custom_loot_message_hook=
+; discord_status_runs=10
+
+[char]
+; type=blizz_sorc
+; atk_len_pindle=3.0
+; show_items=alt
+
+[sorceress]
+; teleport=t
+
+[blizz_sorc]
+; blizzard=f1
+; ice_blast=f2

config/fg_daily_estimates.json

@@ -0,0 +1,93 @@
+{
+  "generated_at": "2026-08-31T06:30:30.597153+00:00",
+  "mode": "offline-improved",
+  "offline_dir": "data\\d2jsp_pages",
+  "ladder_start_date": "2026-05-20",
+  "days": 21,
+  "topics_scanned": 20,
+  "skipped": {
+    "blocked": 2,
+    "no_topic": 0,
+    "no_date": 848,
+    "no_item": 4
+  },
+  "filters": {
+    "min_price_fg": 5.0,
+    "trim_fraction": 0.2
+  },
+  "estimates": {
+    "day_1": {},
+    "day_2": {},
+    "day_3": {},
+    "day_4": {},
+    "day_5": {},
+    "day_6": {
+      "Cham Rune": {
+        "median_fg": 7.5,
+        "avg_fg": 10.0,
+        "trimmed_mean_fg": 7.5,
+        "trimmed_median_fg": 7.5,
+        "min_fg": 5.0,
+        "max_fg": 20.0,
+        "samples": 4,
+        "raw_samples": 6
+      }
+    },
+    "day_7": {
+      "Aldur's Advance": {
+        "median_fg": 20.0,
+        "avg_fg": 21.7,
+        "trimmed_mean_fg": 20.0,
+        "trimmed_median_fg": 20.0,
+        "min_fg": 20.0,
+        "max_fg": 25.0,
+        "samples": 3,
+        "raw_samples": 6
+      },
+      "Ist Rune": {
+        "median_fg": 70.0,
+        "avg_fg": 94.0,
+        "trimmed_mean_fg": 66.7,
+        "trimmed_median_fg": 70.0,
+        "min_fg": 20.0,
+        "max_fg": 250.0,
+        "samples": 5,
+        "raw_samples": 16
+      },
+      "Gul Rune": {
+        "median_fg": 65.0,
+        "avg_fg": 65.0,
+        "trimmed_mean_fg": 65.0,
+        "trimmed_median_fg": 65.0,
+        "min_fg": 20.0,
+        "max_fg": 110.0,
+        "samples": 2,
+        "raw_samples": 4
+      },
+      "Unid Anni": {
+        "median_fg": 575.0,
+        "avg_fg": 575.0,
+        "trimmed_mean_fg": 575.0,
+        "trimmed_median_fg": 575.0,
+        "min_fg": 550.0,
+        "max_fg": 600.0,
+        "samples": 2,
+        "raw_samples": 2
+      }
+    },
+    "day_8": {},
+    "day_9": {},
+    "day_10": {},
+    "day_11": {},
+    "day_12": {},
+    "day_13": {},
+    "day_14": {},
+    "day_15": {},
+    "day_16": {},
+    "day_17": {},
+    "day_18": {},
+    "day_19": {},
+    "day_20": {},
+    "day_21": {}
+  }
+}

config/fg_day_estimates.json

@@ -0,0 +1,50 @@
+{
+  "notes": "Estimated Day 1-14 ladder prices derived from Day 3 snapshot using decay multipliers. Use as planning guidance, not exact market truth.",
+  "source_day": 3,
+  "day_multipliers": {
+    "day_1": 1.45,
+    "day_2": 1.2,
+    "day_3": 1.0,
+    "day_4": 0.93,
+    "day_5": 0.88,
+    "day_6": 0.84,
+    "day_7": 0.8,
+    "day_8": 0.77,
+    "day_9": 0.74,
+    "day_10": 0.72,
+    "day_11": 0.7,
+    "day_12": 0.68,
+    "day_13": 0.66,
+    "day_14": 0.64
+  },
+  "base_day_3_fg": {
+    "Cham Rune": 800,
+    "Lo Rune": 900,
+    "Ohm Rune": 600,
+    "Vex Rune": 400,
+    "Gul Rune": 200,
+    "Ist Rune": 200,
+    "Mal Rune": 120,
+    "Um Rune": 90,
+    "Pul Rune": 50,
+    "Lem Rune": 70,
+    "Unid Anni": 400,
+    "Unid Torch": 1500,
+    "Unid Griffon": 2000,
+    "Unid Eth Andy": 2000,
+    "Shako": 400,
+    "Mara 30": 1200,
+    "Mara Mid": 750,
+    "BK 5": 600,
+    "War Traveler": 500,
+    "Death's Fathom": 800,
+    "5/5 Facet": 500,
+    "5@res SC": 300,
+    "20life SC": 100,
+    "7mf SC": 100,
+    "Pcomb SK": 200,
+    "Cold SK": 250,
+    "Java SK": 200,
+    "Light SK": 200
+  }
+}

config/game.ini

@@ -18,7 +18,7 @@ rejuv_potion=140,50,40,160,255,255
 skill_charges=70,30,25,150,163,255
 health_globe_red=178,110,20,183,255,255
 health_globe_green=47,90,20,54,255,255
-mana_globe=117,120,20,121,255,255
+mana_globe=110,50,15,125,255,255
 blue_slot=102,194,18,138,230,54
 green_slot=33,181,18,87,258,69
 red_slot=161,204,28,197,240,64
@@ -51,8 +51,8 @@ potion1_y=695
 potion_width=30
 potion_height=30
 potion_next=41
-merc_health_top=14
-merc_health_left=15
+merc_health_top=675
+merc_health_left=305
 merc_health_width=40
 ; skills
 skill_y=693
@@ -70,8 +70,8 @@ wp_act_btn_width=67
 wp_first_btn_x=227
 wp_first_btn_y=129
 wp_btn_height=47
-; pickit
-item_dist=267
+; pickit **Note: 120 is apx pickup range. Set to this value or below to prevent walking on pickup
+item_dist=121 
 ; pather
 reached_node_dist=100
 min_walk_dist=25
@@ -88,24 +88,26 @@ play_btn=426,616,320,71
 difficulty_select=536,236,210,320
 gold_btn=997,521,20,18
 inventory_gold=980,510,150,40
-gold_btn_stash=150,480,40,65
+gold_btn_stash=158,518,30,30
 vendor_gold_digits=186,509,97,16
-stash_gold_digits=185,507,99,15
+stash_gold_digits=184,527,100,16
 inventory_gold_digits=1017,523,100,16
+stash_page_digits=222,478,10,15
 health_globe=160,580,240,140
 mana_globe=887,580,240,140
 health_slice=309,610,7,101
 mana_slice=961,610,7,101
-cut_skill_bar=0,0,1280,653
+cut_skill_bar=0,0,1284,653
 reduce_to_center=120,60,1040,540
-search_npcs=120,0,1040,620
-merc_icon=0,0,100,100
+search_npcs=120,0,1042,620
+merc_icon=10,9,56,56
 loading_left_black=0,0,350,720
 death=444,198,397,71
 tp_search=353,120,547,400
 repair_btn=318,473,90,80
-left_inventory=35,92,378,378
-right_inventory=866,348,379,152
+left_inventory=33,84,382,382
+right_inventory=868,348,379,152
+transmute_third_slot=242,342,38,38
 skill_right=664,673,41,41
 skill_right_expanded=655,375,385,255
 skill_left=574,673,41,41
@@ -118,21 +120,30 @@ stash_btn_roi=20,52,412,53
 enemy_info=440,15,405,150
 shrine_check=500,50,350,100
 character_select=1033, 44, 226, 554
-character_online_status=1033, 19, 226, 25
+character_online_status=1030, 18, 240, 40
 ; character_sub_roi is with respect to matched active character template
-character_name_sub_roi=6, 22, 186, 18
+character_name_sub_roi=2, 20, 194, 22
 cube_area_roi=167,209,113,152
 cube_btn_roi=160,368,125,57
 xp_bar_text=369,630,554,34
 corpse=459,195,414,213
 chat_icon=7,555,43,41
-left_panel_header=0,0,450,54
-right_panel_header=830,0,450,54
-npc_dialogue=458,4,21,140
+left_panel_header=0,0,455,56
+right_panel_header=830,0,455,56
+; A CENTRED panel (Chronicle, and anything else that opens mid-screen) puts its
+; close button outside both header ROIs above — the Chronicle's X sits at
+; (952, 56), inside right_panel_header's x-range but exactly at its 56px height
+; boundary, so the match centre falls out. Nothing then closes it, and a
+; centred panel blanks every later template search: measured as a 66s
+; click_red_portal failure on 2026-08-28 (Bug 31's residual).
+center_panel_header=400,0,620,92
+npc_dialogue=456,0,30,150
 bind_skill=516,619,251,29
 quest_skill_btn=284,455,710,121
-left_inventory_tabs=31,62,385,28
-tab_indicator=31,82,385,14
+left_inventory_tabs=29,60,389,30
+tab_indicator=31,71,385,14
+stash_page_select_left=155,475,20,20
+stash_page_select_right=270,475,20,20
 deposit_btn=454,365,186,43
 equipped_inventory_area=861,59,387,287
 inventory_bg_pattern=21,622,1236,75
@@ -141,7 +152,7 @@ inventory_bg_pattern=21,622,1236,75
 ; static pathes in format: x0,y0, x1,y1, x2,y2, ...
 pindle_safe_dist=921,35, 1123,70, 960,88
 eldritch_safe_dist=652,63, 563,73
-trav_safe_dist=1156,438, 1120,282, 1059,525, 1146,312, 1132,346, 985,538, 1125,333
+trav_safe_dist=1156,438, 1120,282, 1059,525, 1146,312, 1132,346, 1100,538
 pindle_end=1037,174
 eldritch_end=675,210
 shenk_end=1067,544
@@ -244,3 +255,19 @@ dia_c2g_home_loop=175,175
 dia_a_layout_bold=189,193, 189,193, 189,193, 189,193, 189,193, 189,193, 189,193, 189,193, 1100,337
 dia_b_layout_bold=1129,148, 1129,148, 1129,148, 1129,148, 1129,148, 1129,148
 dia_c_layout_bold=1112,503, 1112,503, 1112,503, 1112,503, 1112,503, 1112,503, 1112,503, 1112,503
+; Andariel (A1 Catacombs) - placeholder, fill in real coords later
+a1_andy_level3_enter=0,0
+a1_andy_level4_enter=0,0
+a1_andy_safe_dist=0,0
+; Countess (A1 Forgotten Tower) - placeholder, fill in real coords later
+a1_tower_level2_enter=0,0
+a1_tower_level3_enter=0,0
+a1_tower_level4_enter=0,0
+a1_tower_level5_enter=0,0
+a1_countess_safe_dist=0,0
+; Mephisto (A3 Durance of Hate) - placeholder, fill in real coords later
+a3_meph_level3_enter=0,0
+a3_meph_safe_dist=0,0
+; Baal (A5 Throne of Destruction) - placeholder, fill in real coords later
+a5_baal_throne_entry=0,0
+a5_baal_safe_dist=0,0

config/params.ini

@@ -1,61 +1,340 @@
 ; There is detailed documentation for each parameter in the README.md
 [general]
+; Personal values can reference env keys from repo-root .env:
+; Example syntax:
+;   custom_message_hook=${BOTTY_CUSTOM_MESSAGE_HOOK}
+;   custom_loot_message_hook=${ENV:BOTTY_CUSTOM_LOOT_MESSAGE_HOOK}
+;   bnet_name=${BOTTY_BNET_NAME}
+;   bnet_pass=${BOTTY_BNET_PASS}
+;   char_name=${BOTTY_CHAR_NAME}
+; difficulty: game difficulty to create ("normal", "nightmare", "hell")
+;
+; Hammerdin difficulty guide (CTA build with Conviction aura):
+;   NORMAL     - Very easy. 1-2h Hammer kills most packs. No CTA needed.
+;   NIGHTMARE  - Recommended starting point. Bosses hit ~100-200 dmg.
+;                CTA + Conviction drops resists. Need decent armor (ED/HR).
+;                Gear targets: ~200 AR, ~15 ED, ~30% HR, ~50% FCR on hammer.
+;   HELL       - Bosses hit 400-800+ dmg per swing. Conviction is mandatory.
+;                Gear targets: ~350+ AR, ~20+ ED, ~50%+ HR, ~60%+ FCR,
+;                ~150% IAS on weapon. Full Rejuv belt recommended.
+;                If you chicken/die repeatedly, drop to Nightmare first.
 difficulty=hell
-name=Botty
+; name: bot profile name used in logs/messages and mod launch option replacement
+name=profile1
+; randomize_runs: 0 = run in listed order, 1 = shuffle run order
 randomize_runs=0
+; target_tz: target Terror Zone id (leave as default unless you know the mapping)
+target_tz=1
+; saved_games_folder: optional override path to D2R Saved Games folder (blank = auto)
 saved_games_folder=
+; level_max_steps: max pathing steps for leveling-style routines
+level_max_steps=20
+
+; Set to 1 to enable auto-login and auto-launch of D2R on startup.
+; Credentials below are ONLY used when auto_login=1.
+auto_login=0
+bnet_name=${BOTTY_BNET_NAME}
+bnet_pass=${BOTTY_BNET_PASS}
+
+; Character name to auto-select from the character selection screen
+; If empty, bot relies on the saved character template from previous sessions
+char_name=${BOTTY_CHAR_NAME}
 
 ; messaging
-custom_loot_message_hook=
-custom_message_hook=
+; custom_loot_message_hook: optional separate webhook for loot notifications
+custom_loot_message_hook=${BOTTY_CUSTOM_LOOT_MESSAGE_HOOK}
+; custom_message_hook: main webhook for status/death/chicken messages
+custom_message_hook=${BOTTY_CUSTOM_MESSAGE_HOOK}
+; discord_log_chicken: 1 = send chicken/death style notifications
 discord_log_chicken=1
+; discord_log_errors: 1 = send a Discord message + error screenshot every time a
+; run fails (approach/battle/exception). Set to 0 to keep error screenshots on
+; disk only. Can also be toggled via [discord_events] error=0.
+discord_log_errors=1
+; discord_status_runs: send periodic status every X completed runs (blank/0 disables)
+discord_status_runs=10
+; discord_status_count: legacy fallback, send periodic status every X games (blank/0 disables)
 discord_status_count=20
+; discord_timing_report_h: post a timing + failure digest to Discord every N hours
+; (0 disables). Aggregated from the same TL> timeline the log uses, so the report and the
+; log can never disagree. The window resets on every send.
+discord_timing_report_h=2
+; pickup_drought_window: warn/alert after this many consecutive games with zero
+; item pickups. Raise this if you run a strict pickit and 0-pickup streaks are
+; expected/normal for you (a fast boss-only rush route with a tight filter can
+; easily go 10 games without a keep-worthy drop).
+pickup_drought_window=10
+; message_api_type: "" disables messaging, "discord" or "generic_api"
 message_api_type=discord
 
 ; breaks
-break_length_m=0
-max_runtime_before_break_m=0
+; break_length_m: scheduled break duration in minutes (0 = disabled)
+break_length_m=15
+; max_runtime_before_break_m: runtime before taking scheduled break (0 = disabled)
+max_runtime_before_break_m=120
 
 ; timers / fail handling
+; d2r_path: Diablo II: Resurrected install path
 d2r_path=C:\Program Files (x86)\Diablo II Resurrected
+; max_consecutive_fails: stop bot after this many failed runs in a row
 max_consecutive_fails=5
-max_game_length_s=380
-; if you set this field to 1, botty will attempt to restart d2 after a crash or failure
-restart_d2r_when_stuck=0
+; max_game_length_s: emergency timeout per run/game
+; 900: a full Chaos Sanctuary clear (3 seals + bosses + loot) takes ~10 min;
+; 600 force-quit a game while literally waiting for Diablo to spawn (2026-06-10).
+; Genuinely stuck games are caught much earlier by max_maintenance_time_s and
+; approach step timeouts.
+max_game_length_s=900
+; max_maintenance_time_s: if the town maintenance loop (heal/buy/stash/repair) takes
+; longer than this many seconds, save-and-exit and rejoin a fresh game.
+; Prevents the bot staying stuck in A5 town forever when NPCs or pathing fail.
+max_maintenance_time_s=420
+; auto_downgrade_threshold: if combined chickens+deaths exceed this number within 1 hour,
+; bot automatically lowers difficulty by one tier (hell->nightmare->normal) and restarts.
+; Set to 0 to disable. (NOTE: feature is parsed but not yet active in bot logic)
+auto_downgrade_threshold=0
+
+restart_d2r_when_stuck=1
+; hardcore: 1 enables hardcore-safe assumptions in some routines
+hardcore=0
 
 ; screenshots
+; info_screenshots: save screenshots for info/chicken/death events
 info_screenshots=1
+; error_screenshots: save a screenshot to log/screenshots/error/ every time a run
+; fails (approach failure, battle failure, or an exception) so logs and visuals can
+; be reviewed side by side. Falls back to info_screenshots if unset.
+error_screenshots=1
+; loot_screenshots: save screenshots for picked loot
 loot_screenshots=0
-pickit_screenshots=0
+; pickit_screenshots: save screenshots for pickit debugging
+pickit_screenshots=1
+
+; recovery
+; disable_run_after_failures: after this many CONSECUTIVE failures of the same run
+; (e.g. run_vizier), the bot disables just that run for the rest of the session and
+; keeps doing the other runs instead of stopping. A single success resets the count.
+; If every run gets disabled the bot stops for investigation. Set high to effectively
+; disable this behaviour.
+disable_run_after_failures=5
+; stash_scan_interval: scan all stash tabs and export stash_list.csv every X runs (0 disables)
+stash_scan_interval=0
+
+[discord_events]
+; Fine-grained Discord event toggles (1=send, 0=disable)
+; status: periodic status + generic bot messages (breaks, shop notifications, etc.)
+status=1
+; item_keep: send kept item notifications (loot webhooks/embeds)
+item_keep=1
+; death: send death notifications
+death=1
+; chicken: send chicken (emergency leave) notifications
+chicken=1
+; stash_full: send stash full notifications
+stash_full=1
+; gold_full: send gold full notifications
+gold_full=1
+; error: send run-failure notifications (message + error screenshot)
+error=1
+
+[stealth]
+; Multiplies all wait() calls by a random value in this range each call
+; 1.0 = no change. Set range wider for more human-like timing variation.
+; wait_jitter_* multiplies EVERY wait() in the codebase, not just mouse moves.
+; The floor is clamped to jitter_min*0.8, so 0.85 allowed waits to come out 32%
+; SHORT — the one place jitter stole time from an action instead of adding it
+; between actions. 0.95 keeps waits at-or-longer (effective floor 0.76 vs the
+; old 0.68, and the Gaussian centre sits above 1.0), so a wait can no longer
+; expire before the UI it was waiting on has settled.
+wait_jitter_min = 0.95
+wait_jitter_max = 1.20
+
+; Extra pixel variance added to every mouse click (on top of existing randomize=5)
+; 0 = off, 10 = +/-10px extra random offset per click
+; NOTE: click position randomization lives at the CALL SITES (npc_manager,
+; ui/waypoint) where it is tuned to real button geometry — 2-3px for NPC
+; hover targets, +/-9px inside a 47px waypoint button. There is deliberately
+; no global click-offset knob: stacking one on top of those is what starts
+; missing NPCs (see CLAUDE.md Bugs 3/4/6/7).
+
+; Re-shuffle run order after completing a full rotation (vs only at session start)
+; 0: keep [pindle, diablo] fixed so every game ENDS in A4 town (Diablo run TPs
+; there) — the next game then spawns at A4 where Jamella/Cain/Tyrael work,
+; avoiding the A5 Malah vendor entirely (stale templates in current patch).
+reshuffle_each_rotation = 0
+
+; Probability (0-100) of randomly skipping a run each game
+; 0 = never skip, 20 = skip ~1 in 5 runs
+skip_run_chance = 10
+
+; Probability (0-100) of taking an unscheduled AFK break after any given run
+afk_break_chance = 5
+; Break duration range in minutes
+afk_break_min_m = 2
+; 12 -> 7 (2026-08-28). The configured value is NOT the real ceiling:
+; maybe_afk_break does wait(minutes*60, minutes*60*1.5) and wait() then applies
+; its own jitter (up to 1.44x), so a "12 minute" break can idle for ~26 minutes.
+; Measured: an 11.9m break ran 1167.7s = 19.5m, and a 20:56 scheduled break ran
+; 25.5m. A ~25m idle is what left D2R at character select once, unable to
+; re-enter, with the bot spawning a new process every ~20s.
+; 7 caps the real-world worst case near 15m, inside the range proven to resume.
+afk_break_max_m = 7
+
+; Vary run/battle duration by a Gaussian factor (default +/-15%)
+; 0.0 = no variation, 0.3 = up to +/-30% variation
+run_duration_variance = 0.15
+
+; Micro-pause between actions (simulates human hesitation in milliseconds)
+micro_pause_min_ms = 20
+micro_pause_max_ms = 120
+
+; Vary kill time to avoid perfectly consistent boss fight durations
+; Varies boss attack duration. Only ever LENGTHENS the fight (1.0-1.4x) —
+; shortening it risks leaving a boss alive, which is a failed run, not stealth.
+vary_kill_time = 1
+
+; Human mouse curve complexity (1.0 = default, 0.5 = more direct, 1.5 = more winding)
+human_curve_complexity = 1.0
+
+; Arrival-to-click delay: human-like pause between mouse arriving and clicking (milliseconds)
+; 50-800ms range simulates "is this the right thing?" hesitation
+; Hesitation between arriving at a target and clicking it. OFF by default:
+; it applies to EVERY click, so the old 800ms ceiling could add minutes per
+; run. Enable with click_delay_enabled=1 if you want it; 250 is a realistic
+; ceiling that stays affordable.
+click_delay_enabled = 0
+click_delay_min_ms = 50
+click_delay_max_ms = 250
+
+; Key press duration variance: how long a key is held (milliseconds)
+; Most presses are short (20-100ms), some linger (up to 200ms)
+key_press_min_ms = 20
+key_press_max_ms = 200
+
+; Skill rotation hesitation: pause before casting a skill (milliseconds)
+; Prevents machine-speed skill spam
+skill_hesitation_min_ms = 80
+skill_hesitation_max_ms = 300
+
+; Wrong waypoint chance: 2-3% of selecting wrong TP portal then correcting
+; Humans occasionally misclick waypoint targets
+; ── session rhythm ───────────────────────────────────────────────────────────
+; The strongest remaining signal is not per-click timing: averaged over a
+; session jitter converges, but a player who starts at the same hour, plays the
+; same length and never does anything unproductive does not.
+;
+; session_budget_h: stop the bot after roughly this many hours (0 = unlimited).
+; Actual length is rolled per run at 0.65-1.35x, so consecutive days differ.
+; Raised to 10 for an overnight run: the budget is rolled at 0.65-1.35x, so 6
+; could have stopped the bot after 3.9h and left it idle. 10 guarantees at
+; least ~6.5h while keeping the day-to-day variation.
+; Set to 8 for a >= 5h run (2026-08-28). The value is rolled at 0.65-1.35x, so
+; session_budget_h=5 would average 5h but could stop after 3.25h. 8 gives a
+; 5.2-10.8h window, guaranteeing the 5 hours while keeping day-to-day variation.
+session_budget_h = 8
+; daily_budget_h: HARD cap on total runtime per CALENDAR DAY (0 = unlimited).
+; session_budget_h above is per PROCESS — a restart re-rolls it, so a bot that
+; gets restarted (by you, or by the restart-on-crash path) can run all day and
+; never trip it. This cap is persisted to log/.daily_runtime.json keyed on the
+; date, so restarts cannot extend the day. The target is rolled ONCE per day
+; (+/- daily_budget_jitter) and then FIXED, so restarting cannot re-roll a
+; larger allowance. This is a CEILING, not an average: the jitter only ever
+; subtracts, so daily_budget_h = 8 with 0.12 jitter runs 7.0-8.0h and NEVER
+; more than 8. session_budget_h above can still stop a single process sooner.
+daily_budget_h = 8
+daily_budget_jitter = 0.12
+; daily_budget_close_game: 1 = also close D2R when the daily cap trips (default).
+; The cap fires in on_end_game, AFTER save-and-exit, so nothing is in progress and
+; nothing is lost. A bot parked at character select for 16h is itself a pattern;
+; a real player quits the game. Set 0 to leave D2R running.
+; Small cursor movement during long idles. Between actions the cursor otherwise
+; sits exactly where the last click left it.
+idle_drift_enabled = 1
+; Per-game chicken threshold spread. Only ever RAISES the threshold (safer) —
+; a fixed 0.40 every game is a precise tell, but lowering it would cost deaths.
+chicken_variance = 0.08
+; Chance of an unproductive town action (open inventory, close it).
+town_browse_chance = 0.06
+; Chance of walking past an item the filter wanted. Costs real loot — keep low.
+pickup_skip_chance = 0.02
+wrong_waypoint_chance = 0.025
+
+; Skill mistake chance: 1-2% chance of miscasting and correcting
+; Simulates human error during combat
+; Presses a DIFFERENT bound skill before the intended one. Disabled: on a
+; character mid-fight this swaps the active skill or aura, and the attack
+; sequences rely on ending in a known skill state. The stealth value is small
+; next to the risk of a stray keypress landing on something that is not a skill
+; at all — which is exactly how the loot filter ended up being toggled all
+; session (params.ini [paladin] vigor=f4, unbound on this char, F4 = filter).
+; Set back to 0.015 to re-enable.
+skill_mistake_chance = 0
 
 [routes]
-; Add these possible routes to "order" to run them:
-; run_trav
-; run_pindle
-; run_eldritch
-; run_eldritch_shenk
-; run_nihlathak
-; run_arcane
-; run_diablo
-order=run_pindle, run_eldritch_shenk
+; Controls which farm runs Botty performs each game.
+; "order" is a comma-delimited list and runs left-to-right when randomize_runs=0.
+; If randomize_runs=1 (in [general]), Botty shuffles enabled runs each game.
+;
+; Hammerdin keyrun recommendation (stable-first):
+; order=run_countess, run_arcane, run_nihlathak
+;
+; Route quick notes:
+; run_trav           (Act 3 Travincal council farm; short/high-density run)
+; run_pindle         (Act 5 Nihlathak temple red portal boss farm)
+; run_eldritch       (Act 5 Frigid Highlands Eldritch-only run)
+; run_eldritch_shenk (Act 5 Eldritch then Shenk in same game)
+; run_nihlathak      (Act 5 Halls of Vaught, teleport strongly recommended)
+; run_arcane         (Act 2 Arcane Sanctuary / Summoner, teleport strongly recommended)
+; run_diablo         (Act 4 Chaos Sanctuary, teleport recommended)
+; run_vizier         (Act 4 Chaos Vizier-only route; lighter/faster than full Diablo run)
+; run_andariel       (Act 1 Catacombs)
+; run_countess       (Act 1 Forgotten Tower)
+; run_mephisto       (Act 3 Durance of Hate)
+; run_baal           (Act 5 Throne of Destruction)
+; run_baal_xp        (Join public Baal games, hide, collect XP, leave — see [baal_xp])
+order=run_baal_xp, run_trav
 
 [char]
 ; ==========================
 ; ==== Mandatory Fields ====
 ; ==========================
 ; These configs have to be alligned with your d2r settings and char build
-type=light_sorc
+; type: character build profile to use (must match one section below)
+; examples: blizz_sorc, hammerdin, fohdin
+type=hammerdin
+; belt_rows: in-game belt size (2/3/4)
 belt_rows=4
-casting_frames=10
-cta_available=0
+; casting_frames: your char cast breakpoint (affects action timing)
+casting_frames=11
+; cta_casting_frames: cast breakpoint on CTA swap (if used)
+cta_casting_frames=11
+; attack_frames: base attack animation timing for non-cast attacks
+attack_frames=15
+; cta_available: 1 if Call to Arms swap exists, else 0
+cta_available=1
+;Do we want to cast non-cta buffs (ex energy shield) with cta
+buff_with_cta=1
+
 ; safer_routines: enable for optional defensive maneuvers/etc during combat/runs at the cost of increased runtime (ex. hardcore players)
-safer_routines=0
+safer_routines=1
 
 ; num_loot_columns: Number of empty columns from left to right of inventory to be used for looting.
 ; Store charms, etc. to the right of the inventory.
+;
+; This drives ui_roi[restricted_inventory_area] in config.py: the columns to the RIGHT of
+; this count are protected — mouse._is_clicking_safe() cancels any click landing there, so
+; the bot never sells, drops or moves anything in them. Both tomes MUST live in that
+; reserved area: common.tome_state() only searches restricted_inventory_area for them.
+;   3 columns = 12 loot slots, 28 reserved
+;   4 columns = 16 loot slots, 24 reserved   <- now
+;   6 columns = 24 loot slots, 16 reserved   (tried 2026-08-27, reverted — shrinking the
+;                                             reserve is the wrong direction when the
+;                                             books and the charms both live there)
+; Lower this if the tomes or charms are running out of room; raise it only if the reserved
+; area is provably empty.
 num_loot_columns=5
 
 ; game hotkeys:
+; NOTE: each key must match your in-game binding exactly
 force_move=e
 inventory_screen=i
 potion1=1
@@ -68,12 +347,13 @@ show_items=alt
 ; stand_still cannot be the default "shift" as it would interfere with merc healing
 stand_still=capslock
 ; teleport: leave empty if you can't use
-teleport=
-town_portal=f9
+teleport=f4
+town_portal=f8
 ; call to arms settings:
-weapon_switch=x
-battle_orders=f7
-battle_command=f8
+; weapon_switch/battle_orders/battle_command only used when cta_available=1
+weapon_switch=w
+battle_orders=f6
+battle_command=f5
 
 ; ==========================
 ; ==== Optional configs ====
@@ -82,69 +362,171 @@ stash_gold=1
 use_merc=1
 
 ; Attack length for barbarians should be as high as 8-10 and even 10-12 for trav/shenk
+;
+; Hammerdin attack lengths (seconds of hammer spam per boss):
+;   atk_len_trav        = 4.0  (Council of 3 - 3 council members, easy)
+;   atk_len_pindle      = 8.0  (Pindle — Hell: 13094-16070 HP, 75% fire, 100% poison)
+;     Pindle stats by difficulty:
+;       Normal:    1064-1588 HP, 75% fire, 70% poison
+;       Nightmare: 4773-5859 HP, 100% poison
+;       Hell:      13094-16070 HP, 75% fire, 50% cold, 33% light, 100% poison
+;     With Conviction (-33% res), Hell Pindle = 50% fire, 17% cold, 0% light, 67% poison
+;     CTA adds +100% dmg to hammer. Need ~60%+ FCR and good IAS to kill in 8s.
+;   atk_len_nihlathak   = 4.0  (Nihlathak - single boss)
+;   atk_len_eldritch    = 3.0  (Eldritch only - single boss)
+;   atk_len_shenk       = 4.0  (Shenk only - single boss)
+;   atk_len_arc         = 2.5  (Summoner in Arcane - single boss)
+;   atk_len_diablo      = 10.0 (Diablo in CS - longest single boss)
+;   atk_len_countess    = 3.0  (Countess - single boss, easy)
+;   atk_len_andariel    = 4.0  (Andariel - single boss)
+;   atk_len_mephisto    = 12.0 (Mephisto - single boss, high HP)
+;   atk_len_baal        = 10.0 (Baal - single boss)
+;   atk_len_baal_waves  = 30.0 (Baal's spawn waves before boss)
+;
+; Chaos Sanctuary (Diablo run) individual fights:
+;   atk_len_cs_trashmobs   = 2.0  (Trash packs in CS)
+;   atk_len_diablo_vizier  = 2.0  (Vizier of Chaos - seal boss A)
+;   atk_len_diablo_infector = 4.0 (Infector of Souls - seal boss C)
+;   atk_len_diablo_deseis  = 5.0  (Lord De Seis - seal boss B, hardest seal)
+;
+; Increase these if your hammer kills slower (low IAS/FCR).
+; Decrease if your hammer kills faster (high IAS/FCR, good gear).
+; If you die during a fight, the attack length is too long for your defense.
 atk_len_arc=2.5
 atk_len_eldritch=3.0
 atk_len_nihlathak=4.0
-atk_len_pindle=3.0
+atk_len_pindle=8.0
 atk_len_shenk=4.0
-atk_len_trav=3.0
+atk_len_diablo=3.0
+atk_len_trav=5.0
+
+; Boss run attack lengths (per-character defaults in kill_* methods)
+; Adjust these if your build is faster/slower against these bosses
+atk_len_andariel=4.0
+atk_len_countess=3.0
+atk_len_mephisto=12.0
+atk_len_baal=10.0
+atk_len_baal_waves=30.0
 
 ; Chaos Sanctuary settings
-atk_len_cs_trashmobs=1.5
+atk_len_cs_trashmobs=2.0
 atk_len_diablo_deseis=5.0
 atk_len_diablo_infector=4.0
 atk_len_diablo_vizier=2.0
-atk_len_diablo=3.0
-cs_mob_detect=1
+cs_mob_detect=0
 ; cs_town_visits is currently broken, ignore for now
 cs_town_visits=0
-kill_cs_trash=0
+kill_cs_trash=1
 
 ; Belt settings
-belt_hp_columns=1
+belt_hp_columns=2
 belt_mp_columns=1
-belt_rejuv_columns=2
+belt_rejuv_columns=1
 
 ; Potion/chicken settings
-take_health_potion=0.8
-take_mana_potion=0.5
-take_rejuv_potion_health=0.4
-take_rejuv_potion_mana=0.1
-heal_merc=0.7
-heal_rejuv_merc=0.2
-chicken=0.35
-merc_chicken=0
+take_health_potion=0.60
+take_mana_potion=0.40
+take_rejuv_potion_health=0.45
+take_rejuv_potion_mana=0.10
+heal_merc=0.70
+heal_rejuv_merc=0.45
+chicken=0.40
+merc_chicken=0.20
 
 ; Misc.
 ; helps reduce accidental pickups when enabled especially on walking characters
-enable_no_pickup=1
+enable_no_pickup=0
+; fill_shared_stash_first: 1 = prefer shared stash tabs before personal stash
 fill_shared_stash_first=0
 ; to gamble, add any/all of the following: circlet, ring, coronet, talon, amulet
 gamble_items=
-id_items=1
-open_chests=1
+; open_chests: 1 = open clickable chests along path when possible
+open_chests=0
+; pre_buff_every_run: 1 = always recast buffs at run start
 pre_buff_every_run=1
-runs_per_repair=0
-runs_per_stash=4
+; runs_per_repair: visit repair vendor every X runs (blank/0 disables)
+runs_per_repair=50
+; repair_npc: preferred repair vendor strategy.
+; - a5_larzuk (recommended: stays in A5, no cross-act trip; falls back to Halbu)
+; - a4_halbu (requires WP trip to A4 every repair — act desync risk if it fails)
+; 2026-06-10: switched to a5_larzuk — session logs showed Halbu detection failing
+; 100% (body score ~0.39) and each failed A4 trip desynced the bot's act state.
+repair_npc=a5_larzuk
+; resurrect_npc: which NPC revives the mercenary. Blank = whichever act the character is
+; already in. Set to a4_tyrael to always use Act 4 Tyrael.
+; Measured 2026-08-27 on this setup:
+;   A4 Tyrael     ok 8.2s, ok 24.9s   -  0 errors, ever
+;   A5 Qual-Kehk  fail 113.6s / 52.0s / 163.1s / 72.6s  -  43 errors
+; Tyrael stands on a fixed spot by the A4 waypoint; Qual-Kehk is the least reliable NPC in
+; the route. A failed hunt costs more than the whole A5->A4 trip, and one 163s hunt pushed
+; the town visit past max_maintenance_time_s and killed the game.
+resurrect_npc=a4_tyrael
+; runs_per_stash: stash/sell every X runs (blank/0 disables)
+runs_per_stash=1
+; sell_junk: 1 = vendor non-keep items automatically
 sell_junk=0
+; protect_shields_from_sell: 1 = never vendor items with "shield" in detected name.
+; DISABLED 2026-08-27. This is redundant: the EQUIPPED shield is already protected
+; positionally by mouse._is_clicking_safe(), which cancels any click landing in
+; ui_roi[equipped_inventory_area] while the inventory is open. The name rule only ever
+; hit shields sitting in the INVENTORY grid, which the pickit had already judged.
+; Cost of leaving it on: 130 blocked sells in one day (FIEND SHIELD 64, AERIN SHIELD 41,
+; HERALDIC SHIELD 23...). The same shields were re-evaluated and re-blocked every single
+; game — "Discarding FIEND SHIELD." then "Blocked sell for protected item: FIEND SHIELD" —
+; so they could never leave the pack and permanently occupied slots.
+protect_shields_from_sell=0
+; protect_charms_from_sell: 1 = never drop/vendor charms regardless of pickit verdict
+; (safety net — a misread charm can't be un-sold). Set to 0 to let your pickit rules
+; decide keep/discard for charms same as any other item.
+;
+; KEEP THIS AT 1. Charms only give their bonus while they sit in the INVENTORY, and the
+; resistances matter in nightmare. Briefly set to 0 on 2026-08-27 to reclaim slots and
+; that was wrong — it vendored LARGE CHARM OF FIRE, STOUT SMALL CHARM, SMALL CHARM OF
+; FLAME, STOUT SMALL CHARM OF STRENGTH and LAPIS SMALL CHARM OF VITA (+20 life,
+; cold resist +7%) before it was reverted.
+;
+; The "673 blocked sells" in the log are NOT a bug to fix by selling — they are the guard
+; doing its job, repeatedly, on charms the pickit does not have a keep rule for. If those
+; slots are needed, the answer is a pickit rule that keeps the good charms and stops
+; picking up junk ones, NOT disabling this guard.
+protect_charms_from_sell=0
+; pick_rares_for_gold: 1 = pick all yellow (rare) ground items; non-keep rares will be sold
+; Requires sell_junk=1 to convert extra pickups into gold.
+pick_rares_for_gold=0
+; pick_gold: 1 = pick up ground gold piles, 0 = ignore all ground gold
+pick_gold=1
 
 [transmute]
 ;stash tabs by priority where to put transmuted gems
-stash_destination=3,2,1,0
+stash_destination=0,1,2,3
 ; Add these possible gems to "transmute" to transmute them:
 ; chipped, flawed, standard, flawless
+; DISABLED 2026-08-26: gems are stashed to the GEMS tab and left alone, no cube/convert
+; runs. An empty value makes run_transmutes() bail at "No gem tiers configured", which
+; also holds for force=True (tools/gem_transmute.py), unlike transmute_every_x_game=0.
+; Re-enable by listing tiers again, e.g. transmute=flawless
 transmute=flawless
 ;how often we want to run transmute routine(e.g. every 100 games)
-transmute_every_x_game=20
+transmute_every_x_game=800
+; number of stash tabs — drives tab click geometry in inventory/common.tab_properties().
+; MUST match the tab bar on screen. This client shows 5: PERSONAL SHARED GEMS MATERIALS RUNES.
+; It was 6, which made tab_properties compute centres of 63/127/192/256/320/384 while the
+; real label centres are 68/144/220/295/370 — tabs 2, 3 and 4 clicked the gaps between tabs.
+stash_tabs=5
+; potion transmute settings
+; convert_rejuv: 1 = convert regular Rejuv Potions to Full Rejuv via cube (3 -> 1)
+convert_rejuv=0
+; min_rejuv_to_convert: minimum regular rejuv potions in inventory before starting conversion
+min_rejuv_to_convert=6
 
 ; ===========================
 ; ==== Builds: Sorceress ====
 ; ===========================
 [sorceress]
-energy_shield=
-frozen_armor=
-static_field=
-telekinesis=
+energy_shield=f4
+frozen_armor=f7
+static_field=f5
+telekinesis=f6
 thunder_storm=
 
 [light_sorc]
@@ -157,55 +539,97 @@ frozen_orb=
 
 [blizz_sorc]
 ; blizzard must be right skill, hotkey required
-blizzard=
+blizzard=f1
 ; ice_blast must be left skill (hotkey optional as it shouldnt change)
-ice_blast=
+ice_blast=f2
+
+[blizzorb_sorc]
+; frozen orb must be left skill and preselected (no hotkey required)
+
+;All others must be right skill and hotkey required!
+blizzard=f1
+glacial_spike=f7
 
 [nova_sorc]
 ; nova must be right skill, hotkey required
-nova=
+nova=f1
 
 [hydra_sorc]
 ; only supports Pindle and Eldritch currently
 ; alt_attack is any alternate attacking right skill. Fireball,Lightning,Frozen Orb, hotkey required
-alt_attack=
+alt_attack=f7
 ; hydra must be right skill, hotkey required
-hydra=
+hydra=f1
 
 ; =========================
 ; ==== Builds: Paladin ====
 ; =========================
 [paladin]
 cleansing=
-holy_shield=
-redemption=
-vigor=
+holy_shield=f4
+redemption=f2
+vigor=f3
 
 [fohdin]
 ; foh must be left skill, hotkey required
-blessed_hammer=
-concentration=
-conviction=
-foh=
-holy_bolt=
+blessed_hammer=f1
+concentration=f8
+conviction=f5
+foh=f6
+holy_bolt=f7
 
 [hammerdin]
-blessed_hammer=
-concentration=
+blessed_hammer=f9
+concentration=f1
+conviction=
 
+; =========================
+; ==== Builds: Warlock ====
+; =========================
+[warlock]
+; All skills should be on right-click unless otherwise specified
+deathmark=f3
+lethargy=f4
+;Set summon_demon to one of the three demons of your choice.
+summon_demon=f5
+;If you are summoning a 2nd demon set hotkey here. Can be same as above
+summon_demon2=
+psychic_ward=
+
+[fire_lock]
+; Supported runs: Pindle
+;flame_wave must be assigned to left-click and doesn't require hotkey
+ring_of_fire=f1
+apocalypse=f2
+
+[abyss_lock]
+; Supported runs: Pindle
+;miasma_bolt must be assigned to left-click and doesn't require hotkey
+miasma_chain=f1
+abyss=f2
+
+[echo_lock]
+; Supported runs: Trav (tele only)
+echo_strike=f1
+eldritch_blast=f2
+hex_bane=f3
+;Set ring of fire if you want to stun before echo blast
+ring_of_fire=
 
 ; ==========================
 ; ==== Builds: Assassin ====
 ; ==========================
 ; Currently no Trav implementaiton!
 [trapsin]
-burst_of_speed=
-death_sentry=
-fade=
-lightning_sentry=
-shadow_warrior=
+; We assume fire blast or shock web is left-click skill which is optional hotkey if pre-assigned.
 skill_left=
-
+; Assume all other skills are right-click and hotkey required!
+burst_of_speed=f1
+death_sentry=f2
+fade=
+lightning_sentry=f3
+shadow_warrior=f4
+mind_blast=f5
 
 ; ===========================
 ; ==== Builds: Barbarian ====
@@ -220,6 +644,21 @@ leap=
 shout=
 war_cry=
 
+; ===========================
+; ==== Builds: Amazon ====
+; ===========================
+; Supported runs: Trav, Pindle, Eld, Shenk, Nihlathak (tele only)
+; Make sure leap hotkey is set if you do not have Enigma
+; Ensure Battle Order/Command hotkeys are set above in the [char] section
+[amazon]
+;all must be right-click skill
+valkyrie=f1
+
+[javazon]
+; charged strike must be left-click skill and preselected, no hotkey required
+
+;all others must be right-click
+lightning_fury=f2
 
 ; ==========================
 ; ==== Builds: Necro ====
@@ -277,7 +716,7 @@ damage_scaling=1
 ; if the buffs are not set they are not used (they are part of the prebuff setup)
 
 [basic]
-left_attack=
+left_attack=1
 right_attack=
 buff_1=
 buff_2=
@@ -295,27 +734,127 @@ buff_1=
 buff_2=
 
 
+; ==== Run: Cold Plains clear ====
+; Roams an outdoor area and kills with ONE configured skill. Works with any build
+; and from clvl 1, so it is the levelling counterpart to the boss runs.
+; Enable by adding run_cold_plains to [routes] order above.
+;
+; PREREQUISITE: the character must already have the destination waypoint.
+; A fresh character has none - walk there once by hand first.
+[cold_plains]
+; Any Act 1 waypoint label from src/ui/waypoint.py _WAYPOINTS, e.g.
+; "Cold Plains", "Stony Field", "Dark Wood", "Black Marsh".
+area=Cold Plains
+; Key holding the attack skill. NOTE Fireball is clvl 12 - on a fresh character
+; put Fire Bolt (clvl 1) here and re-bind to Fireball later; nothing else changes.
+attack_hotkey=
+; Most sorc/caster skills cast on right click. Melee builds want "left".
+attack_button=right
+; How many roam-or-fight steps before heading back to town.
+max_steps=12
+; Casts per engagement before re-scanning for targets.
+casts_per_target=4
+; Ignore anything further than this many px from the character.
+target_radius=600
+; Delay between casts. Raise if you out-run your cast animation.
+cast_delay=0.25
+; Hard runtime cap per run, seconds - stops a bad area pinning the bot.
+max_runtime_s=180
+; Engagements per step, so an unkillable/misdetected target cannot stall the run.
+max_engagements=8
+
+[baal_xp]
+; Baal XP farm: join public Baal games, hide, collect XP, leave. Repeat.
+; Enable by adding run_baal_xp to [routes] order above.
+enabled=1
+; Substring to match against game names (case-insensitive). Empty = join first game.
+game_name_filter=
+; Max seconds to wait in a game before leaving (XP keeps ticking while you hide).
+max_wait_s=900
+; Leave early if XP gained in this game reaches this value.
+xp_threshold=50000000
+; Leave immediately if HP drops below this percentage (chicken).
+min_hp_pct=40
+; Screen position (client coords) to walk to and stand still while hiding.
+hide_x=640
+hide_y=360
+; Max seconds to wait for a matching game to appear in the browser.
+join_timeout_s=60
+
 [advanced_options]
 ; startup hotkeys
-restore_settings_from_backup_key=f7
-settings_backup_key=f8
-auto_settings_key=f9
-graphic_debugger_key=f10
+; select_runs_key: open run selector UI
+select_runs_key=pagedown
+; restore_settings_from_backup_key: restore backed-up D2R settings
+restore_settings_from_backup_key=insert
+; settings_backup_key: create backup of current D2R settings
+settings_backup_key=pause
+; auto_settings_key: auto-apply required D2R settings
+auto_settings_key=pageup
+; graphic_debugger_key: toggle on-screen debug layers
+graphic_debugger_key=delete
+; resume_key: start/pause bot loop
 resume_key=f11
+; exit_key: hard stop bot
 exit_key=f12
+; cycle_pickit_profile_key: cycle through pickit profiles in config/pickit_profiles/
+cycle_pickit_profile_key=f10
 
 ; etc.
+; graphic_debugger_layer_creator: 1 = enable interactive layer creator tooling
 graphic_debugger_layer_creator=0
+; hwnd_window_process: process regex used to locate D2R window handle
 hwnd_window_process=D2R\.exe
+; hwnd_window_title: optional title regex override for window lookup
 hwnd_window_title=
 ; launch_options: will replace <name> with setting for [general] "name" above
 launch_options=-mod <name> -txt
+; logg_lvl: logging verbosity (debug/info/warning/error)
 logg_lvl=debug
+; message_body_template: payload template for generic_api mode
 message_body_template={{"content": "{msg}"}}
+; message_headers: optional JSON headers for generic_api mode
 message_headers=
+; ocr_during_pickit: 1 = run OCR while looting (slower, more diagnostics)
 ocr_during_pickit=0
 ;use "can_teleport_natively" or "can_teleport_with_charges" if you want to force certain behavior in case autodetection isn't working properly
-override_capabilities=
-pathing_delay_factor=4
-;If you want to control Hyper-V window from host use 0,51 here
+override_capabilities=can_teleport_natively
+; pathing_delay_factor: movement/click delay multiplier (1 fast .. 10 slow)
+pathing_delay_factor=2
+; If you want to control Hyper-V window from host use 0,51 here
+; window_client_area_offset: x,y pixel offset for captured game client area
 window_client_area_offset=0,0
+
+[log_rotation]
+; Log rotation prevents screenshot directories from filling the disk.
+; Each managed directory has a max file count and max total size.
+; When limits are exceeded, oldest files are deleted automatically.
+; Checked every 60 seconds (to avoid I/O overhead during runs).
+;
+; The text log (log/log.txt) is size-capped separately: it rotates at 50 MB,
+; keeps 5 zipped backups in log/archive/ (max 30 archives). Override the per-file
+; cap with the BOTTY_LOG_MAX_MB environment variable (e.g. set 100 for 100 MB).
+
+; pickit directory (log/screenshots/pickit/):
+; Can grow very fast — every item scan writes a PNG + JSON.
+; pickit_max_files=500        ; max files before rotation kicks in
+; pickit_max_mb=500           ; max total size in MB
+pickit_max_files=300
+pickit_max_mb=200
+
+; info directory (log/screenshots/info/):
+; Debug screenshots for deaths, chickens, errors, etc.
+; info_max_files=200          ; max files before rotation kicks in
+; info_max_mb=500             ; max total size in MB
+info_max_files=100
+info_max_mb=200
+
+; items directory (log/screenshots/items/):
+; Loot screenshots sent to Discord.
+; items_max_files=100
+; items_max_mb=100
+items_max_files=50
+items_max_mb=50
+
+; discord_notify_rotation: 1 = send Discord message when log rotation deletes files
+discord_notify_rotation=0

config/pickit_profiles/README.md

@@ -0,0 +1,26 @@
+# Shared pickit profiles (git-tracked)
+
+One folder per pickit set, e.g. for season phases:
+
+```
+config/pickit_profiles/
+  season_start/   *.bnip   (leveling: keep bases, gems, chipped...)
+  mid_season/     *.bnip
+  endgame/        *.bnip   (GG-only filter)
+```
+
+Drop `.bnip` (or `.nip`) files in a folder; a `.nipignore` works like in
+`config/bnip`. These folders ARE committed — build them once, everyone
+gets them via git pull.
+
+## Selecting a set
+Per user, in your gitignored `config/profiles/<you>/profile.ini`:
+
+```ini
+[general]
+pickit_profile=season_start
+```
+
+Priority: `config/profiles/<you>/pickit/` (personal set, gitignored)
+> `config/pickit_profiles/<pickit_profile>/` (shared, from this folder)
+> `config/bnip/` > `config/default.bnip`.

config/shop.ini

@@ -1,4 +1,5 @@
 [claws]
+; shop_trap_claws: 1 = enable claw-shopping routine for trap claws from Anya/Drognan flow
 ; Current scoring for trap claws
 ; 3 traps: +12
 ; 2/1 traps: +8
@@ -6,18 +7,23 @@
 ; x light senetry: +6
 ; x weapon block: +1
 ; x death sentrey: +4
-shop_trap_claws=1
+shop_trap_claws=0
+; trap_min_score: minimum combined score required to keep a trap claw
 trap_min_score=13
 
+; shop_melee_claws: 1 = enable shopping melee claws (venom/block focused)
 ; Current scoring for melee claws
 ; 2 assa: +10
 ; x venom: +6
 ; x weapon block: +2
-shop_melee_claws=1
+shop_melee_claws=0
+; melee_min_score: minimum combined score required to keep a melee claw
 melee_min_score=13
 
 [gloves]
+; shop_3_skills_ias_gloves: 1 = shop +3 skill tree + IAS gloves
 shop_3_skills_ias_gloves=1
+; shop_2_skills_ias_gloves: 1 = shop +2 skill tree + IAS gloves
 shop_2_skills_ias_gloves=0
 
 ;
@@ -29,6 +35,9 @@ shop_2_skills_ias_gloves=0
 ; apply_pather_adjustment - alternative option that applies an adjustment to movements.
 ;                           Should not need this. Try it if you have trouble when it is off.
 [scepters]
+; shop_hammerdin_scepters: 1 = enable Hammerdin scepter shopping route
 shop_hammerdin_scepters=1
+; speed_factor: movement compensation for FRW and path timing during shopping loop
 speed_factor=0.25
-apply_pather_adjustment=0
+; apply_pather_adjustment: optional alternate node adjustment if default route misses NPC/shop spots
+apply_pather_adjustment=0