Rares-Muntean / TruckNav-Sim

Truck Nav **Truck Nav** is an external GPS navigation system for Euro Truck Simulator 2 and American Truck Siulator built using Typescript. It runs in the browser (perfect for a second monitor, tablet or phone) 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 manual work in **QGIS**, fixing individual road segments, roundabouts, and intersections to ensure the GPS knows where it can and cannot go. • **Bugs are expected:** I am human, and with a map this size, I'm 100% sure that missed connections or restricted turns. • **Routing Quirks:** The (navigation weighting) is still being tweaked. You might notice the GPS taking slightly unusual routes or sometimes favoring a longer path. This can also happen because of missing connections, holes in the road network, or intersections that I missed. • **Ongoing Fixes:** As I play the game and use the app, I log coordinates of broken road nodes and fix them in QGIS for future updates. • **Known Quirks:** Inside company areas, it may help to move the truck slightly outside before clicking the map to route, as routing may fail otherwise. • **Real Company Mods**: If you use mods that change company names, the navigation might get confused. It’s currently built for the default game names. > [!WARNING] > **Dual-Game Setup (ETS2 & ATS)** > > If you have both Euro Truck Simulator 2 and American Truck Simulator installed, please ensure they are located on the **same drive**. The telemetry server needs to detect both game installations to function correctly; if one is missing or on a separate drive, the application may throw errors during initialization. Known Issues & Limitations > [!CAUTION] > **Real Company Name Mods:** If you use mods that change company names (e.g., "Real Company Names"), the navigation will likely fail or route incorrectly. The app is currently optimized for vanilla game identifiers. ⚠️ Common Quirks • **Routing Logic:** The is still being tuned. You may see the GPS favor longer paths or take unusual routes due to missing nodes or restricted turns in the map data. • **Company Areas:** GPS routing might fail if you are deep inside a company yard. Try moving your truck slightly toward the exit before setting a destination. • **Map Gaps:** I am manually fixing road segments in QGIS, but some "holes" in the network still exist which can break the pathfinding. 📱 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. 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 • 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: **Option B: Download ZIP** • Click the Code button at the top of this page and select . • Extract the files to a folder on your computer. • Open that folder in your terminal or VS Code. • 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):* *Permanent Fix:* • Install Dependencies Running the App Start the development server with the following command and wait for the Ets2 Telemetry server to clone: Follow the instructions from the opened .exe to install the telemetry plugin DLLs into your game directory. > [!NOTE] > **Troubleshooting:** > If somehow the installation of the telemetry server fails, you can install it manually: > 1. Download and the server from the Funbits Telemetry Server Repo. > 2. Extract the .zip into the root folder of this project. > 3. Rename it: `ets2-telemetry-server'. 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): 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. • **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 broken intersections, missing road connections, roundabout issues, or strange routing behavior, you can help improve the navigation by reporting what you find. What to Report • A brief description of the issue • The exact coordinates of the location (if using the app in the browser) • A screenshot from the app How to Collect Coordinates • Click or tap the spot on the map where the issue occurs • Check the console — it prints the clicked coor…