Learn how to use the Bug Reporting System and avoid common reporting mistakes.

How to create a new Bug Report

• To report a bug, head to our Bug Reporting System. Alternatively, click on “Guides & Support” and select “Bug Reporting System”.
• Click “Create bug report”.

Next, you must enter all relevant information about the bug you want to report. These are divided into multiple categories.

Category: Where does the issue occur?

• Game: Issues related to our Game Development team (e.g. problems with the Truck Delivery Dispatcher).
• Website: Bugs on the official website, including error messages.
• Forum: Issues experienced on the forum (e.g. permission problems).
• Launcher: Issues that occur when opening the launcher before starting TruckersMP.
• Add-On: Bugs in assets created by the Add-On team (e.g. Scout car or map edits).
• Other: Use if none of the above apply.

Title: A short summary of the issue. Provide a brief description of the issue. This does not have to be a full sentence. For example, if you want to report an issue when creating an event for your VTC, you can type “VTC event creation fails” or similar.

When entering a title, the system will suggest related Knowledge Base articles.

Details: Provide detailed information regarding your issue here.

The “Details” field is where you describe the issue as clearly and detailed as possible.

The following categories include prompts with the information needed to investigate the issue.

Game:

• Game: Euro Truck Simulator 2, American Truck Simulator, or both.
• Modification Version: Found in the launcher under the tab “Versions”.
• PC Operating System: e.g. Windows 11.
• Screenshot/Videos: Links of screenshots/videos showing the issue.

Website:

• URL: The page you are trying to access.
• Browser: e.g. Google Chrome (mention if tested in multiple browsers).
• Trace Code: In case you receive an Error 500 on our website, the website will provide a “Trace Code”. Copy this code and paste it here.
• Screenshot/Videos: Links of screenshots/videos showing the issue.

Forum:

• URL: The page you are trying to access.
• Browser: e.g. Google Chrome (mention if tested in multiple browsers).
• Screenshots/Videos: Links of screenshots/videos showing the issue.

For Game and Add-On categories, it is also useful to include the game.log file. For Launcher issues, include the launcher log.
Instructions for finding and uploading these log files can be found here.

Steps to reproduce: Describe the exact steps required to reproduce the issue.

Provide this information as clearly and detailed as possible. This section is confidential and only visible to TruckersMP team members dealing with bug reports. Use this section for any information you do not want to be publicly visible.

Marking a bug as confidential

If your bug report contains sensitive information (e.g. personal data), mark it as confidential. Only authorised team members will be able to view it.

Submit

Once all fields are completed, click “Submit”. The bug report will be reviewed by our team, who will determine whether the issue can be resolved.

Bug Reports visible to everyone

If a bug report is not marked as confidential, the bug report description will be publicly visible.

You can search for existing bug reports using keywords. We highly recommend doing this to avoid duplicate bug reports.

You can also apply filters to public bug reports, including:

• Category
• Priority
• Status
• Sorting (by date or priority)

When viewing a bug report, you can vote on whether you can reproduce the issue. You can also see comments from team members, including updates or resolutions.

What you should NOT report

Some bugs cannot be resolved by TruckersMP. TruckersMP is a standalone third-party modification and is not officially affiliated with SCS Software (including World of Trucks, ProMods, etc).

Examples of issues not handled by TruckersMP:

• Map issues on ProMods (e.g. hidden walls)
• Map issues on the base map, including DLCs (areas without any map edits from TruckersMP)
• Problems logging into World of Trucks (contact World of Trucks support here)

Some issues may seem like bugs but are actually user-specific issues. These should be handled by the Support team. You can contact them here, they will do their best to resolve the problem for you.

Contact our Support team instead of submitting a bug report if:

• You do not receive a password reset or account activation email
• You get a “Connection with Server has been broken” error
• Launcher updates are stuck and or show an error