IT

Server di gioco

Come creare il tuo server BeamMP

Guida completa per creare un server BeamMP (il multiplayer di BeamNG.drive) su un VPS o server dedicato Linux: AuthKey, mappa, mod, plugin Lua, servizio systemd e firewall.

12 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

BeamMP è la mod multiplayer della community per BeamNG.drive. Questa guida spiega come installarne il server sul tuo VPS o server dedicato Linux, eseguirlo con un utente dedicato e un servizio systemd, poi scegliere la mappa e aggiungere mod e plugin Lua.

Ordina un server

BeamMP è leggero: le risorse necessarie dipendono soprattutto dal numero di giocatori, di veicoli e di mod. HostMyServers offre diverse soluzioni adatte:

Prerequisiti

  • Accesso SSH come root o utente con privilegi sudo
  • Sistema Linux a 64 bit x86_64: Debian 12/13 o Ubuntu 22.04/24.04
  • Firewall attivo: nftables (consigliato), iptables o ufw (usa un solo strumento firewall alla volta)
  • Un indirizzo IPv4 pubblico: il server BeamMP non supporta ancora l'IPv6 per i giocatori
  • Un account Discord, per creare la tua AuthKey sul Keymaster di BeamMP
  • Porta 30814 accessibile sia in TCP sia in UDP

Ogni giocatore deve possedere BeamNG.drive e installare il launcher BeamMP.

Configurazione richiesta

BeamMP pubblica i seguenti valori minimi, escluso il consumo del sistema operativo. La colonna di destra è un punto di partenza consigliato, da adattare al tuo utilizzo.

Componente Minimo ufficiale Punto di partenza consigliato
RAM 50 MiB disponibili 2 GB
CPU Oltre 1 GHz, preferibilmente multicore 2 core
Archiviazione 10 MiB, più mod e plugin 10 GB SSD, di più con molte mod
Rete 5-10 Mbit/s in upload 100 Mbit/s
Scheda grafica Nessuna Nessuna

Aggiornamento del sistema

Terminale
sudo apt update && sudo apt upgrade -y

Installazione delle dipendenze

BeamMP richiede la libreria Lua 5.3 (liblua5.3-0). Gli altri pacchetti servono per il download, le mod e i backup:

Terminale
sudo apt install -y liblua5.3-0 curl tar unzip nano cron

Creazione di un utente dedicato

BeamMP sconsiglia di avviare il server come root o con il tuo account personale. Crea un utente dedicato:

Terminale
sudo adduser --disabled-password --gecos "" beammp

Porte utilizzate

Porta Protocollo Utilizzo
30814 TCP Connessione dei giocatori, download delle mod
30814 UDP Dati di gioco in tempo reale

BeamMP non ha né RCON né interfaccia web: non devi aprire nessuna porta di amministrazione. La console resta accessibile solo dal server (vedi Amministrazione).

Configurazione del firewall

Con UFW

Terminale
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reload

Con iptables

Terminale
sudo iptables -A INPUT -p tcp --dport 30814 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 30814 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Il salvataggio delle regole al riavvio richiede il pacchetto iptables-persistent.

Con nftables

Questi comandi usano la tabella inet filter e la catena input, presenti per impostazione predefinita in /etc/nftables.conf su Debian.

Terminale
sudo nft add rule inet filter input tcp dport 30814 accept
sudo nft add rule inet filter input udp dport 30814 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Creazione dell'AuthKey

L'AuthKey identifica il tuo server presso BeamMP. Il server si rifiuta di avviarsi senza di essa, anche se resta privato.

  1. Vai sul Keymaster di BeamMP e accedi con Discord.
  2. Apri la sezione Keys.
  3. Clicca sul pulsante verde +.
  4. Inserisci un nome per il server, poi clicca su Create.
  5. Copia la chiave ottenuta.

Installazione del server

Connettiti come utente beammp e crea la cartella del server:

Terminale
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-server

Scarica l'ultima versione per il tuo sistema. La prima riga rileva la tua distribuzione, per ottenere ad esempio debian.12 o ubuntu.24.04:

Terminale
. /etc/os-release
curl -fL -o BeamMP-Server "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server

Avvia il server una prima volta per generare la sua configurazione:

Terminale
./BeamMP-Server

Configurazione del server

Apri il file di configurazione:

Terminale
nano ~/beammp-server/ServerConfig.toml

Modifica almeno questi valori nella sezione [General], senza toccare le altre righe. L'ordine delle righe nel tuo file può essere diverso:

Configurazione
[General]
AuthKey = "INCOLLA_QUI_LA_TUA_CHIAVE"
Name = "Il mio server BeamMP"
Description = "Benvenuto sul mio server"
Tags = "Freeroam,Lang:English"
Map = "/levels/west_coast_usa/info.json"
MaxPlayers = 8
MaxCars = 2
Private = true
AllowGuests = false

