Multi-instance MBII server manager with plugin system, config generation, and process control.

• Per-instance JSON configs with template-based server.cfg generation
• Auto-detects MBII folder and engine binary
• mimalloc memory allocator (Linux: LD_PRELOAD, Windows: side-by-side DLL)
• Plugin system (native + standalone)
• RTV/RTM voting, auto-messages, VPN monitor
• Process watchdog with auto-restart on crash and scheduled restart (configurable hours)
• MBII updater integration with retry logic
• Cross-platform: Linux (Debian, Fedora, Arch) and Windows

git clone https://github.com/Wookiee-/vmb2m.git
cd vmb2m
./install.sh

This installs everything needed: Python 3, 32-bit libraries, mimalloc, .NET SDK 6.0, MBII updater files, and the mbii command shortcut.

cp configs/example.json configs/my_server.json
nano configs/my_server.json

Change at minimum:

• host_name — your server name
• port — server port (default 29070)
• rcon_password — choose a secure password
• maps.primary — your map list

The mbii_path and engine fields auto-detect if left empty.

mbii my_server start

The server runs in the foreground. Auto-restarts on crash (up to 5 times). Press Ctrl+C to stop.

mbii my_server stop

Download from https://python.org — check "Add Python to PATH" during install.

Download or clone the repo, or download the ZIP from GitHub.

Download from: https://dotnet.microsoft.com/en-us/download/dotnet/6.0

Or via winget:

winget install Microsoft.DotNet.SDK.6

Copy configs\example.json to configs\my_server.json and edit it. Set your server name, port, passwords, and maps.

python manager.py my_server start

Press Ctrl+C to stop.

python manager.py my_server stop

Set admin accounts in your instance JSON under "smod". Each admin gets a config value that's the sum of their permission values. The following commands are granted automatically to all SMOD accounts: Say, Smsay, Status, Who.

Example — full access (all permissions):

"admin_1": { "password": "securepass", "config": 65535 }

Example — map + forceteam only:

"admin_2": { "password": "lesserpass", "config": 260 }

(4 + 256 = 260)

Calculate custom values by adding up the numbers, or use the interactive calculator at tools/smod_calculator.html.

Set "restart_every_hours": 24 in your instance JSON. The manager will gracefully restart the engine every 24 hours to prevent memory leaks or performance degradation. Crash auto-restart still works independently.

Create one JSON file per server in configs/:

cp configs/example.json configs/eu_west.json
cp configs/example.json configs/us_east.json
# Edit each with different ports and settings
mbii eu_west start
mbii us_east start

Configured under "rtvrtm" in your instance JSON or in configs/rtvrtm.template.

Enable in your instance JSON under "plugins":

"plugins": {
    "rtvrtm": true,
    "automessage": {
        "messages": ["Welcome!"],
        "interval": 300
    },
    "vpnmonitor": {
        "apikey": "your_iphub_key"
    }
}

• true — enables with defaults
• { } — enables with custom settings
• Omit or set false to disable

configs/              # Per-instance JSON configs + templates
plugins/
  rtvrtm/             # Rock the Vote / Rock the Mode
  automessage/        # Rotating chat messages
  vpnmonitor/         # VPN/proxy detection
manager.py            # Boot, process control, auto-restart
mimalloc/             # mimalloc DLLs (Windows)
updater/              # MBII CLI updater files