{"id":15138367,"url":"https://github.com/crumblyliquid/bakkeslinux","last_synced_at":"2025-10-23T14:31:13.599Z","repository":{"id":174499635,"uuid":"600817875","full_name":"CrumblyLiquid/BakkesLinux","owner":"CrumblyLiquid","description":"Guide for running BakkesMod on Linux","archived":false,"fork":false,"pushed_at":"2024-10-30T21:48:50.000Z","size":58,"stargazers_count":40,"open_issues_count":7,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-30T19:06:30.413Z","etag":null,"topics":["bakkes","bakkesmod","league","linux","mod","rl","rocket","rocket-league","training"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CrumblyLiquid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-12T17:33:14.000Z","updated_at":"2025-01-25T15:42:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"a97518a5-1dd1-463b-9210-42ad2bae550d","html_url":"https://github.com/CrumblyLiquid/BakkesLinux","commit_stats":null,"previous_names":["crumblyliquid/bakkeslinux"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrumblyLiquid%2FBakkesLinux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrumblyLiquid%2FBakkesLinux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrumblyLiquid%2FBakkesLinux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CrumblyLiquid%2FBakkesLinux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CrumblyLiquid","download_url":"https://codeload.github.com/CrumblyLiquid/BakkesLinux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237843713,"owners_count":19375191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bakkes","bakkesmod","league","linux","mod","rl","rocket","rocket-league","training"],"created_at":"2024-09-26T07:22:36.947Z","updated_at":"2025-10-23T14:31:13.594Z","avatar_url":"https://github.com/CrumblyLiquid.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Running BakkesMod on Linux via Proton/Wine\n\nThis is a guide to help you set up BakkesMod for Rocket League on Linux.\nIt will show you how to install and run BakkesMod with an up to date version of Rocket League\nthrough the [Proton](https://github.com/ValveSoftware/Proton/)/[Wine](https://www.winehq.org/) compatibility layer.\n\nIf you're on the **Steam Deck** start [here](STEAMDECK.md), otherwise continue on :)\n\n\u003e [!WARNING]\n\u003e This guide is very Steam centric (as that's what I use) but the concepts apply to different launchers as well.\n\u003e\n\u003e If you have experience with different launchers and want to share it, check out [Contributing](#contributing).\n\n\u003e [!IMPORTANT]\n\u003e Using Proton is only recommended if you're running Rocket League through Steam.\n\u003e If that's not the case using Wine or [Wine-GE](https://github.com/GloriousEggroll/wine-ge-custom)\n\u003e is advised as using Proton outside of Steam can cause issues.\n\n\u003e [!TIP]\n\u003e If you're using Arch Linux or one of its derivatives you might want to try installing\n\u003e [`bakkesmod-steam`](https://aur.archlinux.org/packages/bakkesmod-steam) or\n\u003e [`bakkesmod-legendary`](https://aur.archlinux.org/packages/bakkesmod-legendary) from the AUR.\n\u003e\n\u003e More instructions are at [bakkesmod-arch](https://github.com/kentslaney/bakkesmod-arch).\n\u003e I would still recommend reading through this guide to have an idea how the setup works\n\u003e so you can do troubleshooting if needed.\n\n\u003e [!TIP]\n\u003e Visit the [troubleshooting page](TROUBLESHOOTING.md) if you're having issues installing or running BakkesMod.\n\u003e\n\u003e If all else fails you can create an issue [here](https://github.com/CrumblyLiquid/BakkesLinux/issues).\n\n## Setup\n\n### Download BakkesMod\nDownload `BakksModSetup.zip` from the [official website](https://bakkesmod.com/) or [GitHub repository](https://github.com/bakkesmodorg/BakkesModInjectorCpp/releases).\n\nExtracting the archive will yield `BakkesModSetup.exe`.\n\n### Choose an installation path\n\nYou can either:\n1. Install `protontricks` (**preferred option for Steam users**)\n\n\u003e [!WARNING]\n\u003e Use this option **only with Proton** (not Wine, Wine-GE or other options)\n\n2. Install `winetricks`\n3. Use plain `wine` (don't install Wine yourself, use the one that's used by your launcher to launch Rocket League)\n\n### Finding wine prefix\n\nYou'll need to **find what [wine prefix](https://wiki.archlinux.org/title/wine#WINEPREFIX) the game is running in**.\n\n\u003e [!TIP]\n\u003e 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.\n\n### Finding Wine/Proton folder\n\nYou'll need to **find the path to Proton/Wine** that is used for Rocket League. \n\n\u003e [!TIP]\n\u003e On Steam this can be achieved by inspecting `~/.steam/steam/steamapps/compatdata/252950/config_info` and noting the path on the 3. 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.\n\u003e\n\u003e You can achieve that with this command: `sed -n 3p ~/.steam/steam/steamapps/compatdata/252950/config_info | xargs -d '\\n' dirname`\n\u003e\n\u003e For installations other than Steam (e.g. Lutris, Heroic, Bottles, ...) you'll have to find this yourself.\n\n## Installation\n\u003e [!NOTE]\n\u003e Replace `your_prefix` with the one you obtained in [Finding wine prefix](#finding-wine-prefix)\n\u003e \n\u003e Replace `wine_folder` with the one you obtained in [Finding Wine/Proton folder](#finding-wineproton-folder)\n\n### Configuring wine prefix\n\nTo be able to run `BakkesModSetup.exe` we need to **change the Windows version of our prefix to Windows 10**.\n\n1. Using `protontricks`: `protontricks 252950 win10`\n2. Using `winetricks`: `WINEPREFIX=\"your_prefix\" winetricks win10`\n3. Using `wine`: Run `WINEPREFIX=\"your_prefix\" winecfg` and set `Windows Version` to `Windows 10`\n\n### Running BakkesModSetup.exe\n\nNow run the the previously downloaded `BakkesModSetup.exe`.\n\n1. Using `protontricks`: `protontricks-launch --appid 252950 ~/Downloads/BakkesModSetup.exe`\n2. Using `wine`: `WINEPREFIX=\"your_prefix\" \"wine_folder/bin/wine64\" ~/Downloads/BakkesModSetup.exe`\n\nThis should start the BakkesMod installer. Go through the installation as you normally would.\n\n\u003e [!WARNING]\n\u003e You'll probably have to enable the executable flag for `BakkesModSetup.exe`.\n\u003e \n\u003e You can do so by running `chmod u+x ~/Downloads/BakkesModSetup.exe`\n\n## Running BakkesMod\n\n\u003e [!TIP]\n\u003e Visit the [troubleshooting page](TROUBLESHOOTING.md) if you're having issues running BakkesMod or injecting into Rocket League.\n\u003e\n\u003e If all else fails you can create an issue [here](https://github.com/CrumblyLiquid/BakkesLinux/issues).\n\n### Manually\n\nAfter starting Rocket League you can launch BakkesMod in the same way as running `BakkesModSetup.exe`.\n1. Using `protontricks`: `protontricks-launch --appid 252950 \"your_prefix/drive_c/Program Files/BakkesMod/BakkesMod.exe\"`\n2. Using `wine`: `WINEPREFIX=\"your_prefix\" \"wine_folder/bin/wine64\" \"your_prefix/drive_c/Program Files/BakkesMod/BakkesMod.exe\"`\n\n\u003e [!WARNING]\n\u003e You might see this message: `Mod is out of date, waiting for an update`.\n\u003e\n\u003e 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.\n\n\u003e [!TIP]\n\u003e You can find the path to `BakkesMod.exe` using this command: `find ~ -name \"BakkesMod.exe\" 2\u003e /dev/null`\n\u003e \n\u003e The path should probably end with `drive_c/Program Files/BakkesMod/BakkesMod.exe`\n\n### Automatically\n\n#### With Steam Tinker Launch\n\nYou can start BakkesMod automatically with [Steam Tinker Launch](https://github.com/sonic2kk/steamtinkerlaunch) via the _Custom Game Executable_ feature.\n\n#### With a custom launch script\n\n\u003e [!NOTE]\n\u003e This script **works only on Steam** but it shouldn't be hard to make it work on other launchers as well.\n\n1. Create a file somewhere in your home directory and make it executable (you can do so with `chmod +x /path/to/the/script.sh`)\n2. Paste in the contents of [bakkes.sh](./bakkes.sh) or make your own launch script.\n\n\u003e [!WARNING]\n\u003e You might have to change some paths if you're using [bakkes.sh](./bakkes.sh).\n\n3. In Steam go to `Library` and find Rocket League in the menu on the left. Right-click on it and select `Properties`\n4. In the `General` tab you will see `Launch options` text field. Set that to `\"/path/to/bakkes.sh\" \u0026 %command%` (you can put any other launch options before `%command%`)\n\n\u003e [!WARNING]\n\u003e You might have to use absolute path to the script (also without `\"$HOME\"` or `~`).\n\n**And that's it!** You should now have a working BakkesMod installation that will launch alongside Rocket League and close when Rocket League does.\n\n\u003e [!TIP]\n\u003e If you're using this script and BakkesMod needs updating, it will ask to kill Rocket League\n\u003e (to make sure the BakkesMod update doesn't mess anything up)\n\u003e after which this script will automatically kill BakkesMod as it assumes you've stopped playing.\n\u003e\n\u003e You can work around this by running [bakkes.sh](./bakkes.sh) directly with the `--skip-checks` flag.\n\u003e\n\u003e Run `/path/to/bakkes.sh --skip-checks`\n\n## My setup\n\nAs of right now I'm running Rocket League on Steam via Proton 7.0.\n\nI've written an [install script](./install.sh) that requires `protontricks` to run. It downloads and runs the setup executable. It also sets the `Launch options` in Steam to execute [`bakkes.sh`](./bakkes.sh)\n\n\u003e [!WARNING]\n\u003e I haven't tested this in a while and I'm not sure if it works.\n\n## Contributing\n\nIf you find any errors or have anything to add I'll be hapy to update this guide.\n\nYou can let me know by [creating an issue](https://github.com/CrumblyLiquid/BakkesLinux/issues/new).\n\n## Sources\n\nI've mainly used this issue https://github.com/bakkesmodorg/BakkesMod2-Plugins/issues/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!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrumblyliquid%2Fbakkeslinux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrumblyliquid%2Fbakkeslinux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrumblyliquid%2Fbakkeslinux/lists"}