Proteggi poi questo file, che contiene la tua chiave, ed esci dalla sessione dell'utente beammp:

Terminale
chmod 600 ~/beammp-server/ServerConfig.toml
exit

Parametri principali

Parametro Valore predefinito Descrizione
AuthKey vuoto Chiave creata sul Keymaster (obbligatoria)
Name BeamMP Server Nome mostrato nella lista dei server (massimo 250 caratteri)
Description BeamMP Default Description Descrizione del server (massimo 1000 caratteri)
Tags Freeroam Tag di ricerca separati da virgole (massimo 100 caratteri)
Map /levels/gridmap_v2/info.json Mappa ospitata
MaxPlayers 8 Numero massimo di giocatori
MaxCars 1 Numero massimo di veicoli per giocatore
Port 30814 Porta TCP e UDP del server
Private true true nasconde il server dalla lista pubblica, false lo pubblica
AllowGuests true Consente ai giocatori connessi senza account BeamMP di entrare
LogChat true Registra la chat nei log
Debug false Log dettagliati, molto più voluminosi
ResourceFolder Resources Cartella di mod e plugin

Se cambi Port, adatta anche le regole del firewall.

Formattazione del nome

Name e Description accettano codici di formattazione, da inserire prima del testo: ^l grassetto, ^o corsivo, ^n sottolineato, ^r reset, ^4 rosso, ^2 verde, ^e giallo, ^f bianco. Ad esempio: Name = "^l^4Il mio server ^r^fBeamMP". La documentazione di BeamMP fornisce l'elenco completo, insieme a quello dei tag riconosciuti.

Scegliere la mappa

Indica il percorso della mappa nel parametro Map. Le mappe incluse nel gioco non richiedono alcuna installazione:

Mappa Valore di Map
Grid Map /levels/gridmap_v2/info.json
Small Grid /levels/smallgrid/info.json
West Coast USA /levels/west_coast_usa/info.json
East Coast USA /levels/east_coast_usa/info.json
Utah /levels/utah/info.json
Italy /levels/italy/info.json
Jungle Rock Island /levels/jungle_rock_island/info.json
Johnson Valley /levels/johnson_valley/info.json
Hirochi Raceway /levels/hirochi_raceway/info.json
Automation Test Track /levels/automation_test_track/info.json
Industrial /levels/industrial/info.json
Small Island /levels/small_island/info.json
Driver Training /levels/driver_training/info.json
Derby /levels/derby/info.json

Configurazione come servizio systemd

Il servizio qui sotto avvia BeamMP automaticamente. È associato a un piccolo canale locale (/run/beammp.stdin) che permette di inviare comandi alla console del server.

Creare il canale della console

Terminale
sudo nano /etc/systemd/system/beammp.socket
Configurazione
[Unit]
Description=BeamMP Server console
PartOf=beammp.service

