Play BeamMP on Linux

beammp-on-linux.md

What you need

• browser, curl or wget
• unzip
• protontricks
• lutris

e.g Debian:
apt install curl unzip protontricks
e.g Arch/EndeavourOS:
pacman -S curl unzip protontricks

Install lutris from their website

Install BeamMP

• Download BeamMP via the website: https://beammp.com/installer/BeamMP_Installer.zip
• unzip it

Run this command
protontricks-launch --appid 284160 /path/to/BeamMP-Installer.exe

Follow the instructions
Create desktop file
DONT run BeamMP

Lutris Setup

Add local game

Gamesettings:

Runner: wine

Executable: /home/<YOUR USERNAME>/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/Desktop/BeamMP-Launcher.lnk

Wine prefix: /home/<YOUR USERNAME>/.local/share/Steam/steamapps/compatdata/284160/pfx

Option for the starter

Wineversion: Proton - Experimental

Troubleshooting

If it can't find the game, run it in Steam one time, then go back to lutris and try to launch BeamMP

You can fix the zlib decompression error by using the native BeamMP linux launcher. https://docs.beammp.com/game/getting-started/#2b-linux-installation

After switching to CachyOS im unable to build/install BeamMP for Linux, my tutorial still works for me and i'm still using it then.
For other people reading this, go ahead and try what WiserTixx wrote.

Why are you unable to build the launcher?

Copied from discord cuz i'm not at home:

Hey, i'm unable to build BeamMP for Arch based OS

I followed the instructions on https://docs.beammp.com/game/getting-started/#2b-linux-installation - installed vcpkg, base-devel & cmake via pacman.

I cloned the Repo, checkout to latest version and now getting this error when executing this command:

cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux

❯ cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
CMake Error at CMakeLists.txt:18 (find_package):
  Could not find a package configuration file provided by "httplib" with any
  of the following names:

    httplibConfig.cmake
    httplib-config.cmake

  Add the installation prefix of "httplib" to CMAKE_PREFIX_PATH or set
  "httplib_DIR" to a directory containing one of the above files.  If
  "httplib" provides a separate development package or SDK, be sure it has
  been installed.


-- Configuring incomplete, errors occurred!

Is $VCPKG_ROOT set to where vcpkg is installed?

Yep like the docs from M$ said Am 6. August 2025 17:42:40 MESZ schrieb Tixx ***@***.***>:

…

@WiserTixx commented on this gist: Is `$VCPKG_ROOT` set to where vcpkg is installed? -- Reply to this email directly or view it on GitHub: https://gist.github.com/Razuuu/c4d6f4eed43541416f6e54d76eae1070#gistcomment-5709858 Unsubscribe from this thread: https://github.com/notifications/unsubscribe-auth/AJUYX77QBRWFTCYCFX24Z333MIO7BBFKMF2HI4TJMJ2XIZLTSKBKK5TBNR2WLJDUOJ2WLJDOMFWWLO3UNBZGKYLEL5YGC4TUNFRWS4DBNZ2F6YLDORUXM2LUPGBKK5TBNR2WLJDHNFZXJJDOMFWWLK3UNBZGKYLEL52HS4DFVRZXKYTKMVRXIX3UPFYGLK2HNFZXIQ3PNVWWK3TUUZ2G64DJMNZZDAVEOR4XAZNEM5UXG5FFOZQWY5LFVEYTENJTHEZTGMJVU52HE2LHM5SXFJTDOJSWC5DF You are receiving this because you authored the thread Message ID: ***@***.***>

Could you check if $VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake exists and if so delete the bin folder in the BeamMP-Launcher directory and try running cmake again?

Could you check if $VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake exists and if so delete the bin folder in the BeamMP-Launcher directory and try running cmake again?

Works now 👍

Is $VCPKG_ROOT set to where vcpkg is installed?

I'm also having issues with beammp on CachyOS, when trying to run export VCPKG_ROOT="$(pwd)/vcpkg" export PATH=$VCPKG_ROOT:$PATH I just get this:

export VCPKG_ROOT="$(pwd)/vcpkg"
 export PATH=$VCPKG_ROOT:$PATH

