crazyvito11 / beammp-linux-helper-2023

Install instructions and script to launch BeamNG with the multiplayer mod

BeamMP Linux Helper

Install instructions and script to launch BeamNG with the multiplayer mod.

Requirements

• BeamNG is installed in ~/.steam/steam/
• Protontricks

Installing BeamMP

1. Make sure you have installed BeamNG and run the game at least once.

2. Download the BeamMP client from the BeamMP website.

3. Extract the ZIP so you are left with BeamMP_Installer.exe.

4. Run Protontricks and select the BeamNG steam app. (Steam ID 284160)

5. Press "Select the default wineprefix".

6. Press "Run explorer".

7. Navigate to the BeamMP_Installer.exe and double click the file to execute it.

8. Follow the installer just like you normally would on Windows.

Running BeamMP

All you have to do, is run the launch-beammp.sh file located in this repository. This should launch the game.

If you stored the game or Proton in a different location, you will have to modify the launch-beammp.sh script first to point it to the correct directories.

Troubleshooting

If the game doesn't launch and you get an error, you can try to find it in this list and possible fixes. Keep in mind that these are the error's that I've seen, please visit the BeamMP wiki for more troubleshooting information.

Command not found or Permission denied

If you get this error while trying to run launch-beammp.sh, you most likely forgot to add execution rights to the script.

Possible fixes

• Make sure that the launch-beammp.sh has execution rights.
  • These can be added using chmod +x launch-beammp.sh
  • Or alternatively, using your desktop environment by right clicking the file and going to Properties -> Permissions -> Is executable.

Failed to find the game please launch it. Report this if the issue persists code X

According to the BeamMP wiki, this error means that the launcher was unable to find or read the game's info inside the registery.

Possible fixes

• Make sure that the Proton version matches that of your BeamNG install.
• Make sure that you have actually launched the game at least once before.