Milevox Tracker
Frequently asked questions
Setup, telemetry, deliveries, overlay, account, VTCs, achievements and troubleshooting · all in one place.
Getting started
How do I install the tracker?
Download the latest MilevoxTracker.exe from milevox.app/download. Double-click to run. There's no installer · it's a single self-contained file. The first launch auto-installs the SCS telemetry plugin into your game folder.
What do I need installed before running the tracker?
Just WebView2 Runtime. On Windows 11 and recent Windows 10 it's already preinstalled by Windows Update. On older Windows 10 builds or Windows 10 LTSC, you may need to install it manually: developer.microsoft.com/microsoft-edge/webview2 → "Evergreen Standalone Installer" → run it once.
If WebView2 is missing, the tracker will fail to open its window (you might see a flash and nothing else). Everything else (.NET runtime, SCS plugin, dependencies) is bundled inside the EXE itself · nothing else to install.
If WebView2 is missing, the tracker will fail to open its window (you might see a flash and nothing else). Everything else (.NET runtime, SCS plugin, dependencies) is bundled inside the EXE itself · nothing else to install.
Where is the tracker installed?
Wherever you put the .exe. The tracker stores its data and logs in
%APPDATA%\\MilevoxTracker\\Does it work on Mac / Linux?
No, Windows only. The tracker uses Windows-specific APIs and WebView2.
Does it auto-update?
Yes. On launch, it checks for a new version. If one is available, you'll see "Update available" in the sidebar bottom-left. Click it, hit "Install update", and the tracker restarts on the new version automatically.
Can I run it on multiple PCs?
Yes · sign in with the same account on each, your stats sync via the cloud. Don't run two instances of the same game at the same time, only the most recent will register deliveries.
Game detection / telemetry
The tracker doesn't see my game
Check the Driving tab · the small pill at the top says No game (gray dot) when nothing is detected, or ETS2 (blue) / ATS (orange) when it is.
If it stays at No game:
1. Close the game completely
2. Make sure you've launched the tracker at least once before the first time you start the game (so the plugin gets installed)
3. Restart the game
4. Wait 5 to 10 seconds for the SDK to hook
If it stays at No game:
1. Close the game completely
2. Make sure you've launched the tracker at least once before the first time you start the game (so the plugin gets installed)
3. Restart the game
4. Wait 5 to 10 seconds for the SDK to hook
Do I need to launch the tracker before the game every time?
No · only the very first time. The tracker auto-installs
The only case where order matters again is when a tracker update brings a new plugin version. If your game is already running when that happens, you'll see a popup asking you to restart the game (the old plugin stays loaded in memory until then).
scs-telemetry.dll in your game's plugins/ folder on first launch. Once the plugin is in place, the order doesn't matter anymore · you can start the game first and the tracker later, or vice versa, and live telemetry will connect either way.The only case where order matters again is when a tracker update brings a new plugin version. If your game is already running when that happens, you'll see a popup asking you to restart the game (the old plugin stays loaded in memory until then).
Where does the plugin go?
ETS2:
ATS:
If the plugins/ folder doesn't exist, create it. If you uninstall a game and reinstall it, the plugin gets wiped · the tracker will re-install it on its next launch.
Steam/steamapps/common/Euro Truck Simulator 2/bin/win_x64/plugins/scs-telemetry.dllATS:
Steam/steamapps/common/American Truck Simulator/bin/win_x64/plugins/scs-telemetry.dllIf the plugins/ folder doesn't exist, create it. If you uninstall a game and reinstall it, the plugin gets wiped · the tracker will re-install it on its next launch.
Does it work with TruckersMP?
Yes. The plugin works in both singleplayer and TruckersMP.
Does it work with non-Steam versions of the game?
The tracker only auto-installs the plugin in Steam libraries · it reads the Steam registry to locate your
If you own a non-Steam copy (CD, GamersGate, etc.), the SCS Telemetry SDK plugin still works · you'll just need to copy
Pirated copies aren't supported.
steamapps/common/ folders.If you own a non-Steam copy (CD, GamersGate, etc.), the SCS Telemetry SDK plugin still works · you'll just need to copy
scs-telemetry.dll manually into the game's bin/win_x64/plugins/ folder. The DLL is bundled inside the tracker; you can also grab it from the SCS Telemetry SDK repo.Pirated copies aren't supported.
Will the plugin get me banned on TruckersMP?
No. The SCS Telemetry SDK is read-only · the plugin only reads game state, it never modifies anything. TruckersMP allows it.
My game is running but the dot is still gray
Check
connection.log in %APPDATA%\\MilevoxTracker\\logs\\. Look for [PLUGIN] and [GAME] lines · they tell you if the plugin is hooking or not. The most common cause is the plugin not being in the right folder.Deliveries / tracking
Do mods break tracking?
No. The tracker reads whatever the game's SDK reports · custom cargos, paid trucks, modded trailers all work. They appear in your history with their mod name. There's no whitelist, nothing gets rejected.
Does it support custom maps (ProMods, RusMap, etc.)?
Yes. Maps don't affect telemetry, and city names are stored as the mod reports them.
My trip didn't get tracked
Most common causes:
· You launched the game before the tracker · see above
· You disconnected from TruckersMP mid-trip · telemetry stops, the tracker can't end the trip cleanly
· You quit the game without delivering · trips need a delivery completion event to upload
· You were offline · see "offline mode" below
If a delivery is missing, check
· You launched the game before the tracker · see above
· You disconnected from TruckersMP mid-trip · telemetry stops, the tracker can't end the trip cleanly
· You quit the game without delivering · trips need a delivery completion event to upload
· You were offline · see "offline mode" below
If a delivery is missing, check
deliveries.log · every trip's lifecycle is logged there.Does it work offline?
Yes. Trips are saved locally and uploaded when you're online again. You'll see "Offline queue: X" in the sidebar if anything is pending. They sync automatically when the connection is back.
Can I edit or delete a delivery I made?
No · deliveries can't be edited or deleted. This preserves the integrity of leaderboards, achievements and stats across the whole community.
If a delivery is clearly wrong (TruckersMP disconnect, game crash, telemetry bug, etc.), open a ticket on Discord with the trip details and staff will investigate.
If a delivery is clearly wrong (TruckersMP disconnect, game crash, telemetry bug, etc.), open a ticket on Discord with the trip details and staff will investigate.
What's "Perfect rate"?
Percentage of your deliveries that had no damage, no fines, and were on time. It's used in leaderboards and badges.
What's eco score?
A 0 to 100 score computed from your fuel consumption, RPM behavior, hard braking, and speed. Higher = better fuel economy and smoother driving.
Window / UI
How do I move the window?
Grab the very top edge (top 11 px is a drag strip). Drag like any other window.
How do I resize?
Move the cursor near any edge or corner of the window · it will change to a resize cursor. Click-drag.
How do I zoom in / out?
Ctrl + or Ctrl = to zoom inCtrl - to zoom outCtrl 0 to resetCtrl + scroll wheel also worksYour preferred zoom is remembered between launches. On high-DPI displays (150 %, 175 %) the first launch auto-compensates.
The window is too big for my screen
The tracker clamps its starting size to your monitor's working area. If you previously sized it larger than your current monitor, just resize it back. You can also use
Ctrl 0 to reset zoom.Can I run it on a second monitor?
Yes · just drag it there.
Right-click doesn't do anything
That's intentional · the right-click menu is disabled to avoid the WebView2 "Inspect element" / "Save image" entries showing up.
Overlay (in-game HUD)
How do I open the overlay?
Default shortcut:
Ctrl + Shift + O. You can change it in Settings → Keybinds.Why doesn't the overlay show up?
· The game must be running and telemetry connected
· The game must be in borderless / windowed mode, NOT exclusive fullscreen
· Overlay must be enabled in Settings → Overlay
· The game must be in borderless / windowed mode, NOT exclusive fullscreen
· Overlay must be enabled in Settings → Overlay
How do I hide specific elements of the overlay?
Settings → Overlay → toggle each section (Route bar, RPM, Speed, Fuel, Throttle).
Can I change the overlay opacity?
Yes · Settings → Overlay → Opacity slider (20 to 100 %).
Auto-replay on collision · what is it?
When enabled, the tracker continuously records a 20-second ring buffer of your game window via ffmpeg. When a damage spike is detected, it saves a permanent
Requires
.mp4 clip to Documents\\Milevox\\clips\\. 100 % local · nothing is uploaded.Requires
ffmpeg.exe in PATH or next to MilevoxTracker.exe. The toggle is greyed out if ffmpeg isn't found.Account / authentication
I got logged out for no reason
Probably a network timeout during the startup session refresh. Fixed in the latest version · re-login and it shouldn't happen again.
Discord login isn't working
Make sure pop-ups aren't blocked. The OAuth flow opens a Discord page that you have to approve, then the tracker picks up the callback.
My Discord avatar isn't showing
The avatar is mirrored to Milevox storage on first login. If yours doesn't appear, try logging out and back in.
Can I change my username?
Yes, in Settings → Profile.
Can I delete my account?
Settings → Account → Danger zone → Delete account. This wipes your profile, deliveries, kudos, follows. VTC ownership is reassigned to another member if you own one.
VTCs
How do I join a VTC?
Open the VTC's profile → Apply. The VTC's recruiters review your application and accept or reject.
How do I create a VTC?
On the VTC Directory page, top-right Create your VTC button. Costs are listed on the form (typically free, paid plans unlock more features).
My VTC isn't visible in the directory
· New VTCs may take a minute to appear after creation
· Check it's not set as "private" in the VTC settings
· Check it's not set as "private" in the VTC settings
How do I get my VTC verified?
Open a ticket in our Discord support channel. Staff reviews verification requests case by case · the main signals are active membership, regular driving activity and respect of the rules.
Can a member be in multiple VTCs?
No, one VTC at a time.
Achievements / certifications
How do I earn an achievement?
Some are auto · they unlock when you hit a milestone (km driven, deliveries, level, etc.). Others are quizzes · you take an in-app quiz, pass it to earn.
My auto-achievement didn't unlock
The check fires after every delivery. If you've already met the condition before the tracker was released, it should have unlocked retroactively. If not, please report it with your
tracker.log.Can I retake a quiz?
Yes · the Retake quiz button appears on cards you've already passed. Useful if the questions get updated.
Bugs / support
How do I report a bug?
· Discord: open a ticket in the support channel
· GitHub: open an issue on the milevoxtracker repo
Include your
· GitHub: open an issue on the milevoxtracker repo
Include your
tracker.log (and connection.log if it's a connectivity issue) from %APPDATA%\\MilevoxTracker\\logs\\.Where are the logs?
%APPDATA%\\MilevoxTracker\\logs\\ · three files:·
deliveries.log · trip lifecycle, the file to share when a delivery is missing or wrong·
connection.log · game detection, telemetry, login, network · the file to share when the tracker can't see the game or you got logged out·
tracker.log · everything elseLogs are wiped clean after 14 days automatically.
The tracker crashed
Check the logs. If you can reproduce the crash, open a bug report with the steps + your logs.
The tracker won't start at all · no window, nothing happens
99 % of the time this is WebView2 Runtime missing. Install it from developer.microsoft.com/microsoft-edge/webview2 (Evergreen Standalone Installer) and try again.
If WebView2 is installed and it still doesn't open:
1. Right-click the EXE → Properties → if there's an "Unblock" checkbox at the bottom, tick it and Apply (SmartScreen quarantine)
2. Temporarily disable your antivirus to check if it's blocking the EXE
3. Run the EXE from a simple path like
4. Open
If WebView2 is installed and it still doesn't open:
1. Right-click the EXE → Properties → if there's an "Unblock" checkbox at the bottom, tick it and Apply (SmartScreen quarantine)
2. Temporarily disable your antivirus to check if it's blocking the EXE
3. Run the EXE from a simple path like
C:\\Milevox\\ (some antiviruses block EXEs running from Downloads)4. Open
%APPDATA%\\MilevoxTracker\\logs\\tracker.log and send us the content · even if the UI never opened, the C# side often logs the error before crashingI auto-updated and now the tracker won't open · "Bounds check failed" or "Failure processing application bundle"
The update download was truncated mid-stream by the GitHub CDN. Your EXE is corrupted (a few KB short of what it should be) and can't patch itself because it can't even start.
Fix it in 10 seconds · open PowerShell and paste this:
Fix it in 10 seconds · open PowerShell and paste this:
$paths = @("$env:USERPROFILE\Downloads\MilevoxTracker.exe","$env:USERPROFILE\Desktop\MilevoxTracker.exe","$env:LOCALAPPDATA\MilevoxTracker\MilevoxTracker.exe")
$exe = $paths | Where-Object { Test-Path $_ } | Select-Object -First 1
if (-not $exe) { Write-Host "Can't find MilevoxTracker.exe - pass the full path manually"; return }
Invoke-WebRequest "https://github.com/jessysvr30-svg/milevoxtracker-releases/releases/latest/download/MilevoxTracker.exe" -OutFile $exe
Write-Host "Replaced: $exe"Then double-click the EXE again · it should open normally. Future auto-updates are protected against this (v1.0.13+ verifies the download size and retries on truncation).How do I uninstall?
1. Quit the tracker (tray icon → Quit)
2. Delete
3. Optionally delete
4. The
2. Delete
MilevoxTracker.exe3. Optionally delete
%APPDATA%\\MilevoxTracker\\ to remove all data4. The
scs-telemetry.dll plugin stays in your game folder · delete it manually if you want a clean uninstallSettings
Run on startup
Settings → General → Run on startup. Adds the tracker to your Windows startup folder (no admin needed).
Anti-AFK on TruckersMP
Settings → General → Anti-AFK. Sends a fake keypress every few minutes to prevent the auto-kick. Only active when ETS2 / ATS is running.
Units (km / miles)
Settings → General → Units. Changes the distance / speed / fuel display across the whole tracker.
Currency, temperature, time format
All in Settings → General. They only affect the tracker's display · they don't change how data is stored or how Discord webhooks format things.
Backup / restore
Settings → Data → Backup settings exports a
.milevox file with your config. Restore reads it back. Useful when moving to a new PC.Still stuck?
Drop us a message on our Discord support channel and include your
tracker.log.