Install → Activate → Drive.
Everything you need to get the multi-drop dispatch overlay running for American Truck Simulator and Euro Truck Simulator 2.
This app reads live data from the game (read-only) and never changes your in-game funds or the real job you accepted. The one opt-in exception is the optional Website Account feature — covered below.
What ATS Dispatch Pro is
ATS Dispatch Pro is a small companion app that runs next to American Truck Simulator or Euro Truck Simulator 2 while you play. It watches your current job in real time and adds a multi-drop delivery system on top — extra stops along your route, a progress bar, and a trip summary when you finish.
For normal use it only reads data (position, speed, job info). It doesn't add money and doesn't change the real job you accepted. Think of it as a companion overlay, not a mod.
What you'll need
- American Truck Simulator or Euro Truck Simulator 2, installed and working on Windows.
- The installer: ATS Dispatch Pro Setup.exe
- A dromodding.com account with one of:
- Website subscribers — your key appears on My Downloads immediately, nothing extra to do.
- Patreon members — link your Patreon to your dromodding.com account once, at dromodding.com/link-patreon. Your key then appears on the same page.
Step 1 — Install the program
- Double-click ATS Dispatch Pro Setup.exe.
- Choose an install location (or accept the default) and finish the wizard.
- The installer creates a Start Menu entry and a Desktop shortcut, both named "ATS Dispatch Pro."
No Node.js, no terminal, nothing else to configure — launching is just double-clicking the shortcut.
Step 2 — Activate the program
The app requires a small, signed activation key file to run. Without it in the right place, it shows an error and quits immediately.
Getting a key
Go to dromodding.com, sign in, and open My Downloads. If you have an active supporter plan or linked Patreon pledge, click the button to download ats-dispatch-key.zip.
Placing the key
Place ats-dispatch-key.zip — keeping the exact filename — into either of these folders:
Documents\American Truck Simulator\mod\ats-dispatch-key.zip
Documents\Euro Truck Simulator 2\mod\ats-dispatch-key.zipOnce placed, launch the app. If everything is correct the window opens and shows "Waiting for game…".
Step 3 — Telemetry plugin + real stop locations
Highly recommended — this is what makes delivery stops work at all. Without it the app can't read a live game session and generates no delivery stops. It still tracks the underlying job (cargo, route, distance, trip history), there just aren't any multi-drop stops until this is done.
Open the app and click the Setup button in the header (red until this step is done, green once real map locations are active).
- Enter or browse to your game's install folder — the main folder that contains bin\win_x64. Not that subfolder, and not your whole Steam library.
- Click Install game plugins — installs the telemetry bridge that shares live data, plus the optional in-game HUD overlay, side by side in bin\win_x64\plugins.
- Click Enable Real Map Locations — runs a bundled extractor that pulls real company and road data straight from your installed game files. Nothing is downloaded.
Everything runs inside the app with live progress in a log box — no separate window, no restart. The first run takes a few minutes; after that the app remembers your setup and detects an already-configured game folder automatically. A failed plugin install doesn't stop map-data extraction (or vice versa) — just re-run whichever failed. Picking a slightly-wrong folder (like bin\win_x64 itself) is auto-corrected where possible.
The same Setup panel also holds Mod Cargo Support and the optional Website Account section. The window shortcut, Miles/Kilometers, language, voice cues, overlay transparency, and the Phone Companion live under Settings.
Using the app
Launch the game first, then launch ATS Dispatch Pro. The window sits on top of everything else (always-on-top overlay).
Accept a job in-game as normal — as soon as the app detects it, the job panel appears with your route, a progress bar, and a stop list.
Header buttons
The top row: Home (default job view), History, Settings, Setup, and a Refresh button (used with the optional Website Account). The row below holds the Drops and Pickups controls for the next job.
Status line
A short colored dot tells you what's happening: amber "Waiting for game…", green "Connected to game", blue "Job in progress", and red "Game closed" (auto-recovers when the game returns).
Show / hide the window
Press Alt+Shift+D at any time — even with the game focused — to toggle the overlay. Change the combo under Settings → Window Toggle Shortcut: click the field, press your new combo, click Save.
Drops & pickups
Drops: On/Off with a − / + stepper (1–10, default 3) sets the maximum number of extra drop stops — on a short route the app won't invent stops where no real company fits. Pickups: On/Off works the same way but adds extra real pickup stops earlier in the drive — off by default. All four controls only take effect on your next job and are greyed out while a job is running.
Miles or kilometers. Distances default to miles. Switch under Settings → Distance Unit → Kilometers. Changes instantly across the job panel, Trip History, saved receipts, and the phone companion.
Overlay transparency
Open Settings → Overlay Transparency and drag the slider to see the game through the app. It fades only the window's dark background — text, buttons, and the stop list stay fully crisp. The window is frameless: drag the logo row to move it, and use the small − / × buttons to minimize or close.
App language
The interface is available in English, German, French, and Spanish. Open Settings → Language and pick one — the whole window re-renders instantly with no restart, and your choice is remembered.
The two stop styles
- Planned real stops — the app works out an actual route to your destination city and picks real companies along it right after you load up, before you've left the lot.
- Discovered real stops — if planning doesn't pan out, real companies are found one at a time as you drive past and park near them.
Completing stops
Drive to a stop and park within range — the app detects this automatically and marks it complete with a notification and a green checkmark. No need to drop the trailer or do anything special.
Refresh & replace
Refresh stops re-plans every remaining stop from your current position — completed stops and your real final destination are never touched. Replace swaps just one stop for a different real alternative nearby. Both need a moment of live position data, so give it a few seconds after accepting a job.
Abandoning remaining stops
Abandon remaining stops clears everything that hasn't completed yet for the current job — your real final destination keeps tracking either way. Only affects the current job.
The final delivery stop
Your real destination always appears in the stop list ("Deliver to X — Final Stop"). It only completes when the game itself records the delivery — parking near the destination early won't check it off.
If the app or game closes mid-job
Nothing is lost. When telemetry reconnects to the same job, the app restores discovered/planned stops, which ones you'd completed, and the final delivery stop automatically. (Only works for jobs the app was already tracking before it closed.)
Trip history & receipts
Click History in the header for a list of completed jobs — route, cargo, distance, and stops found/completed — most recent first. Each trip has a Remove button, and Clear all at the top wipes the whole list (both confirm first).
When a job finishes, a Save trip receipt button appears on the trip-complete screen (and next to every past trip in History). It saves a shareable image summarizing that trip — including a checklist of every stop — to wherever you choose on your computer.
Mod cargo support (optional)
Dro Modding's own supported trailers work out of the box. To add another trailer mod, open Setup → Mod Cargo Support and click Add mod folder… or Add mod zip…, then point it at that mod's def folder or its whole .zip — no need to extract anything or hunt for a subfolder. Add multiple mods, rename their labels, or remove any of them later.
Body type mapping
Some trailer mods label their cargo with the mod's own internal name instead of a standard type real companies recognize. In the same panel, any of a mod's trailer-type labels that still need mapping show up in a dropdown — pick one, choose which real trailer type(s) it's equivalent to (flatbed, refrigerated, dropdeck, and so on), and click Add mapping. Each added mod also shows a small red/green badge so you can tell at a glance whether its body types are fully mapped yet.
Phone Companion
A view-only phone screen that mirrors the current job over your local WiFi. The link is a plain http:// address on purpose — a trusted certificate needs a real domain, which a local same-WiFi app doesn't have.
Website account (optional)
Link a dromodding.com account to unlock online features: a live driver profile that updates as you drive, save-file stats on your profile, and the ability to plan jobs on the website and haul them in-game. Everything above works without it.
Connecting
On the website, sign in and open your Settings page, then click Generate pairing code. In the app, open Setup → Website Account, paste the code, and click Connect. Your website password never touches the app — pairing exchanges a one-time code for a secure token. Click Disconnect in the same place to unlink this PC at any time.
What it shares
- Live job data — your truck, trailer, cargo, route, position, and progress update on your online profile as you drive.
- Live truck dashboard — a real-time gauge cluster on your profile: speed, RPM, gear, fuel, engine/water temps, wear and damage, lights, odometer, and more, updated every few seconds while you drive.
- Save-file stats — your XP, bank balance, owned trucks, and preferred trailer read from your latest save (refreshed periodically).
Accepting jobs created on the websiteBeta
Create a job on the website (real origin company/location, destination, and a cargo compatible with your trailer) and haul it in-game with your own trailer. When the app finds a pending website job — at startup, after connecting, or when you click Refresh in the header — a banner appears with an Accept job button.
Because of how the game handles owned-trailer jobs, there's no in-game "accept" screen — clicking Accept job writes the job into your latest save directly. The full flow:
- Create the job on the website.
- In the game, drive to the pickup company with your trailer attached and park in its lot.
- Save (or let autosave run), then fully quit the game.
- In the app, click Accept job.
- Relaunch the game and load your save — the cargo is on your trailer, right where you parked.
Delivering it
Drive the job like any other. When you arrive, your truck is placed at the destination company's real loading dock — the app works this out from the game's own map data, so you pull right up to the correct spot. Complete the delivery through the game's normal parking screen: pick any offered difficulty, or choose Skip Parking if a dock doesn't suit you (some smaller depots only offer Skip). It counts the same either way.
If a delivered job still shows as active online
Once in a while an accepted website job finishes in-game but stays marked active on your online profile (this can happen when you complete it with Skip Parking, which the game doesn't always report the same way as a normal delivery). If that happens, open the app while that job is loaded and click Mark delivered — it pushes the job to completed on your profile so your Current Job clears. If your website session has expired, it'll ask you to reconnect first (Settings → Website Account).
The in-game HUD overlay
Alongside the desktop window, ATS Dispatch Pro can draw a second, lightweight route panel inside the game itself — rendered as part of the game's own frame, so it works even in exclusive fullscreen where a normal window can't reliably appear. It shows your cargo, the active stop, a route progress bar and the stop list, live.
The HUD is optional: if it isn't installed, everything else in this guide works unchanged.
Installing it
It ships with the app and is installed by the same Setup step as the telemetry plugin: open Setup and click Install game plugins. Both plugins land side by side in bin\win_x64\plugins. With the app and the game both running, the HUD connects on its own within a second or so.
Reading the header dot
- Green — connected to the desktop app.
- Gray — connected, but no route to show yet.
- Yellow — reconnecting (the app closed or restarted).
- Red — the app isn't running, or the plugin and app versions don't match (re-run Install game plugins after updating).
Keyboard controls
The HUD is deliberately keyboard-only — the game owns the mouse completely, so every mouse movement and click goes straight to the game. Any key the HUD doesn't use passes through untouched.
| F8 | Show or hide the overlay |
| Shift+F8 | Overlay controls on/off (arrow keys drive the panel) |
| Ctrl+F8 | Cycle display mode: Minimal → Compact → Route → Expanded |
| Alt+F8 | Quick settings |
| Esc | Back out / leave overlay controls |
With overlay controls on (Shift+F8), arrows navigate, Enter selects, PgUp/PgDn scroll the stop list, Home jumps back to the current stop, Tab opens quick settings, and Esc backs out. All four hotkeys are rebindable.
The four display modes
- Minimal — just the next required action: stop type, company • city, distance, and your stop number. The panel sizes itself to the company name for the smallest possible footprint.
- Compact — the default. Header, cargo line, the active-stop card, and a small progress bar with per-stop markers (green completed, ringed blue active, purple final destination).
- Route — adds the full stop list, windowed intelligently around the active stop on long routes, with "N more stops" indicators. Completed stops can be hidden entirely.
- Expanded — everything above plus a connection block: pipe status, protocol version, link latency, last message/route update, voice-cue state, and live telemetry basics.
Selecting and replacing stops from the cab
With overlay controls on, in Route or Expanded mode, the arrow keys move a highlight through pending stops. Press Enter on one to ask the desktop app to replace it — the same swap as the desktop's Replace button, without alt-tabbing. Quick settings → Actions adds more: refresh the route, reconnect, request the latest route state, or bring the desktop app to the front.
HUD notifications
Dispatch moments — pickup approaching or confirmed, delivery approaching or confirmed, final destination, route updated, stop replaced, app connected or disconnected — appear as small cards that fade in and out. Cards queue rather than overlap, dodge the route panel instead of covering it, and carry a small musical-note mark when a voice cue was spoken for the same moment.
HUD quick settings (Alt+F8)
Everything about the HUD is configured in-game from the keyboard: Tab/Shift+Tab switch sections, Up/Down select a row, Left/Right change its value, Enter activates, Ctrl+S saves immediately (changes also auto-save shortly after you stop adjusting). Esc closes.
- Display — overlay mode, UI and font scale, panel width, max height, distance units, progress style, show only during jobs, show when paused, auto-hide, developer info.
- Position — eight screen presets cycled with Left/Right, plus free placement with arrows (Shift = faster, Ctrl = 1 px steps). The panel is always kept on-screen.
- Appearance — overall and background opacity (independent, so text stays crisp), corner radius, border, shadow, high-contrast mode, larger active-stop text, animations, compact spacing.
- Route — show/hide completed stops, city, state, distance and progress percentage; visible row count; whether the list centers on the active stop.
- Notifications — on/off, duration, screen position, reduced motion, connection notifications, and the voice-cue indicator.
- Hotkeys — rebind all four HUD keys in-game (F8–F12, alone or with one modifier); clashes are flagged in red before saving.
- Actions — refresh route, request route state, reconnect, open the desktop app, reset every HUD setting to defaults.
Voice cues
Open Settings → Voice Cues in the desktop app and pick a voice pack — or Chimes for simple beeps, or Off for silence. It's off by default. There are five cues: nearing a pickup, nearing a drop-off, a pickup completing, a drop-off completing, and the final delivery. A volume slider and a Test voice button sit below it, and a missing line falls back to a chime so a cue is never silent.
- Only one cue speaks at a time, and each line plays out in full — long custom recordings are never cut short by the next event.
- Cues that go stale while waiting are skipped instead of played late. Confirmations are never dropped just for waiting their turn.
- Approaching reminders need a moment of genuinely closing in on a stop, so loading a save or teleporting nearby no longer triggers a false reminder — and at highway speed they fire a little earlier.
- The Test voice button won't talk over live dispatch; it politely declines with a small note instead.
Troubleshooting
- Activation key expired — sign in at dromodding.com, open My Downloads, and download a fresh ats-dispatch-key.zip. Drop it in the same mod folder as before — no reinstall needed.
- App opens but nothing happens while I drive — confirm the telemetry plugin (Step 3) is installed, that a job is actually accepted in-game, and check the status line ("Game closed" or "Waiting for game…" means it isn't connected yet).
- No delivery stops appear on a job — the Setup button is red, so Step 3 isn't done. Open Setup, confirm the game folder, then run Install game plugins and Enable Real Map Locations again and wait for it to turn green. On a very short route only a stop or two may appear even when set up correctly.
- A website job says I'm "too far" to accept — expected. Drive to the pickup in-game with your trailer, park, save, quit the game, then click Accept job again. Nothing is written when it refuses.
- The window disappeared — press Alt+Shift+D (or your custom combo). If that doesn't work, another program may be using that combo — pick a different one in Settings → Window Toggle Shortcut.
- The in-game HUD never appears — re-run Setup → Install game plugins with the game closed. Still nothing? Check Documents\American Truck Simulator\game.log.txt for lines mentioning ats-dispatch-hud; "unable to find any required function" means an outdated plugin copy — reinstalling fixes it.
- HUD says "Dispatch app not running" or "Protocol mismatch" — start the desktop app (the HUD reconnects on its own within a few seconds), or update the app and re-run Install game plugins so both halves match.
- The HUD panel vanished — press F8 (or your rebound toggle). If settings got strange, use Alt+F8 → Actions → Reset to defaults, or delete Documents\ATS Dispatch Pro\config\overlay.json and it's recreated.
Uninstalling
Windows 11: Settings → Apps → Installed apps. Windows 10: Control Panel → Programs and Features. Find "ATS Dispatch Pro" and uninstall like any other program.
Credits & acknowledgements
ATS Dispatch Pro is a thin overlay on top of other people's real work reading and parsing ATS/ETS2's own game files and telemetry. None of the real map locations, route planning, or live telemetry would be possible without these projects:
- RenCloud — scs-sdk-plugin: the in-game plugin that exposes ATS/ETS2's live job/truck/navigation state. Everything the app knows about your current job ultimately comes from this plugin. MIT licensed; bundled and installed locally by the Setup panel.
- kniffen — TruckSim-Telemetry: the library used to read RenCloud's plugin output as clean, typed events. MIT licensed.
- truckermudgeon: the Linux/macOS scs-sdk-plugin fork, and the maps parser tool — the engine behind real map locations, route planning, and the final delivery stop. GPL-3.0-or-later; bundled as a separate process with license text included.
ATS Dispatch Pro is an unofficial, read-only companion overlay for American Truck Simulator and Euro Truck Simulator 2. Not affiliated with or endorsed by SCS Software.
The FAQ covers the most common issues, or reach out directly.