[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=true

Creare il file di servizio

Terminale
sudo nano /etc/systemd/system/beammp.service
Configurazione
[Unit]
Description=BeamMP Server
Wants=network-online.target
After=network-online.target beammp.socket
Requires=beammp.socket

[Service]
Type=simple
User=beammp
Group=beammp
WorkingDirectory=/home/beammp/beammp-server
ExecStart=/home/beammp/beammp-server/BeamMP-Server
Sockets=beammp.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
Restart=on-failure
RestartSec=10
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

Attivare e avviare il servizio

Terminale
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.service

Comandi di gestione

Terminale
# Verificare lo stato
sudo systemctl status beammp.service

# Fermare il server
sudo systemctl stop beammp.service

# Riavviare il server
sudo systemctl restart beammp.service

# Vedere i log
sudo journalctl -u beammp.service -f

Verificare il funzionamento

Il server è pronto quando i log mostrano ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY:

Terminale
sudo journalctl -u beammp.service -n 30 --no-pager

Verifica che sia in ascolto sia in TCP sia in UDP:

Terminale
sudo ss -tulpn | grep 30814

Devi ottenere una riga tcp e una riga udp associate a BeamMP-Server. Con Private = false, i log devono mostrare anche Authenticated!.

Connessione al server

  1. Avvia il launcher BeamMP, che avvia BeamNG.drive.
  2. Apri il menu multiplayer di BeamMP.
  3. Usa Direct Connect, poi inserisci IP_DEL_SERVER e la porta 30814.

Se il server è pubblico (Private = false), i giocatori possono anche cercarlo per nome nella lista. In questo caso devono disattivare i filtri e impostare la mappa su Any.

Aggiungere mod

Le mod di veicoli e mappe vanno inserite, in formato .zip, in Resources/Client. Non decomprimerle. I giocatori le scaricano automaticamente quando entrano nel server.

Dal tuo computer, invia la mod al server con il tuo account amministratore:

Terminale
scp mio_mod.zip TUO_USER@IP_DEL_SERVER:/tmp/

Sul server, installala e poi riavvia BeamMP:

Terminale
sudo install -o beammp -g beammp -m 644 /tmp/mio_mod.zip /home/beammp/beammp-server/Resources/Client/
sudo rm /tmp/mio_mod.zip
sudo systemctl restart beammp.service

Usare una mappa moddata

Il file .zip della mappa contiene una cartella levels/<nome_della_mappa>. Trova questo nome:

Terminale
unzip -l /home/beammp/beammp-server/Resources/Client/mia_mappa.zip | grep 'levels/.*/info.json'

Se la riga mostrata contiene levels/mia_mappa/info.json, modifica ServerConfig.toml:

Configurazione
Map = "/levels/mia_mappa/info.json"

Riavvia poi il servizio. Se il file info.json non si trova nell'archivio, carica la mappa in singolo giocatore in BeamNG.drive, apri la console con ~ ed esegui print(getMissionFilename()) per ottenere il percorso esatto.

Aggiungere plugin Lua

I plugin vengono eseguiti sul server. Ciascuno ha la propria cartella in Resources/Server:

Testo
Resources/
├── Client/              Mod inviate ai giocatori (.zip)
└── Server/
    └── Welcome/         Una cartella per plugin
        └── main.lua

Tutti i file .lua posti direttamente nella cartella del plugin vengono caricati all'avvio, in ordine alfabetico. Il server ricarica automaticamente un plugin quando uno di questi file viene modificato. Le sottocartelle non vengono caricate automaticamente: usa require(). Il riferimento dei plugin descrive nel dettaglio gli eventi e le funzioni disponibili.

Esempio: messaggio di benvenuto

Terminale
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Welcome
nano ~/beammp-server/Resources/Server/Welcome/main.lua
lua
function onInit()
    print("Plugin Welcome caricato")
end

function onPlayerArrival(player_id)
    MP.SendChatMessage(player_id, "Benvenuto sul server!")
end

MP.RegisterEvent("onPlayerJoin", "onPlayerArrival")

Esempio: whitelist

Questo plugin accetta solo i nickname BeamMP presenti nell'elenco e rifiuta gli ospiti. Sempre con l'utente beammp:

Terminale
mkdir -p ~/beammp-server/Resources/Server/Whitelist
nano ~/beammp-server/Resources/Server/Whitelist/main.lua
lua
local allowedPlayers = {
    ["Player1"] = true,
    ["Player2"] = true,
}

function checkPlayer(name, role, isGuest, identifiers)
    if isGuest or not allowedPlayers[name] then
        return "Questo server è riservato ai giocatori autorizzati."
    end
end

MP.RegisterEvent("onPlayerAuth", "checkPlayer")

Esci poi dalla sessione dell'utente beammp e riavvia il server, perché un nuovo plugin non viene rilevato a caldo:

Terminale
exit
sudo systemctl restart beammp.service

Il messaggio Plugin Welcome caricato deve comparire nei log.

Amministrazione

Inviare comandi alla console

Crea un piccolo comando per scrivere nella console e mostrarne la risposta:

Terminale
sudo nano /usr/local/bin/beammp-cmd
Terminale
#!/bin/bash
if [ ! -p /run/beammp.stdin ]; then
    echo "Il server BeamMP non è avviato." >&2
    exit 1
fi
echo "$*" > /run/beammp.stdin
sleep 1
journalctl -u beammp.service -n 15 --no-pager -o cat
Terminale
sudo chmod 755 /usr/local/bin/beammp-cmd

Puoi poi eseguire, ad esempio:

Terminale
sudo beammp-cmd list
sudo beammp-cmd say Riavvio tra 5 minuti

Comandi disponibili

Comando Descrizione
help Mostra la guida
list Elenca i giocatori connessi
status Mostra lo stato del server
say <messaggio> Invia un messaggio a tutti i giocatori
kick <nome> [motivo] Espelle un giocatore
version Mostra la versione del server
reloadmods Ricarica le mod di Resources/Client
protectmod <file.zip> <true/false> Protegge una mod a pagamento o privata: non viene più inviata ai giocatori, che devono procurarsela da soli
settings help Mostra la guida per consultare o modificare le impostazioni

Per arrestare il server, usa sudo systemctl stop beammp.service.

Aggiornamento del server

BeamMP non si aggiorna automaticamente. Le nuove versioni vengono annunciate sulla pagina delle release. Verifica la tua versione con sudo beammp-cmd version.

Scarica la nuova versione accanto alla precedente:

Terminale
sudo -iu beammp
cd ~/beammp-server
. /etc/os-release
curl -fL -o BeamMP-Server.new "https://github.com/BeamMP/BeamMP-Server/releases/latest/download/BeamMP-Server.$ID.$VERSION_ID.x86_64"
chmod +x BeamMP-Server.new
exit

Sostituisci poi l'eseguibile e riavvia:

Terminale
sudo systemctl stop beammp.service
sudo -u beammp mv /home/beammp/beammp-server/BeamMP-Server.new /home/beammp/beammp-server/BeamMP-Server
sudo systemctl start beammp.service

Se cambi versione di Debian o Ubuntu, ripeti questa procedura: l'eseguibile dipende dalla distribuzione.

Backup automatico

Basta salvare la configurazione e la cartella Resources.

Script di backup

Terminale
sudo nano /home/beammp/backup.sh
Terminale
#!/bin/bash
umask 077
BACKUP_DIR="/home/beammp/backups"
SERVER_DIR="/home/beammp/beammp-server"
DATE=$(date +%Y-%m-%d_%H-%M-%S)

mkdir -p "$BACKUP_DIR"

# Backup della configurazione, delle mod e dei plugin
tar -czf "$BACKUP_DIR/beammp_$DATE.tar.gz" -C "$SERVER_DIR" ServerConfig.toml Resources

# Eliminare i backup più vecchi di 7 giorni
find "$BACKUP_DIR" -name "beammp_*.tar.gz" -mtime +7 -delete

echo "Backup completato: beammp_$DATE.tar.gz"
Terminale
sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.sh

Pianificare il backup

Terminale
sudo crontab -u beammp -e

Aggiungi:

Testo
# Backup ogni giorno alle 5
0 5 * * * /home/beammp/backup.sh

In caso di problemi

Il server non si avvia

Consulta i log:

Terminale
sudo journalctl -u beammp.service -n 100 --no-pager

Il file /home/beammp/beammp-server/Server.log contiene le stesse informazioni e non contiene la tua AuthKey. È utile per chiedere aiuto alla community BeamMP.

Messaggio Causa e soluzione
No AuthKey specified La chiave è assente da ServerConfig.toml
AuthKey specified is the wrong length La chiave è incompleta o copiata male
Backend REFUSED the auth key La chiave è rifiutata da BeamMP: verificala sul Keymaster, oppure controlla che non sia già usata da un altro server
Error parsing config file value Errore di sintassi, spesso virgolette mancanti, oppure file illeggibile: verifica che il suo proprietario sia beammp
bind() failed: Address already in use Un altro programma usa già la porta: individualo con sudo ss -tulpn | grep 30814

Se ServerConfig.toml non appartiene più a beammp, correggi i suoi permessi:

Terminale
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.toml

Errore GLIBC_ o cannot execute binary file

L'eseguibile non corrisponde al tuo sistema. Verifica la tua versione con cat /etc/os-release, poi scarica di nuovo il file adatto. Gli eseguibili proposti in questa guida sono destinati ai processori x86_64.

I giocatori non riescono a connettersi

I codici di errore 10060, 10061 o 10030 lato giocatore indicano più spesso che il server non è raggiungibile o che l'indirizzo inserito è sbagliato.

  • Verifica che il servizio sia attivo: sudo systemctl status beammp.service
  • Verifica che la porta sia in ascolto sia in TCP sia in UDP: sudo ss -tulpn | grep 30814
  • Verifica le regole del firewall, per entrambi i protocolli
  • Verifica che il giocatore usi davvero l'indirizzo IPv4 del server
  • Le VPN come Hamachi o RadminVPN non sono supportate

Il server non compare nella lista

  • Verifica che Private = false
  • Cerca Authenticated! o Backend REFUSED the auth key nei log
  • Nel gioco, disattiva i filtri e imposta la mappa su Any

Connessione bloccata dopo l'aggiunta di una mod

Una mod è probabilmente incompatibile, danneggiata o in conflitto con un'altra. Rimuovi le mod una alla volta da Resources/Client, riavviando ogni volta il server, per trovare quella responsabile.

La mappa non si carica

  • Verifica il percorso in Map, che deve terminare con /info.json
  • Per una mappa moddata, verifica che il suo .zip si trovi in Resources/Client

Il server BeamMP non è avviato con beammp-cmd

Il canale della console esiste solo quando il servizio è in esecuzione. Avvialo con sudo systemctl start beammp.service.

Un'AuthKey è stata esposta

Se la tua chiave è trapelata, BeamMP indica di aprire un ticket Account Support sul suo Discord ufficiale.