DVRouteManager

A Derail Valley mod that adds route management, automatic junction switching, cruise control, and autonomous AI driving via the Comms Radio.

---

Features

Route Planning & Navigation

• A* pathfinding over the full RailTrack graph — finds the shortest driveable path between any two tracks
• Automatic junction switching — all switches along the route are set as you pass each track segment
• Turntable routing — routes through turntables, auto-rotates them to the correct heading before you arrive
• Yard track avoidance — penalises occupied or reserved yard sidings so the AI prefers main-line paths
• Flip direction — reverse the active route in-place without re-planning from scratch
• Map markers — route is drawn on the in-game map

Cruise Control

• PID speed controller — smooth throttle/brake to hold a target speed
• DM3 automatic gear shifting — shifts up at >800 RPM, down at <600 RPM, with a hard 70 km/h cap
• Steam loco support (S060 / S282) — pressure-aware cutoff (0.5–0.75 forward based on steam chest pressure), pulse braking, smooth regulator/cutoff lerp

Autonomous AI Driver

• Drive to destination — set a destination via Comms Radio, AI drives there automatically (no job required)
• Freight haul automation — 4-phase automation: couple, load, drive, deliver
• Speed limit lookahead — reads curve geometry (BezierArcApproximation) to anticipate speed limits ahead
• Turntable awareness — AI stops and waits for a turntable to finish rotating before proceeding

Comms Radio UI

Full menu tree accessible from the in-game Comms Radio:

• New Route — pick destination, plan route
• Active Route — view info, flip direction, or clear
• Loco AI — start/stop autonomous driving
• Settings — adjust behaviour

---

Requirements

• Derail Valley (current build)
• Unity Mod Manager (UMM)
• CommsRadioAPI — place CommsRadioAPI.dll in Mods\CommsRadioAPI\

---

Installation

1. Install Unity Mod Manager and point it at your Derail Valley folder.
2. Install CommsRadioAPI via UMM or manually.
3. Copy the DVRouteManager folder (containing DVRouteManager.dll and info.json) into your Mods\ directory:

   Derail Valley\Mods\DVRouteManager\
   

4. Launch the game — the mod loads automatically via UMM.

---

Building from Source

Requirements: Visual Studio 2022 (or MSBuild), .NET Framework

1. Clone the repo.
2. Set reference paths to your DV install's DerailValley_Data\Managed\ folder and Mods\CommsRadioAPI\CommsRadioAPI.dll.
3. Build:

   MSBuild DVRouteManager\DVDRouteManager.csproj
   

   The DLL is output to bin\Debug\DVRouteManager.dll.
4. Copy the DLL to Mods\DVRouteManager\ in your DV install.

Note: The post-build copy step may report MSB3073 (SolutionName undefined) — this is harmless; the DLL is still built successfully.

---

How It Works

Component	Role
PathFinder.cs	A* search over RailTrack graph with turntable and yard-penalty support
Route.cs	Wraps the path list; manages junction/turntable switching and direction reversal
RouteTracker.cs	Tracks loco position along the active route; triggers switch updates as segments are passed
LocoAI.cs	Coroutine-based autonomous driver; handles speed limits, turntable waits, freight phases
LocoCruiseControl.cs	PID controller with DM3 gear logic and steam loco support
RouteManagerStates.cs	All Comms Radio UI states and menu tree

---

Known Issues / In Progress

• Audio cues — clips load and AudioSource is found, but cues do not play in-game
• Steam AI — compiled and logic complete; awaiting in-game verification
• Refuel routing — planned: auto-route to nearest water tower or fuel station

---

Credits

• RouteSetter by zelmer69 — reference for modern CommsRadioAPI usage
• Derail Valley by Altfuture