KissMP

KISS Multiplayer mod for BeamNG.drive (Discord Channel)

This mod was modified by Rigged.gg to fix bugs and add more features. (Discord)

Main features

• Cross platform, open source & free server written in Rust
• QUIC-based networking (with help of quinn and tokio for async)
• Server list with search and ability to save favorites
• Automatic synchronization of your mods with the server
• High overall performance which allows for more players to play on the same server
• Low traffic usage
• Lag compensation
• In-game text chat
• In-game voice chat
• Lua API for creating server-side addons
• Cross platform bridge (less Wine applications for Linux users)
• Builtin server list

Contributors

• Dummiesman (most of the UI code, huge contributions to the core code)

Installation

• Drop KISSMultiplayer.zip into the /Documents/BeamNG.drive/mods folder. The archive name HAS to be named KISSMultiplayer.zip in order for the mod to work.
• You can drop the bridge .exe file to any place you want.

Usage

• Launch the bridge. If everything is correct, it'll show you the text "Bridge is running!" in the console window.
• Launch the game. After the launch, you should be able to see server list and chat windows. Select a server in the server list and hit the connect button.
• Enjoy playing!

Compatibility Matrix

Bridge and server now auto-detect a wire protocol per connection and log it at runtime (Current or Legacy).

Bridge build	Server wire format	Result
Current (this repo)	Current (this repo)	Full compatibility
Current (this repo)	Legacy (TheHellBox/KISS-multiplayer master)	Compatible via fallback

Notes:

• Legacy mode is used only for the wire format. Internally, commands are converted to current shared types.
• Newer voice-chat control commands that do not exist in legacy protocol are skipped when talking to legacy peers.
• Check bridge logs for lines like Wire protocol detected for <addr> ...: Legacy to verify which mode was selected.

Server installation

Just launch the kissmp-server for your platform and you're ready to go. More detailed guide on server configuration can be found on this wiki page.

Building

First, download and install a Rust toolchain

After, clone the repository

git clone https://github.com/TheHellBox/KISS-multiplayer.git
cd KISS-multiplayer

One-click (Windows + Linux artifacts)

Use the script below to build Windows binaries and Linux binaries (x86_64-unknown-linux-gnu) in one run. It will auto-check Docker Desktop and install cross if missing. Linux audio system dependencies are prepared automatically via Cross.toml.

powershell -ExecutionPolicy Bypass -File .\scripts\build-all.ps1

Double-click alternative:

.\scripts\build-all.cmd

Setup only (no build):

powershell -ExecutionPolicy Bypass -File .\scripts\build-all.ps1 -SetupOnly

Now you are ready to build server and bridge.

Server

cd kissmp-server
cargo run --release

or

cargo run -p kissmp-server --release

Bridge

cd kissmp-bridge
cargo run --release

or

cargo run -p kissmp-bridge --release