Skip to content

Guide for running BakkesMod on Linux

Notifications You must be signed in to change notification settings

CrumblyLiquid/BakkesLinux

Repository files navigation

Running BakkesMod on Linux via Proton/Wine

This is a guide to help you set up BakkesMod for Rocket League on Linux. It will show you how to install and run BakkesMod with an up to date version of Rocket League through the Proton/Wine compatibility layer.

If you're on the Steam Deck start here, otherwise continue on :)

Warning

This guide is very Steam centric (as that's what I use) but the concepts apply to different launchers as well.

If you have experience with different launchers and want to share it, check out Contributing.

Important

Using Proton is only recommended if you're running Rocket League through Steam. If that's not the case using Wine or Wine-GE is advised as using Proton outside of Steam can cause issues.

Tip

Visit the troubleshooting page if you're having issues installing or running BakkesMod.

If all else fails you can create an issue here.

Setup

Download BakkesMod

Download BakksModSetup.zip from the official website or GitHub repository.

Extracting the archive will yield BakkesModSetup.exe.

Choose an installation path

You can either:

  1. Install protontricks (preferred option for Steam users)

Warning

Use this option only with Proton (not Wine, Wine-GE or other options)

  1. Install winetricks
  2. Use plain wine (don't install Wine yourself, use the one that's used by your launcher to launch Rocket League)

Finding wine prefix

You'll need to find what wine prefix the game is running in.

Tip

On Steam this is usually ~/.steam/steam/steamapps/compatdata/252950/pfx or a similar path (note that the AppID of Rocket League on Steam is 252950). Once again for other installations you'll have to find this yourself.

Finding Wine/Proton folder

You'll need to find the path to Proton/Wine that is used for Rocket League.

Tip

On Steam this can be achieved by inspecting ~/.steam/steam/steamapps/compatdata/252950/config_info and noting the path on the 4. line without the last directory (the result should end with /dist). For me it's ~/.local/share/Steam/steamapps/common/Proton 7.0/dist for example.

You can achieve that with this command: sed -n 4p ~/.steam/steam/steamapps/compatdata/252950/config_info | xargs -d '\n' dirname

For installations other than Steam (e.g. Lutris, Heroic, Bottles, ...) you'll have to find this yourself.

Installation

Note

Replace your_prefix with the one you obtained in Finding wine prefix

Replace wine_folder with the one you obtained in Finding Wine/Proton folder

Configuring wine prefix

To be able to run BakkesModSetup.exe we need to change the Windows version of our prefix to Windows 10.

  1. Using protontricks: protontricks 252950 win10
  2. Using winetricks: WINEPREFIX="your_prefix" winetricks win10
  3. Using wine: Run WINEPREFIX="your_prefix" winecfg and set Windows Version to Windows 10

Running BakkesModSetup.exe

Now run the the previously downloaded BakkesModSetup.exe.

  1. Using protontricks: protontricks-launch --appid 252950 ~/Downloads/BakkesModSetup.exe
  2. Using wine: WINEPREFIX="your_prefix" "wine_folder/bin/wine64" ~/Downloads/BakkesModSetup.exe

This should start the BakkesMod installer. Go through the installation as you normally would.

Warning

You'll probably have to enable the executable flag for BakkesModSetup.exe.

You can do so by running chmod u+x ~/Downloads/BakkesModSetup.exe

Running BakkesMod

Tip

Visit the troubleshooting page if you're having issues running BakkesMod or injecting into Rocket League.

If all else fails you can create an issue here.

Manually

After starting Rocket League you can launch BakkesMod in the same way as running BakkesModSetup.exe.

  1. Using protontricks: protontricks-launch --appid 252950 "your_prefix/drive_c/Program Files/BakkesMod/BakkesMod.exe"
  2. Using wine: WINEPREFIX="your_prefix" "wine_folder/bin/wine64" "your_prefix/drive_c/Program Files/BakkesMod/BakkesMod.exe"

Warning

You might see this message: Mod is out of date, waiting for an update.

To work around it, you'll have to go to Settings and disable Enable safe mode. You'll be prompted with a warning before injecting.

Tip

You can find the path to BakkesMod.exe using this command: find ~ -name "BakkesMod.exe" 2> /dev/null

The path should probably end with drive_c/Program Files/BakkesMod/BakkesMod.exe

Automatically

With Steam Tinker Launch

You can start BakkesMod automatically with Steam Tinker Launch via the Custom Game Executable feature.

With a custom launch script

Note

This script works only on Steam but it shouldn't be hard to make it work on other launchers as well.

  1. Create a file somewhere in your home directory and make it executable (you can do so with chmod +x /path/to/the/script.sh)
  2. Paste in the contents of bakkes.sh or make your own launch script.

Warning

You might have to change some paths if you're using bakkes.sh.

  1. In Steam go to Library and find Rocket League in the menu on the left. Right-click on it and select Properties
  2. In the General tab you will see Launch options text field. Set that to "/path/to/bakkes.sh" & %command% (you can put any other launch options before %command%)

Warning

You might have to use absolute path to the script (also without "$HOME" or ~).

And that's it! You should now have a working BakkesMod installation that will launch alongside Rocket League and close when Rocket League does.

Tip

If you're using this script and BakkesMod needs updating, it will ask to kill Rocket League (to make sure the BakkesMod update doesn't mess anything up) after which this script will automatically kill BakkesMod as it assumes you've stopped playing.

You can work around this by running bakkes.sh directly with the --skip-checks flag.

Run /path/to/bakkes.sh --skip-checks

My setup

As of right now I'm running Rocket League on Steam via Proton 7.0.

I've written an install script that requires protontricks to run. It downloads and runs the setup executable. It also sets the Launch options in Steam to execute bakkes.sh

Warning

I haven't tested this in a while and I'm not sure if it works.

Contributing

If you find any errors or have anything to add I'll be hapy to update this guide.

You can let me know by creating an issue.

Sources

I've mainly used this issue bakkesmodorg/BakkesMod2-Plugins#2 to make my installation work. There is a lot more covered there than I've shown here. Thanks to all the people who have shared their solutions there!