Ey Mr. Smith

[EN]
Mr. Smith is a server-side AI civilian that lives on his own: he travels between places, loots, sells and buys at traders, drinks at wells, heals, avoids danger and learns which actions work on which objects.

Features:
- Travel in legs; a running move order is never cancelled. Stuck = less than 5 m closer in 90 s: the destination is changed and blocked for a while. The unstuck routine (doors, back off, detour) runs only after 3 stucks in a row. Arrival at 40 m.
- Movement log per Smith: "[Move] Smith #N at X/Z: new destination / leg / arrived / stuck"
- Trading with sell pause and nearest-trader fallback
- Position and inventory kept across restarts (inventory.json, protected against empty saves, .bak copy). No position save in water; a saved water position is moved to the nearest land point (up to 200 m).
- Radio hints for players with a radio (hint, sound, chat line)
- Config upgrade keeps your values and adds new fields

Dependencies: none. Food/water values are read from FM-style items when present.

Config: $profile:MrSmith/config.json, created on first start and upgraded automatically (backup kept). New in 1.1.9: moveStuckSeconds, moveStuckMeters, moveUnstuckAfterStucks, moveFinalArriveRadius, traderFinalArriveRadius, waterCheckEnabled, waterRelocateRadius.

Known limitations:
- AI needs (water/energy) are Mr. Smith's own simulation.
- Radio is only a hint/sound for players with a vanilla radio; ACE radio not verified.
- Learning uses block lists; drop/scan/support/strike actions are never tried.
- Wells only up to 800 m.
- Travel depends on the game's AI pathing and maxTravelDistance x range factor; blocked places expire.
- Stuck detection measures distance to the destination; a long detour can count as stuck.
- Water check uses the engine water test at the feet; deep water without land within 200 m keeps the position.
- Respawn is done by the scenario/spawner, not by this mod.

[DE]
Mr. Smith ist ein serverseitiger KI-Zivilist mit eigenem Leben: reist zwischen Orten, pluendert, verkauft und kauft bei Haendlern, trinkt an Brunnen, heilt sich, meidet Gefahr und lernt, welche Aktionen an welchen Objekten funktionieren.

Funktionen:
- Reisen in Etappen; ein laufender Laufbefehl wird nie abgebrochen. Stuck = in 90 s keine 5 m naeher: Ziel wird gewechselt und zeitweise gesperrt. Die Unstuck-Routine (Tueren, zurueck, Umweg) laeuft erst nach 3 Stucks in Folge. Ankunft bei 40 m.
- Bewegungslog pro Smith: "[Move] Smith #N at X/Z: new destination / leg / arrived / stuck"
- Handel mit Verkaufspause und Fallback auf naechsten Haendler
- Standort und Inventar bleiben nach Neustart (inventory.json, gegen leere Saves geschuetzt, .bak-Kopie). Keine Positionsspeicherung im Wasser; eine Wasserposition wird beim Laden zum naechsten Landpunkt verschoben (bis 200 m).
- Funkhinweise fuer Spieler mit Funkgeraet (Hinweis, Sound, Chatzeile)
- Config-Upgrade behaelt deine Werte und ergaenzt neue Felder

Abhaengigkeiten: keine. Essens-/Wasserwerte werden aus FM-Items gelesen, falls vorhanden.

Config: $profile:MrSmith/config.json, beim ersten Start erzeugt und automatisch aktualisiert (Backup bleibt). Neue Felder siehe oben.

Bekannte Einschraenkungen:
- KI-Beduerfnisse sind eine eigene Simulation.
- Funk ist nur Hinweis/Sound fuer Spieler mit Vanilla-Funkgeraet; ACE-Funk ungeprueft.
- Lernen nutzt Sperrlisten; Drop-/Scan-/Support-/Strike-Aktionen werden nie probiert.
- Brunnen nur bis 800 m.
- Reisen haengt von der KI-Wegfindung und maxTravelDistance x Reichweitenfaktor ab; Sperren laufen ab.
- Stuck-Erkennung misst die Entfernung zum Ziel; ein langer Umweg kann als Stuck zaehlen.
- Wassercheck nutzt den Engine-Wassertest an den Fuessen; tiefes Wasser ohne Land im Umkreis von 200 m behaelt die Position.
- Respawn macht das Szenario/der Spawner, nicht diese Mod.