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.
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:
- VPS NVMe - Per un server tra amici o un server di test
- VPS Performance - Risorse dedicate, per un server pubblico
- Server Dedicati Eco - Per una community attiva o molte mod
- Server Dedicati Performance - Prestazioni massime
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
sudo apt update && sudo apt upgrade -yInstallazione delle dipendenze
BeamMP richiede la libreria Lua 5.3 (liblua5.3-0). Gli altri pacchetti servono per il download, le mod e i backup:
sudo apt install -y liblua5.3-0 curl tar unzip nano cronCreazione di un utente dedicato
BeamMP sconsiglia di avviare il server come root o con il tuo account personale. Crea un utente dedicato:
sudo adduser --disabled-password --gecos "" beammpPorte 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
sudo ufw allow 30814/tcp
sudo ufw allow 30814/udp
sudo ufw reloadCon iptables
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.v4Il 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.
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.confCreazione dell'AuthKey
L'AuthKey identifica il tuo server presso BeamMP. Il server si rifiuta di avviarsi senza di essa, anche se resta privato.
- Vai sul Keymaster di BeamMP e accedi con Discord.
- Apri la sezione Keys.
- Clicca sul pulsante verde +.
- Inserisci un nome per il server, poi clicca su Create.
- Copia la chiave ottenuta.
Installazione del server
Connettiti come utente beammp e crea la cartella del server:
sudo -iu beammp
mkdir -p ~/beammp-server
cd ~/beammp-serverScarica l'ultima versione per il tuo sistema. La prima riga rileva la tua distribuzione, per ottenere ad esempio debian.12 o ubuntu.24.04:
. /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-ServerAvvia il server una prima volta per generare la sua configurazione:
./BeamMP-ServerConfigurazione del server
Apri il file di configurazione:
nano ~/beammp-server/ServerConfig.tomlModifica almeno questi valori nella sezione [General], senza toccare le altre righe. L'ordine delle righe nel tuo file può essere diverso:
[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 = falseProteggi poi questo file, che contiene la tua chiave, ed esci dalla sessione dell'utente beammp:
chmod 600 ~/beammp-server/ServerConfig.toml
exitParametri 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
sudo nano /etc/systemd/system/beammp.socket[Unit]
Description=BeamMP Server console
PartOf=beammp.service
[Socket]
ListenFIFO=/run/beammp.stdin
SocketUser=beammp
SocketGroup=beammp
SocketMode=0660
RemoveOnStop=trueCreare il file di servizio
sudo nano /etc/systemd/system/beammp.service[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.targetAttivare e avviare il servizio
sudo systemctl daemon-reload
sudo systemctl enable beammp.service
sudo systemctl start beammp.serviceComandi di gestione
# 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 -fVerificare il funzionamento
Il server è pronto quando i log mostrano ALL SYSTEMS STARTED SUCCESSFULLY, EVERYTHING IS OKAY:
sudo journalctl -u beammp.service -n 30 --no-pagerVerifica che sia in ascolto sia in TCP sia in UDP:
sudo ss -tulpn | grep 30814Devi ottenere una riga tcp e una riga udp associate a BeamMP-Server. Con Private = false, i log devono mostrare anche Authenticated!.
Connessione al server
- Avvia il launcher BeamMP, che avvia BeamNG.drive.
- Apri il menu multiplayer di BeamMP.
- Usa Direct Connect, poi inserisci
IP_DEL_SERVERe la porta30814.
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:
scp mio_mod.zip TUO_USER@IP_DEL_SERVER:/tmp/Sul server, installala e poi riavvia BeamMP:
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.serviceUsare una mappa moddata
Il file .zip della mappa contiene una cartella levels/<nome_della_mappa>. Trova questo nome:
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:
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:
Resources/
├── Client/ Mod inviate ai giocatori (.zip)
└── Server/
└── Welcome/ Una cartella per plugin
└── main.luaTutti 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
sudo -iu beammp
mkdir -p ~/beammp-server/Resources/Server/Welcome
nano ~/beammp-server/Resources/Server/Welcome/main.luafunction 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:
mkdir -p ~/beammp-server/Resources/Server/Whitelist
nano ~/beammp-server/Resources/Server/Whitelist/main.lualocal 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:
exit
sudo systemctl restart beammp.serviceIl 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:
sudo nano /usr/local/bin/beammp-cmd#!/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 catsudo chmod 755 /usr/local/bin/beammp-cmdPuoi poi eseguire, ad esempio:
sudo beammp-cmd list
sudo beammp-cmd say Riavvio tra 5 minutiComandi 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:
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
exitSostituisci poi l'eseguibile e riavvia:
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.serviceSe 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
sudo nano /home/beammp/backup.sh#!/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"sudo chown beammp:beammp /home/beammp/backup.sh
sudo chmod 700 /home/beammp/backup.shPianificare il backup
sudo crontab -u beammp -eAggiungi:
# Backup ogni giorno alle 5
0 5 * * * /home/beammp/backup.shIn caso di problemi
Il server non si avvia
Consulta i log:
sudo journalctl -u beammp.service -n 100 --no-pagerIl 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:
sudo chown beammp:beammp /home/beammp/beammp-server/ServerConfig.toml
sudo chmod 600 /home/beammp/beammp-server/ServerConfig.tomlErrore 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!oBackend REFUSED the auth keynei 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
.zipsi trovi inResources/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.