Questa guida copre la configurazione admin, le risorse lato server, le mappe personalizzate, la gestione dei veicoli e la risoluzione dei problemi per il tuo server BeamMP su Legion Hosting. Per la configurazione iniziale del server, le chiavi di autenticazione e la configurazione di base, consulta la Guida alla Configurazione del Server BeamMP.

Configurazione Admin

BeamMP non ha un sistema tradizionale di login o password admin. Invece, i comandi admin vengono eseguiti tramite la console del server o tramite plugin Lua lato server che verificano gli identificatori dei giocatori.

Comandi della Console

La console del server in GPanel fornisce accesso diretto ai comandi integrati del server. Digita i comandi direttamente nel campo di input della console:

Struttura della Cartella Resources

BeamMP utilizza una cartella Resources per organizzare i contenuti lato server. Questa cartella contiene due sottodirectory con scopi distinti:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Risorse Client

I file inseriti in Resources/Client/ vengono automaticamente scaricati dai giocatori quando si connettono. Questo viene utilizzato per:

• Mappe personalizzate — File .zip di mod mappe che i giocatori devono scaricare per caricare la mappa del server.
• Veicoli personalizzati — File .zip di mod veicoli che aggiungono nuove auto o modificano quelle esistenti.
• Altre mod client — Qualsiasi mod di BeamNG.drive che deve essere presente sul client.

Risorse Server (Plugin Lua)

La directory Resources/Server/ contiene plugin Lua lato server. Questi vengono eseguiti solo sul server e non vengono inviati ai giocatori. Ogni plugin si trova nella propria sottocartella con un file main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

I plugin lato server possono:

• Rispondere agli eventi dei giocatori (connessione, disconnessione, messaggi in chat, spawn di veicoli).
• Implementare comandi personalizzati attivati tramite chat (es. /tp, /give).
• Gestire permessi e limiti dei veicoli.
• Aggiungere sistemi economici, teletrasporto o altre funzionalità di gameplay personalizzate.
• Registrare l'attività dei giocatori e applicare regole.

Aggiungere Mappe Personalizzate

Per eseguire una mappa personalizzata (non predefinita) sul tuo server BeamMP:

1. Scarica la mod mappa come file .zip da una fonte di mod BeamNG.drive (es. il repository di mod di BeamNG.drive).
2. Ferma il tuo server in GPanel.
3. Carica il file .zip in Resources/Client/ tramite la scheda Files o SFTP. Non estrarre lo zip.
4. Aggiorna la variabile di avvio MAP (o Map in ServerConfig.toml) con il percorso corretto della mappa personalizzata. Questo percorso è tipicamente nel formato /levels/map_name/info.json — controlla la documentazione della mod per il percorso esatto.
5. Avvia il server.

Gestione Veicoli

La gestione dei veicoli sui server BeamMP è controllata tramite l'impostazione MaxCars e opzionalmente tramite plugin Lua lato server.

Impostazione MaxCars

L'impostazione MaxCars in ServerConfig.toml (o la variabile di avvio MAX_CARS) controlla quanti veicoli ogni giocatore può generare simultaneamente:

• 1 — Ogni giocatore può avere un veicolo alla volta (consigliato per server più grandi).
• 2–3 — Permette ai giocatori di avere un paio di veicoli, utile per server più piccoli o raduni di auto.
• Valori più alti aumentano proporzionalmente il carico del server.

Mod Veicoli Personalizzati

Per aggiungere veicoli personalizzati al tuo server:

1. Scarica la mod del veicolo come file .zip.
2. Inseriscila in Resources/Client/.
3. Riavvia il server. I giocatori scaricheranno automaticamente la mod del veicolo alla connessione.

Limitare i Veicoli tramite Plugin

Per un controllo più granulare (es. bannare veicoli specifici, limitare i tipi di veicoli), avrai bisogno di un plugin Lua lato server. Questi plugin possono intercettare gli eventi di spawn dei veicoli e consentirli o negarli in base a regole personalizzate. Controlla i forum di BeamMP per i plugin di gestione veicoli.

Installazione e Gestione dei Plugin