fish: Unknown command: uname
/usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish (line 1): 
uname -s
^~~~^
in command substitution
       called on line 12 of file /usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish
in function '_pure_is_inside_container'
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prompt_container.fish
in function '_pure_prompt_container'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in command substitution
       called on line 7 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in function '_pure_prompt_first_line'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in command substitution
       called on line 8 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in function '_pure_print_prompt_rows'
       called on line 15 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
/usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish (line 12): Unknown command
       set --local os_name (uname -s)
                           ^~~~~~~~~^
in function '_pure_is_inside_container'
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prompt_container.fish
in function '_pure_prompt_container'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in command substitution
       called on line 7 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in function '_pure_prompt_first_line'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in command substitution
       called on line 8 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in function '_pure_print_prompt_rows'
       called on line 15 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
fish: Unknown command: id
/usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish (line 1): 
id -u -n
^^
in command substitution
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish
in function '_pure_prefix_root_prompt'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in command substitution
       called on line 11 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in function '_pure_prompt' with arguments '0'
       called on line 1 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in command substitution
       called on line 17 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
/usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish (line 2): Unknown command
   set --local username (id -u -n) # current user name
                        ^~~~~~~~~^
in function '_pure_prefix_root_prompt'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in command substitution
       called on line 11 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in function '_pure_prompt' with arguments '0'
       called on line 1 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in command substitution
       called on line 17 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution

I'm not really sure what to do here.

Hey! I'm now using the aur package beammp-launcher-git.

Works ootb. Try that and give feedback ;)

Is $VCPKG_ROOT set to where vcpkg is installed?

I'm also having issues with beammp on CachyOS, when trying to run export VCPKG_ROOT="$(pwd)/vcpkg" export PATH=$VCPKG_ROOT:$PATH I just get this:

export VCPKG_ROOT="$(pwd)/vcpkg"
 export PATH=$VCPKG_ROOT:$PATH

fish: Unknown command: uname
/usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish (line 1): 
uname -s
^~~~^
in command substitution
       called on line 12 of file /usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish
in function '_pure_is_inside_container'
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prompt_container.fish
in function '_pure_prompt_container'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in command substitution
       called on line 7 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in function '_pure_prompt_first_line'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in command substitution
       called on line 8 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in function '_pure_print_prompt_rows'
       called on line 15 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
/usr/share/fish/vendor_functions.d/_pure_is_inside_container.fish (line 12): Unknown command
       set --local os_name (uname -s)
                           ^~~~~~~~~^
in function '_pure_is_inside_container'
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prompt_container.fish
in function '_pure_prompt_container'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in command substitution
       called on line 7 of file /usr/share/fish/vendor_functions.d/_pure_prompt_first_line.fish
in function '_pure_prompt_first_line'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in command substitution
       called on line 8 of file /usr/share/fish/vendor_functions.d/_pure_print_prompt_rows.fish
in function '_pure_print_prompt_rows'
       called on line 15 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
fish: Unknown command: id
/usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish (line 1): 
id -u -n
^^
in command substitution
       called on line 2 of file /usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish
in function '_pure_prefix_root_prompt'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in command substitution
       called on line 11 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in function '_pure_prompt' with arguments '0'
       called on line 1 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in command substitution
       called on line 17 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution
/usr/share/fish/vendor_functions.d/_pure_prefix_root_prompt.fish (line 2): Unknown command
   set --local username (id -u -n) # current user name
                        ^~~~~~~~~^
in function '_pure_prefix_root_prompt'
       called on line 1 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in command substitution
       called on line 11 of file /usr/share/fish/vendor_functions.d/_pure_prompt.fish
in function '_pure_prompt' with arguments '0'
       called on line 1 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in command substitution
       called on line 17 of file /usr/share/fish/vendor_functions.d/fish_prompt.fish
in function 'fish_prompt'
in command substitution

I'm not really sure what to do here.

Hey! I'm now using the aur package beammp-launcher-git.

Works ootb. Try that and give feedback ;)

Works flawlessly! Thank you!