Truck Nav

Truck Nav is an external GPS navigation system for Euro Truck Simulator 2 and American Truck Siulator built using Typescript. It runs as an APK, EXE or browser (perfect for a phone, tablet or second monitor) and provides real-time tracking and routing based on the in-game map.

Current Status: Work in Progress / Demo

Please consider this project a Demo or Alpha.

While the core navigation works, the project is far from perfect. Creating the routing graph required a massive amount of work in QGIS and scripting, fixing road segments, roundabouts, and intersections to ensure the GPS knows where it can and cannot go.

ATS / ETS2 Version: Up to 1.58 ✅
Supported DLCs: All ✅
Map Mods: None ❌

Known Issues & Limitations

⚠️ Common Quirks

Company Areas: GPS routing might fail if you are deep inside a company yard. Try moving your truck slightly toward the exit before setting the destination if errors are happening.
Map Gaps: The graph I currently use can produce some errors (disconnected roads, illegal U-turns) but should 99% of the time show the correct route.

📈 Performance & Compatibility

[!NOTE]

Performance: Optimization is ongoing. On older tablets or phones, the map rendering may feel laggy.

Map Support: Currently supports base ETS2/ATS + all DLCs (up to v1.58). ProMods and other map mods are NOT yet supported.

[!CAUTION]
Real Company Name Mods: If you use other mods that change company names other than the mod from MLH82, the navigation will likely fail or route incorrectly. The app is optimized for only vanilla and Real companies, gas station & billboards for ATS and ETS2 by MLH82.

Installation via .exe File

Download the latest setup file from the
Releases page.
Run the downloaded setup file and complete the installation.
Launch Truck Nav on your PC.
Install the .apk file on your tablet or phone.
Open the mobile app or the web browser on any device and enter the IP address displayed in the PC application.

Instalation via nodejs

Prerequisites

Before installing, ensure you have the following software installed on your computer:

Node.js (LTS Version): Required to run the application.

Download the latest LTS version (Recommended): https://nodejs.org/

Git: Required to clone the telemetry repository automatically.

Download Git: https://git-scm.com/downloads

Installation

1. Get the Code

You can either clone the repository using Git (recommended for easy updates) or download the ZIP file.

Option A: Git Clone (Recommended)
Open your terminal or command prompt and run:

bash
git clone https://github.com/Rares-Muntean/TruckNav-Sim.git
cd TruckNav-Sim

Option B: Download ZIP

Click the Code button at the top of this page and select Download ZIP.
Extract the files to a folder on your computer.
Open that folder in your terminal or VS Code.

2. Prepare the Environment (Windows Users)

If you are on Windows, you may need to run the following commands to ensure the installation proceeds without problems.

PowerShell Script Execution:

If you encounter errors regarding disabled scripts in PowerShell, run one of the following commands as Administrator:
Temporary Fix (Recommended):

Powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Permanent Fix:

Powershell
Set-ExecutionPolicy RemoteSigned

3. Install Dependencies

bash
npm install

Running the App

Start the development server with the following command and wait for the Ets2 Telemetry server to clone:

Bash
npx nuxi dev --host 0.0.0.0

Follow the instructions from the opened .exe to install the telemetry plugin DLLs into your game directory.

Accessing the App in Your Browser

To open the app in your browser, click the network link shown in the terminal (the local link may have telemetry fetching issues):

Bash
➜ Network: http://192.168.1.x:3000/

How it Works

Telemetry: The app uses a telemetry server to pull data (coordinates, speed, heading) directly from the running game.
Mapping: The in-game coordinates are converted to a standard WGS84 projection to allow them to work with web mapping libraries (visual issues might still appear).
Routing: A custom graph built from game files allows the app to calculate the shortest path to your destination.

How You Can Help Improve the Map

If you test the application and encounter strange behavior, you can help improve the navigation by reporting what you find.

What to Report

A brief description of the issue
A screenshot from the app

Where to Send Reports

Send your findings to ONE of the options below:

raresmnt@yahoo.com
Discord Server -> #🪲-bugs
GitHub -> Issues

Your reports help refine the application and improve navigation accuracy.

Note:
Reported issues will be addressed as time permits.

Credits & Acknowledgements

@truckermudgeon

Special thanks for the 'maps' repository.

This provided the essential starting point for map parsing and was the catalyst that turned the idea into a reality.
The logic for converting internal game coordinates to a usable format (WGS84) was invaluable for getting the map rendered correctly.

@RenCloud

Thanks for the scs-sdk-plugin.

This tool is the bridge that allows the browser to communicate with the game engine. It's core functionality is refined and implemented seamlessly inside TruckNav.

Drive safe, and happy trucking!