I plugin Lua lato server estendono le funzionalità del tuo server. Ecco come installarli e gestirli:

Installare un Plugin

1. Scarica i file del plugin (tipicamente una cartella contenente main.lua e possibilmente altri file).
2. Ferma il tuo server.
3. Carica la cartella del plugin in Resources/Server/ tramite la scheda Files o SFTP.
4. Assicurati che la struttura delle cartelle sia corretta: Resources/Server/PluginName/main.lua.
5. Avvia il server. La console mostrerà messaggi durante il caricamento dei plugin.

Rimuovere un Plugin

1. Ferma il tuo server.
2. Elimina la cartella del plugin da Resources/Server/.
3. Avvia il server.

Risoluzione dei Problemi

Errori della Chiave di Autenticazione

• Verifica che la chiave sia stata incollata correttamente nella variabile di avvio AUTH_KEY — senza spazi extra o interruzioni di riga.
• Assicurati che la chiave non sia stata revocata o scaduta sul BeamMP Keymaster.
• Ogni chiave può essere utilizzata su un solo server alla volta. Se stai usando la stessa chiave altrove, non funzionerà.
• La console mostrerà errori di autenticazione all'avvio se la chiave non è valida.

I Giocatori Non Riescono a Connettersi

• Conferma che il server sia completamente avviato e mostrato come online in GPanel.
• Verifica che il giocatore stia utilizzando il launcher BeamMP, non il launcher standard di BeamNG.drive.
• Se il server è impostato su Private = true, i giocatori devono utilizzare la connessione diretta con l'IP e la porta corretti. Consulta Come Trovare l'IP e la Porta del Tuo Server.
• Assicurati che la versione del launcher BeamMP del giocatore sia compatibile con la versione del server. I launcher obsoleti potrebbero non riuscire a connettersi.
• Se il server è pieno (raggiunto il MaxPlayers), altri giocatori non possono unirsi finché qualcuno non esce.

Problemi di Sincronizzazione delle Mod

• Se i giocatori si bloccano durante il download o ricevono errori su mod mancanti, verifica che i file .zip delle mod in Resources/Client/ non siano corrotti.
• Scarica nuovamente e ricarica il file della mod se lo .zip è danneggiato.
• File di mod molto grandi possono causare timeout per i giocatori con connessioni lente. Considera di rimuovere mod di grandi dimensioni non necessarie.
• Assicurati che i file .zip delle mod non siano annidati (ovvero uno .zip dentro una cartella dentro un altro .zip).

Problemi di Prestazioni con Molti Giocatori/Veicoli

• Riduci MaxCars a 1 per giocatore.
• Abbassa MaxPlayers se il server presenta lag costante.
• Passa a una mappa più semplice (Grid Map o Industrial) per migliori prestazioni con un alto numero di giocatori.
• Rimuovi le mod client non necessarie da Resources/Client/ per ridurre i tempi di download e l'utilizzo di memoria.
• Controlla i grafici di utilizzo risorse di GPanel — se CPU o RAM sono costantemente al limite, considera di aggiornare il tuo piano server. Apri un ticket di supporto per discutere le opzioni.

Il Server Non Appare nel Browser

• Assicurati che Private sia impostato su false nella tua configurazione.
• Verifica che la chiave di autenticazione sia valida e non in uso da un altro server.
• Attendi 1–2 minuti dopo l'avvio affinché il server si registri con il backend di BeamMP.
• Controlla la console per eventuali errori relativi alla connessione al master server.

Articoli Correlati

• Guida alla Configurazione del Server BeamMP — Configurazione iniziale, chiave di autenticazione, configurazione e istruzioni di connessione
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File tramite SFTP
• Guida all'Avvio del Server — Guida generale per avviare qualsiasi server di gioco su Legion Hosting

Hai Bisogno di Ulteriore Aiuto?

Se riscontri problemi non coperti da questa guida, il nostro team di supporto è disponibile ad assisterti. Apri un ticket su legionhosting.net/submitticket.php con i dettagli del tuo server, una descrizione del problema e tutti i messaggi di errore rilevanti dalla console di GPanel.