User Guide
Version 2.0

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

  1. Double-click ATS Dispatch Pro Setup.exe.
  2. Choose an install location (or accept the default) and finish the wizard.
  3. 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.

Don't launch it yet — without an activation key from Step 2, it shows an error and closes immediately.

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.

Keys are signed and expire after about 30 days as a light anti-piracy measure. If yours expires, grab a fresh one from the Downloads page — nothing to remember or renew.

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.zip
Do NOT enable it in the game's Mod Manager. This is not an in-game mod — it never needs to be turned on, checked, or dragged into your active mod list. Simply sitting in the folder is enough.

Once placed, launch the app. If everything is correct the window opens and shows "Waiting for game…".

If the app can't find a key at the usual location — for example, your Windows Documents folder is on a different drive — it now shows a Locate key file… dialog instead of just quitting. Click it and browse straight to your ats-dispatch-key.zip; the app remembers your choice.

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).

  1. 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.
  2. 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.
  3. 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.
If the plugin install ever fails, you can do it by hand: download RenCloud/scs-sdk-plugin from GitHub and place it in the game's bin\win_x64\plugins folder. On Linux/macOS use the truckermudgeon/scs-sdk-plugin fork.

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.

Company names, cargo names, and city names are never translated — they always appear exactly as the game reports them (a load is still "Sun-Maid Raisins" in every language). German, French, and Spanish translations are machine-generated, so a word here and there may read a little stiff.

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.
If you haven't done Step 3, no delivery stops are generated at all — the app still tracks the underlying job and shows a note asking you to enable Real Map Locations first.

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.

For website-created jobs, add the mod as a FOLDER, not a zip. Loading a custom cargo into your save means reading that mod's cargo model files (dimensions, mass, model), which the app can only do from a folder. A zip still works fine for cargo matching and normal stop generation, but a zip-only mod cargo can't load into a website job — and it's hidden from the website's create-a-job list so you can't pick one that wouldn't load.

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.

Android (Chrome/Firefox): look for "Advanced → Continue anyway" on the warning page. If it blocks outright, turn off "Always use secure connections" / "HTTPS-Only Mode" in the browser's security settings for this one site.
iPhone (Safari): usually iCloud Private Relay or the per-network "Limit IP Address Tracking" setting getting in the way. Go to Settings → Wi-Fi, tap the (i) next to your connected network, and turn off "Limit IP Address Tracking" — and/or Settings → [your name] → iCloud → Private Relay and turn that off too. Typing the address directly into Safari (instead of tapping the Camera QR banner) can also help.

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).
If your Windows Documents folder is on a different drive than usual, the app might not find your saves automatically. Use Setup → Player Save Location to browse to your real Documents folder — only needed if a Website Account is linked and your saves are somewhere non-standard.

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.

Tip — "Use my location": while the app is connected and your truck is parked at a company in-game, the website's job-creation page offers a Use my location button that fills in your current company as the origin automatically. It's the easy way to set up a job, since it guarantees you're already sitting at the pickup when you go to accept it.

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:

  1. Create the job on the website.
  2. In the game, drive to the pickup company with your trailer attached and park in its lot.
  3. Save (or let autosave run), then fully quit the game.
  4. In the app, click Accept job.
  5. 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 your save has you somewhere other than the pickup, the app refuses ("you need to be at the pickup company first") rather than putting the cargo in the wrong place. Your save is automatically backed up before every accept, into a dispatch-pro-backups folder next to your saves. The game must be closed for the button to work.

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.

Removing it is just as simple: delete ats-dispatch-hud.dll from that plugins folder. The desktop app and the telemetry plugin are unaffected.

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.

F8Show or hide the overlay
Shift+F8Overlay controls on/off (arrow keys drive the panel)
Ctrl+F8Cycle display mode: Minimal → Compact → Route → Expanded
Alt+F8Quick settings
EscBack 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.
Settings live in Documents\ATS Dispatch Pro\config\overlay.json. If it's ever damaged, the HUD quietly loads safe defaults instead of failing, and opacity has a floor so it can never load itself invisible.

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.

Still stuck?

The FAQ covers the most common issues, or reach out directly.