ETS2LA is a project that aims to finally bring self-driving technology to SCS Software's Truck Simulators. This page includes some information, but if you want to read all the documentation then please head over to our website!
- Download - Instructions on how to download and install the current version.
- Discord - Join our community to talk to the developers and get support.
- Website - For troubleshooting and help. Out of date with the current version!
- Docs - Developer documentation. If you want to work on ETS2LA or plugins you should start here.
Please check the FAQ for answers. If your question is not listed there, please join the Discord and ask in the support channel. We will add the answer to the FAQ if it becomes a common question!
- SCS Software - For making Euro Truck Simulator 2 and American Truck Simulator.
- TruckLib - For being the project we use to extract game files. This version of ETS2LA is fundamentally linked to TruckLib.
- ts-map and maps - For their help and examples in parsing SCS map files and rendering a usable map.
Warning
Information below this line is meant for developers. If you're a "normal" user then please use the information above.
Download .NET 10 from Microsoft. You can find that here. You'll also have to install Bun.
Now clone the repository and open the solution file in your preferred IDE. We recommend VSCode. Any code editor should work, but the project comes prepackaged with VSCode tasks for Windows and Linux. You should also download the C# Dev Kit extension, other IDEs should have their own equivalent extensions.
Before you can run ETS2LA, you'll need to make sure you have all the required dotnet tools installed. To install them, just run dotnet restore and dotnet tool restore in the root of the repository.
Building (and running) depends on your IDE. If you're using VSCode, you just press F5.
Weblate will commit translations every so often, usually within a few hours. However if you want to test your translations immediately, you can:
- Click your language
- At the top, click
Files, thenDownload original translation files as ZIP file - Copy
ets2la/ets2la/ETS2LA.Translations/Localization/lang_code.pointo your localETS2LA.Translations/Localization/lang_code.pofolder. - Build ETS2LA, your new translations will be included.
You can also directly edit the translations files in ETS2LA.Translations/Localization/. However, do not upload those back to weblate. You can edit the files, and then in weblate edit the text manually. Uploading translation files can (and will) break credits as well as cause the loss of some translations.
Please read CONTRIBUTING.md for guidelines. We welcome all contributions, but please make sure to follow our guidelines to ensure a smooth review process. If you have any questions, feel free to ask in our Discord server. (https://ets2la.com/discord)
Note
For further information please check the documentation on https://docs.ets2la.com. It's where we gather our knowledgebase.