mirror of
https://github.com/BeamMP/Docs.git
synced 2026-10-25 13:40:06 +00:00
More work!!!
This commit is contained in:
Starystars67 committed
1 parent
97a7aaf643
commit
c115bc9a42
302 files changed
+28263
-10
No files matched your search
@@ -0,0 +1,54 @@
|
||||
---
|
||||
layout: home
|
||||
|
||||
hero:
|
||||
name: Documentazione BeamMP
|
||||
text: Tutto quello che devi sapere
|
||||
tagline: Guide complete per giocatori, proprietari di server e sviluppatori
|
||||
image:
|
||||
src: /assets/core/beammp_dark.png
|
||||
alt: BeamMP
|
||||
actions:
|
||||
- theme: brand
|
||||
text: Inizia
|
||||
link: /it/game/getting-started
|
||||
- theme: alt
|
||||
text: Visualizza su GitHub
|
||||
link: https://github.com/beammp/docs
|
||||
|
||||
features:
|
||||
- icon: 🎮
|
||||
title: Per i Giocatori
|
||||
details: Scopri come installare BeamMP, connettersi ai server e ottenere il massimo dalla tua esperienza multiplayer
|
||||
link: /it/game/getting-started
|
||||
- icon: 🖥️
|
||||
title: Per i Proprietari di Server
|
||||
details: Configura e gestisci il tuo server BeamMP con le nostre guide complete e risorse di risoluzione dei problemi
|
||||
link: /it/server/create-a-server
|
||||
- icon: 💻
|
||||
title: Per gli Sviluppatori
|
||||
details: Crea mod, risorse e app UI con documentazione API dettagliata ed esempi di codice
|
||||
link: /it/guides/index
|
||||
- icon: ❓
|
||||
title: Domande Frequenti
|
||||
details: Trova risposte rapide alle domande più frequenti su configurazione, risoluzione dei problemi e best practice
|
||||
link: /it/FAQ/player-faq
|
||||
- icon: 📋
|
||||
title: Regole della Comunità
|
||||
details: Scopri le nostre linee guida sulla comunità e come segnalare problemi o contestare decisioni
|
||||
link: /it/community/rules
|
||||
- icon: 🔗
|
||||
title: Comunità
|
||||
details: Unisciti al nostro Discord, seguici sui social media e connettiti con altri giocatori e sviluppatori BeamMP
|
||||
link: /it/community/index
|
||||
---
|
||||
|
||||
## Per i Proprietari di Server
|
||||
|
||||
Stai pensando di creare il tuo server BeamMP? La nostra guida completa [qui](../server/create-a-server.md) ti accompagnerà nel processo, assicurandoti di avere tutti gli strumenti e le conoscenze necessarie per configurare il tuo server in modo efficiente.
|
||||
|
||||
## Per gli Sviluppatori
|
||||
|
||||
Esplora tutti i dettagli sulla creazione di risorse per il server BeamMP nella nostra [Guida allo Sviluppo delle Risorse](../guides/mod-creation/server/getting-started.md).
|
||||
|
||||
Stiamo lavorando a entusiasmanti aggiornamenti, tra cui una nuova homepage progettata per migliorare la tua esperienza di navigazione. Resta sintonizzato per ulteriori novità! :slight_smile:
|
||||
@@ -0,0 +1,22 @@
|
||||
# Codici di errore
|
||||
|
||||
Questa pagina contiene tutti i possibili errori del server.
|
||||
|
||||
---
|
||||
|
||||
| Codice | Descrizione | Soluzione possibile |
|
||||
|--------|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| 10022 | Problema di associazione porta | Controlla se la porta in uso dal server è già occupata da altri servizi, se lo è scegline un'altra. |
|
||||
| 10048 | Indirizzo già in uso | Un altro server BeamMP o altro programma sta già usando quella porta, scegline un'altra. |
|
||||
| 10051 | Rete non raggiungibile | Port forward non corretto o errori simili, controlla che sia tutto impostato correttamente. |
|
||||
| 10052 | Reset della rete | Capita quando la rete cade nel momento in cui si effettua una nuova connessione. Riprova a connetterti. |
|
||||
| 10053 | Connessione interrotta | Causata da un timeout o errore di rete, riprova a connetterti. |
|
||||
| 10054 | Connessione reimpostata dal peer | Un utente si è disconnesso dal tuo server. |
|
||||
| 10060 | Timeout della connessione | Port forward non corretto, guarda la [guida di installazione](create-a-server.md#1-port-forwarding). |
|
||||
| 10061 | Connessione rifiutata | Port forward non corretto, guarda la [guida di installazione](create-a-server.md#1-port-forwarding). |
|
||||
| 10064 | Host inattivo | Errore non comune, significa che l'host è inattivo perché è spento o perché ha le porte chiuse. |
|
||||
| 10065 | Host non raggiungibile | Nessuna connessione ad internet oppure port forward non corretto, guarda la [guida di installazione](create-a-server.md#1-port-forwarding). |
|
||||
|
||||
::: note
|
||||
Altri codici non riportati in tabella sono disponibili qui <https://learn.microsoft.com/en-us/windows/win32/winsock/windows-sockets-error-codes-2> se sai un po' come funzionano le reti e i socket.
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
# F.A.Q. e problemi noti
|
||||
Una lista di domande frequenti e bug noti.
|
||||
|
||||
---
|
||||
## **Server**
|
||||
|
||||
---
|
||||
#### **Come posso creare un server?**
|
||||
|
||||
Tutte le informazioni per creare un server sono contenute in [questa guida](https://docs.beammp.com/it/server/create-a-server/).
|
||||
|
||||
---
|
||||
#### **Posso creare un server su Linux?**
|
||||
|
||||
Offriamo i binari pre-compilati per diverse distribuzioni Linux [qui](https://github.com/BeamMP/BeamMP-Server/releases/latest).
|
||||
Nel caso la tua distribuzione non fosse presente, puoi compilare i file sorgente scaricando il codice dal nostro [GitHub](https://github.com/BeamMP/BeamMP-Server), una guida si può trovare [qui](https://github.com/BeamMP/BeamMP-Server#build-instructions).
|
||||
|
||||
---
|
||||
#### **Quali sono i requisiti di sistema necessari per il server?**
|
||||
|
||||
- RAM: 50+ MiB (senza contare l'overhead del sistema operativo)
|
||||
- CPU: >1GHz, preferibilmente multicore
|
||||
- OS: Windows, Linux (in teoria qualsiasi POSIX)
|
||||
- GPU: non necessaria
|
||||
- HDD: 10 MiB + spazio per eventuali mod/plugin
|
||||
- Larghezza di banda internet: almeno 5-10 Mb/s in upload
|
||||
|
||||
---
|
||||
#### **I giocatori all'esterno della mia rete locale non riescono a connettersi al mio server**
|
||||
|
||||
Leggi il passo `1. Port Forwarding` della nostra guida disponibile [qui](https://docs.beammp.com/it/server/create-a-server/#1-port-forwarding). Di seguito c'è un breve riassunto dei punti salienti.
|
||||
Se giocatori esterni alla tua LAN non riescono a connettersi e ricevono sul launcher codici di errore come 10060, 10061 o 10038, segui questi passi:
|
||||
|
||||
- Fai port forwarding della porta specificata nel file `ServerConfig.toml` (quella predefinita è 30814), sia con protocollo TCP sia UDP;
|
||||
- Permetti il traffico sia in entrata sia in uscita e sia TCP sia UDP di BeamMP-Server attraverso il firewall. Spegnere il firewall di solito **non** funziona.
|
||||
- Assicurati di non stare usando una VPN.
|
||||
- Assicurati che il server funzioni senza errori.
|
||||
|
||||
Puoi vedere se la porta è aperta correttamente usando un sito come ['portchecker.co'](https://portchecker.co/) mentre il server è attivo.
|
||||
|
||||
Note:
|
||||
|
||||
- Alcuni ISP non offrono un indirizzo IPv4 dedicato a tutti (trattasi di [CGNAT](https://en.wikipedia.org/wiki/Carrier-grade_NAT)), quindi il port forwarding potrebbe non essere possibile.
|
||||
- Non è possibile effettuare port forwarding su connessioni mobili (4G/5G).
|
||||
|
||||
---
|
||||
#### **Riesco a vedere il mio server sulla lista dei server, ma non riesco a connettermi**
|
||||
|
||||
Leggi [questa sezione](https://docs.beammp.com/it/server/create-a-server/#come-connettersi-a-un-server) della nostra guida.
|
||||
Se non vuoi usare il pulsante `Direct Connect` e vuoi connetterti tramite la lista dei server al **tuo** server, il tuo router deve supportare il NAT-loopback, che di solito non è supportato dai router domestici.
|
||||
|
||||
---
|
||||
## **Varie ed eventuali**
|
||||
|
||||
---
|
||||
#### **Dove posso trovare il codice?**
|
||||
|
||||
Tutto il codice sorgente è disponibile su [GitHub](https://github.com/BeamMP).
|
||||
Prima di modificare il codice, ricordati che è soggetto ai nostri [termini di utilizzo](https://forum.beammp.com/t/terms-of-use-v1-0/43) e con le seguenti licenze:
|
||||
|
||||
| Codice | Licenza |
|
||||
|------------|:--------------------------------------------------------------------------:|
|
||||
| Server | [LICENSE](https://github.com/BeamMP/BeamMP-Server/blob/master/LICENSE) |
|
||||
| Launcher | [LICENSE](https://github.com/BeamMP/BeamMP-Launcher/blob/master/README.md) |
|
||||
| Client Lua | [LICENSE](https://github.com/BeamMP/BeamMP/blob/development/LICENSE.md) |
|
||||
|
||||
---
|
||||
#### **Ho trovato un bug o un exploit cosa faccio?**
|
||||
|
||||
Se il problema è legato al codice e sai come usare GitHub, crea una nuova "Issue" nel repo corretto sul nostro [GitHub](https://github.com/BeamMP). Il nostro flusso di lavoro è basato sulle "Issue" di GitHub; anche se hai già una soluzione al bug, sei pregato di creare una nuova "Issue" e poi chiedere una "Pull Request" che risolva la "Issue". Maggiori informazioni [qui](https://github.com/BeamMP/BeamMP/blob/development/CONTRIBUTING.md).
|
||||
|
||||
Nel caso non abbia o non sappia usare GitHub, puoi procedere nei seguenti modi:
|
||||
|
||||
- Se il problema non concerne nulla di sensibile, puoi creare un nuovo post sul nostro [forum](https://forum.beammp.com) o sul nostro [Discord](https://discord.gg/beammp).
|
||||
- Se il problema concerne informazioni sensibili, contatta un nostro membro dello staff su [Discord](https://discord.gg/beammp).
|
||||
@@ -0,0 +1,257 @@
|
||||
# Installazione del server
|
||||
|
||||
## **Creazione del server**
|
||||
Basi per la creazione di un server
|
||||
|
||||
---
|
||||
### **Introduzione**
|
||||
|
||||
**Creare un server casalingo è gratuito, ma usare a un VPS è più facile e più sicuro**
|
||||
|
||||
I server sono una parte integrante di BeamMP, tutti i giocatori sono connessi tra loro attraverso il server. I server possono funzionare nativamente su Windows e Linux.
|
||||
|
||||
Puoi creare server privati, ai quali si possono connettere solo persone che inviti, o server pubblici, che saranno visibili sulla nostra ufficiale lista di server.
|
||||
|
||||
Per far funzionare correttamente un server è necessario seguire alcuni passi! È abbastanza semplice, ma se hai dei problemi, chiedi pure sul nostro [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`. Fai anche riferimento alla sezione di [Manutenzione Server](server-maintenance.md) per ulteriori informazioni.
|
||||
|
||||
Assicurati di aver letto e compreso la [LICENZA](https://raw.githubusercontent.com/BeamMP/BeamMP-Server/master/LICENSE) del server prima dell'uso.
|
||||
|
||||
Nota: *Il server supporta esclusivamente indirizzi IPv4. Se non sai che tipo di indirizzo usi, visita il sito* [*whatsmyip.org*](https://www.whatsmyip.org/) *- se l'indirizzo contiene* `_:_` *due punti, è di tipo **IPv6**. In tal caso devi investigare più a fondo e capire se hai a disposizione anche un indirizzo IPv4. Per far ciò puoi telefonare al tuo ISP chiedendo informazioni a riguardo, o chiedi a qualcuno che se ne intende che conosci. Il supporto per gli indirizzi IPv6 è in programma.*
|
||||
|
||||
## Configurare il server
|
||||
|
||||
La configurazione consiste di pochi passi che sono obbligatori da seguire.
|
||||
|
||||
### 1. Port forwarding
|
||||
|
||||
*Se stai utilizzando un VPS (Virtual Private Server) o un Rootserver, puoi generalmente saltare questo passo. Se non sei sicuro di cosa sia un VPS o Rootserver, non lo stai usando.*
|
||||
|
||||
Questo passo è necessario se vuoi che qualcuno all'esterno della tua casa ("all'esterno del tuo network locale o LAN") possa accedere al server.
|
||||
|
||||
####
|
||||
::: danger ":material-scale-balance: LIMITAZIONE DI RESPONSABILITA':"
|
||||
|
||||
**Port forward è rischioso**
|
||||
|
||||
Facendo il port forwarding sei a conoscenza dei rischi legati ad aprire le porte del tuo network di casa al pubblico e di conseguenza sollevi BeamMP da ogni responsabilità di danni che potrebbero succedere a te o al tuo ambiente domestico.
|
||||
|
||||
Non ci assumiamo alcuna responsabilità per i contenuti presenti su pagine esterne dei servizi presentati.
|
||||
|
||||
È consigliato affidarsi a uno dei nostri partner per l'hosting del server!
|
||||
|
||||
#### Servizi a pagamento:
|
||||
|
||||
* [Horizon Hosting](https://hrzn.link/beammp)
|
||||
* [Snakecraft Hosting](https://schost.us/beammp-plans)
|
||||
* [Connect Hosting](https://connecthosting.net/beammp)
|
||||
* [Assetto Hosting](https://assettohosting.com/en/games/beamng)
|
||||
* [WinHeberg](https://winheberg.fr/offres/gaming/beammp?lang=en)
|
||||
* [Zap Hosting](https://zap-hosting.com/en/beammp-server-hosting/)
|
||||
* [HostHavoc](https://hosthavoc.com/)
|
||||
* [PedalHost](https://pedal.host/)
|
||||
|
||||
*NOTA: se se sceglie di acquistare il server da uno dei partner, il passo di Port Forwarding è superfluo.*
|
||||
|
||||
Per effettuare il port forwarding, affidarsi [a questa guida esterna](https://www.aranzulla.it/come-aprire-le-porte-del-router-31808.html).
|
||||
|
||||
#### 1.1 Firewall
|
||||
|
||||
A seconda della tua configurazione, potresti dover aggiungere BeamMP-Server alle regole del tuo firewall. Questo è il caso di Windows (spegnere il firewall di solito **non** funziona) e su molti server Linux pre-configurati.
|
||||
|
||||
Qui, come nel caso del port forwarding, devi permettere il traffico **sia in entrata sia in uscita** e sia **TCP** sia **UDP** di BeamMP-Server attraverso il firewall. Se invece il tuo firewall richiede una porta, usa la stessa utilizzata nel passo precedente ("1. Port forwarding").
|
||||
|
||||
Se hai dei problemi, chiedi pure sul nostro [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`.
|
||||
|
||||
### 2. Ottenere una chiave di autenticazione
|
||||
|
||||
La chiave di autenticazione, spesso chiamata "AuthKey", è necessaria per creare un server **pubblico**, ma è **consigliato** usarla anche per i server privati.
|
||||
|
||||
Ti servirà un account [Discord](https://discord.com) per questo passo. Discord è necessario per evitare problemi di spam.
|
||||
|
||||
#### 2.1. Accedere alla pagina delle chiavi
|
||||
|
||||
Fai il login con Discord al [Keymaster](https://beammp.com/keymaster).
|
||||
Dalla homepage del Keymaster, clicca su "Keys" a sinistra dello schermo:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
#### 2.2. Creare una chiave
|
||||
|
||||
Per creare una chiave clicca il "+" verde presente in alto a destra.
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
#### 2.3. Compilare i dati per la chiave
|
||||
|
||||
Inserisci il nome del server (questo è solo il nome per la chiave, non è il nome vero e proprio del server), poi clicca "Create", ad esempio:
|
||||
|
||||
<figure class="image image_resized" style="width:44.84%;" markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
Il risultato dovrebbe essere simile a questo:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
**NON CONDIVIDERE MAI QUESTA CHIAVE. TRATTALA COME UNA PASSWORD**
|
||||
|
||||
Hai un numero limitato di chiavi. Puoi utilizzare una chiave su un server per volta, quindi non puoi far partire due server con la stessa chiave nello stesso momento.
|
||||
|
||||
#### 2.4. Copiare la chiave
|
||||
|
||||
Copia il testo del campo "key", in questo esempio è `3173a2e-6az0-4542-a3p0-ddqq5ff95558` e tienilo pronto per il passo successivo. Puoi fare questo cliccando l'icona a destra della chiave:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
### 3. Installazione
|
||||
|
||||
Il BeamMP-Server è disponibile per Windows e Linux. Le prossime due sezioni sono dedicate all'installazione su Windows e Linux rispettivamente.
|
||||
|
||||
#### 3.a Installazione su Windows
|
||||
|
||||
Per l'installazione su Linux, salta alla sezione succesiva.
|
||||
|
||||
Ricordati di fare il port forwarding, altrimenti il tuo server non sarà raggiungibile al pubblico!
|
||||
|
||||
1. Assicurati di aver installato i [Visual C++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe), necessari per eseguire il server.
|
||||
2. Scarica l'eseguibile del server da [beammp.com](https://www.beammp.com/). Dovresti trovarti con un file chiamato `BeamMP-Server.exe`.
|
||||
3. Una volta scaricato, crea una cartella dove desideri e sposta al suo interno `BeamMP-Server.exe`. Qui è dove il server risiederà.
|
||||
4. Avvia il server cliccandoci due volte. Questo genererà tutti i files necessari e quando vedi del testo sul terminale, puoi chiuderlo. Dovresti vedere questo file chiamato `ServerConfig.toml` nella stessa cartella di `BeamMP-Server.exe`.
|
||||
5. (opzionale) Per accedere velocemente al server, crea un collegamento al desktop **cliccando col tasto destro** su `BeamMP-Server.exe` > **Invia a** > **Desktop (crea collegamento)**.
|
||||
|
||||
Passare ora al punto "4. Configurazione".
|
||||
|
||||
#### 3.b Installazione su Linux
|
||||
|
||||
##### Utilizzando la build precompilata (consigliato)
|
||||
|
||||
Questo passo è valido per tutte le distribuzioni Linux per cui offriamo i files binari [qui](https://github.com/BeamMP/BeamMP-Server/releases/latest). Se usi una distribuzione o architettura differente, salta al passo "Compilazione file sorgente".
|
||||
|
||||
1. Assicurati di avere installato tutte le dipendenze che sono elencate [qui](https://github.com/BeamMP/BeamMP-Server#runtime-dependencies).
|
||||
2. Vai su [beammp.com](https://www.beammp.com/) e clicca il pulsante "Download server", sarai reindirizzato alla pagina Github delle release del server.
|
||||
3. Scarica la versione corretta per la tua distribuzione. Per semplicità sarà chiamata `BeamMP-Server-xxx` durante la guida, dove `xxx` è la versione per la distribuzione che stai usando.
|
||||
4. Una volta scaricato, crea una cartella dove desideri e sposta al suo interno `BeamMP-Server-xxx`. Qui è dove il server risiederà.
|
||||
5. Apri un terminale, naviga alla cartella dove si trova `BeamMP-Server-xxx` e incolla il comando `chmod +x BeamMP-Server-xxx`. Questo farà in modo che si abbiano i permessi per eseguire il server.
|
||||
6. Avvia il server con il comando `./BeamMP-Server-xxx`. Questo genererà tutti i files necessari e quando vedi del testo sul terminale, puoi chiuderlo. Dovresti vedere questo file chiamato `ServerConfig.toml` nella stessa cartella di `BeamMP-Server-xxx`.
|
||||
7. (opzionale) È consigliato creare un utente chiamato `beammpserver` (o simile), siccome **non** raccomandiamo di eseguire il server come root, sudo o con il proprio utente personale. Dovresti poi rendere possibile l'esecuzione del server solo da questo utente.
|
||||
|
||||
Passare ora al punto "4. Configurazione".
|
||||
|
||||
##### Compilazione file sorgente
|
||||
|
||||
È molto probabile, ma non è stato ufficialmente provato, che BeamMP-Server per Linux funzioni su distribuzioni differenti da quelle per cui offriamo i files binari [qui](https://github.com/BeamMP/BeamMP-Server/releases/latest). Se vuoi compilare i codice sorgente puoi farlo, scaricando il codice dal nostro [GitHub](https://github.com/BeamMP/BeamMP-Server), una guida si può trovare [qui](https://github.com/BeamMP/BeamMP-Server#build-instructions).
|
||||
|
||||
Infine ricordati di eseguire il server con il comando `./BeamMP-Server-xxx`, dopodiché vai al passo successivo.
|
||||
|
||||
### 4. Configurazione
|
||||
|
||||
Dopo che il server è stato avviato almeno una volta, dovrebbe aver creato diversi files e mostrato un paio di errori; questo perché manca ancora qualcosa. La tua cartella dovrebbe contenere questi files:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
Potrebbero chiamarsi `ServerConfig`, `Server` e `BeamMP-Server` senza estensioni, ma è corretto anche questo!
|
||||
|
||||
Apri `ServerConfig.toml` con un editor di testo come `Blocco note`. Per fare ciò **click col tasto destro** > **Apri con** > **Blocco note** o un qualsiasi altro editor di testo.
|
||||
|
||||
Dovresti vedere qualcosa di simile a questo:
|
||||
|
||||
```TOML
|
||||
[General]
|
||||
AuthKey = ''
|
||||
Debug = false
|
||||
Description = 'BeamMP Default Description'
|
||||
Map = '/levels/gridmap_v2/info.json'
|
||||
MaxCars = 1
|
||||
MaxPlayers = 10
|
||||
Name = 'BeamMP Server'
|
||||
Port = 30814
|
||||
Private = false
|
||||
ResourceFolder = 'Resources'
|
||||
```
|
||||
|
||||
Questo è il tuo file di configurazione. Utilizza un formato chiamato TOML. Fai anche riferimento alla sezione di [Manutenzione Server](server-maintenance.md) per maggiori informazioni.
|
||||
|
||||
Per ora ci interessa soltanto il campo `AuthKey`. Incolla tra le virgolette `''` la chiave ottenuta nel passo "2. Ottenere una chiave di autenticazione".
|
||||
|
||||
Per questo esempio, dovrà essere così:
|
||||
```TOML
|
||||
AuthKey = '3173a2e-6az0-4542-a3p0-ddqq5ff95558'
|
||||
```
|
||||
Dai anche un nome al tuo server tramite il campo `Name`. Puoi utilizzare colori e altri tipi di formattazione seguendo le indicazioni di [questa sezione](server-maintenance.md#personalizza-laspetto-del-nome-del-tuo-server) della pagina di manutenzione del server.
|
||||
|
||||
Se hai scelto una **porta** differente da **30814** inseriscila al posto di quella predefinita in `Port`.
|
||||
|
||||
**IMPORTANTE:** Il tuo server **non** sarà visibile sulla lista di server fintanto che `Private = true`. *Se* vuoi rendere visibile su tale lista il tuo server, metti **`Private = false`**.
|
||||
|
||||
### 5. Verifica di corretto funzionamento
|
||||
|
||||
Avvia nuovamente il server e guarda se mostra altri messaggi con l'etichetta `[ERROR]`. La finestra deve rimanere aperta. A questo punto puoi avviare BeamMP utilizzando il BeamMP-Launcher e dovresti trovare il tuo server con il nome specificato nel file `ServerConfig.toml` nella lista dei server.
|
||||
|
||||
---
|
||||
|
||||
#### 5.1. Come aggiungere mod al tuo server
|
||||
|
||||
Sia le mod dei veicoli che una mappa mod, vanno inserite nella cartella `Resources/Client` all'interno della cartella del server.
|
||||
|
||||
#### 5.2. Mod generiche
|
||||
|
||||
Se ti interessa aggiungere mod di veicoli, basta aggiungerle alla cartella `Resources/Client`. Verranno scaricate automaticamente da chiunque si connetta al server.
|
||||
|
||||
#### 5.3. Mappe
|
||||
|
||||
Tutte le mappe ufficiali del gioco (quindi che non sono mod) non necessitano di essere installate, devi soltanto cambiare il valore del campo `Map` del file `ServerConfig.toml` con una di [queste stringhe](server-maintenance.md#tutti-i-nomi-delle-mappe-vanilla). Per mappe non ufficiali (mod), bisogna fare così:
|
||||
|
||||
1. Inserire il file `.zip` della mappa nella cartella `Resources/Client` all'interno della cartella del server.
|
||||
2. Apri il file `.zip` della mappa senza estrarlo e naviga alla cartella `/levels/`. In questa cartella ce ne dovrebbe essere un'altra con il nome della mappa, ad esempio `myawesomedriftmap2021`. Copia o ricordati questo nome *esattamente come è scritto su tale cartella*.
|
||||
3. Apri il file `ServerConfig.toml`. Nel campo `Map` dovresti vedere il valore `/levels/MAPNAME/info.json`, dove `MAPNAME` è molto probabilmente `gridmap_v2`. Cambia `MAPNAME` col nome della cartella del passo precedente, per questo esempio `myawesomedriftmap2021`. Salvo rare eccezioni, tutte le mappe necessitano di avere `/info.json` alla fine. Dovresti ottenere qualcosa di simile:
|
||||
|
||||
```TOML
|
||||
Map = '/levels/myawesomedriftmap2021/info.json'
|
||||
```
|
||||
|
||||
La mappa, come tutte le altre mod, verrà scaricata automaticamente da chiunque si connetta al server.
|
||||
|
||||
**Se la connessione non va a buon fine**, installa la mappa in BeamNG.drive (non multigiocatore) e caricala. Quando sei in gioco, apri la console con il tasto `ò` (se non utilizzi il layout Italiano è un tasto differente, guarda l'assegnazione di **Toggle System Console** in **Options > Controls > Bindings** nella sezione **General Debug**), ed esegui questo comando: `print(getMissionFilename())`. Otterrai così il corretto nome da utilizzare.
|
||||
|
||||
Il tuo server con la mappa moddata è pronto!
|
||||
|
||||
### 6. Come connettersi a un server
|
||||
|
||||
Come tu e altre persone possono connettersi al tuo server.
|
||||
|
||||
#### 6.a. Connettersi al proprio server
|
||||
|
||||
Se sei il proprietario del server devi connetterti tramite connessione diretta, per fare questo, clicca il pulsante **Direct Connect** a sinistra della lista dei server. Lascia i parametri predefiniti (IP `127.0.0.1` e porta `30814`) e clicca `Connect`. Se il tuo server è in esecuzione all'esterno della tua LAN devi prima [trovare il suo IP](https://whatismyipaddress.com/) e poi connetterti direttamente.
|
||||
|
||||
#### 6.b. Connessione di altre persone al proprio server privato
|
||||
|
||||
Avviare il server. Devi condividere l'indirizzo IP e la porta del tuo server alle persone che vuoi che si connettano. Presta attenzione a chi condividi il tuo indirizzo IP! Per connettersi a un server privato clicca il pulsante **Direct Connect** a sinistra della lista dei server, dopodiché inserisci l'indirizzo IP e la porta del server.
|
||||
|
||||
#### 6.c. Connessione di altre persone al proprio server pubblico
|
||||
|
||||
Per connettersi a un server pubblico basta andare sulla lista dei server, cercare il nome del server e cliccare `Connect`. Se non sei sicuro del nome del server, è lo stesso che hai messo nel file `ServerConfig.toml`.
|
||||
Assicurarsi che i filtri di ricerca siano disabilitati e che la ricerca per mappa sia impostata su "Any".
|
||||
Puoi controllare il [Keymaster](https://beammp.com/keymaster) per recuperare l'indirizzo IP.
|
||||
|
||||
Nel caso in cui si vede l'errore "Connection Failed!", controllare il launcher per dei codici come 10060, 10061, 10030.
|
||||
In questo caso siete sotto CGNAT o qualcosa è andato storto nel passo `1. Port forwarding` o `1.1 Firewall`.
|
||||
Per controllare se si è sotto CGNAT, confrontare l'indirizzo IP WAN dalla pagina del router con l'indirizzo IP visibile da [_whatsmyip.org_](https://www.whatsmyip.org/).
|
||||
IPv6 **non** è ancora supportato.
|
||||
|
||||
#### 6.e. **[POTREBBE NON FUNZIONARE]** Connessione di altre persone al proprio server (Hamachi)
|
||||
|
||||
Solo le persone nel tuo network di Hamachi possono connettersi al tuo server, non è necessario fare port forwarding in questo caso. Chi vuole connettersi, dopo essere entrato nel tuo network Hamachi, userà l'IP di Hamachi e la porta predefinita per eseguire una connessione diretta al tuo server. Per maggiori informazioni guarda la nostra guida per gli utenti [Hamachi](https://forum.beammp.com/t/tutorial-how-to-host-a-server-with-logmein-hamachi/52).
|
||||
|
||||
## Hai ancora dei problemi?
|
||||
|
||||
Apri un thread sul [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`.
|
||||
@@ -0,0 +1,257 @@
|
||||
# Installazione del server
|
||||
|
||||
## **Creazione del server**
|
||||
Basi per la creazione di un server
|
||||
|
||||
---
|
||||
### **Introduzione**
|
||||
|
||||
**Creare un server casalingo è gratuito, ma usare a un VPS è più facile e più sicuro**
|
||||
|
||||
I server sono una parte integrante di BeamMP, tutti i giocatori sono connessi tra loro attraverso il server. I server possono funzionare nativamente su Windows e Linux.
|
||||
|
||||
Puoi creare server privati, ai quali si possono connettere solo persone che inviti, o server pubblici, che saranno visibili sulla nostra ufficiale lista di server.
|
||||
|
||||
Per far funzionare correttamente un server è necessario seguire alcuni passi! È abbastanza semplice, ma se hai dei problemi, chiedi pure sul nostro [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`. Fai anche riferimento alla sezione di [Manutenzione Server](server-maintenance.md) per ulteriori informazioni.
|
||||
|
||||
Assicurati di aver letto e compreso la [LICENZA](https://raw.githubusercontent.com/BeamMP/BeamMP-Server/master/LICENSE) del server prima dell'uso.
|
||||
|
||||
Nota: *Il server supporta esclusivamente indirizzi IPv4. Se non sai che tipo di indirizzo usi, visita il sito* [*whatsmyip.org*](https://www.whatsmyip.org/) *- se l'indirizzo contiene* `_:_` *due punti, è di tipo **IPv6**. In tal caso devi investigare più a fondo e capire se hai a disposizione anche un indirizzo IPv4. Per far ciò puoi telefonare al tuo ISP chiedendo informazioni a riguardo, o chiedi a qualcuno che se ne intende che conosci. Il supporto per gli indirizzi IPv6 è in programma.*
|
||||
|
||||
## Configurare il server
|
||||
|
||||
La configurazione consiste di pochi passi che sono obbligatori da seguire.
|
||||
|
||||
### 1. Port forwarding
|
||||
|
||||
*Se stai utilizzando un VPS (Virtual Private Server) o un Rootserver, puoi generalmente saltare questo passo. Se non sei sicuro di cosa sia un VPS o Rootserver, non lo stai usando.*
|
||||
|
||||
Questo passo è necessario se vuoi che qualcuno all'esterno della tua casa ("all'esterno del tuo network locale o LAN") possa accedere al server.
|
||||
|
||||
####
|
||||
::: danger ":material-scale-balance: LIMITAZIONE DI RESPONSABILITA':"
|
||||
|
||||
**Port forward è rischioso**
|
||||
|
||||
Facendo il port forwarding sei a conoscenza dei rischi legati ad aprire le porte del tuo network di casa al pubblico e di conseguenza sollevi BeamMP da ogni responsabilità di danni che potrebbero succedere a te o al tuo ambiente domestico.
|
||||
|
||||
Non ci assumiamo alcuna responsabilità per i contenuti presenti su pagine esterne dei servizi presentati.
|
||||
|
||||
È consigliato affidarsi a uno dei nostri partner per l'hosting del server!
|
||||
|
||||
#### Servizi a pagamento:
|
||||
|
||||
* [Horizon Hosting](https://hrzn.link/beammp)
|
||||
* [Snakecraft Hosting](https://schost.us/beammp-plans)
|
||||
* [Connect Hosting](https://connecthosting.net/beammp)
|
||||
* [Assetto Hosting](https://assettohosting.com/en/games/beamng)
|
||||
* [WinHeberg](https://winheberg.fr/offres/gaming/beammp?lang=en)
|
||||
* [Zap Hosting](https://zap-hosting.com/en/beammp-server-hosting/)
|
||||
* [HostHavoc](https://hosthavoc.com/)
|
||||
* [PedalHost](https://pedal.host/)
|
||||
|
||||
*NOTA: se se sceglie di acquistare il server da uno dei partner, il passo di Port Forwarding è superfluo.*
|
||||
|
||||
Per effettuare il port forwarding, affidarsi [a questa guida esterna](https://www.aranzulla.it/come-aprire-le-porte-del-router-31808.html).
|
||||
|
||||
#### 1.1 Firewall
|
||||
|
||||
A seconda della tua configurazione, potresti dover aggiungere BeamMP-Server alle regole del tuo firewall. Questo è il caso di Windows (spegnere il firewall di solito **non** funziona) e su molti server Linux pre-configurati.
|
||||
|
||||
Qui, come nel caso del port forwarding, devi permettere il traffico **sia in entrata sia in uscita** e sia **TCP** sia **UDP** di BeamMP-Server attraverso il firewall. Se invece il tuo firewall richiede una porta, usa la stessa utilizzata nel passo precedente ("1. Port forwarding").
|
||||
|
||||
Se hai dei problemi, chiedi pure sul nostro [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`.
|
||||
|
||||
### 2. Ottenere una chiave di autenticazione
|
||||
|
||||
La chiave di autenticazione, spesso chiamata "AuthKey", è necessaria per creare un server **pubblico**, ma è **consigliato** usarla anche per i server privati.
|
||||
|
||||
Ti servirà un account [Discord](https://discord.com) per questo passo. Discord è necessario per evitare problemi di spam.
|
||||
|
||||
#### 2.1. Accedere alla pagina delle chiavi
|
||||
|
||||
Fai il login con Discord al [Keymaster](https://beammp.com/keymaster).
|
||||
Dalla homepage del Keymaster, clicca su "Keys" a sinistra dello schermo:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
#### 2.2. Creare una chiave
|
||||
|
||||
Per creare una chiave clicca il "+" verde presente in alto a destra.
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
#### 2.3. Compilare i dati per la chiave
|
||||
|
||||
Inserisci il nome del server (questo è solo il nome per la chiave, non è il nome vero e proprio del server), poi clicca "Create", ad esempio:
|
||||
|
||||
<figure class="image image_resized" style="width:44.84%;" markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
Il risultato dovrebbe essere simile a questo:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
**NON CONDIVIDERE MAI QUESTA CHIAVE. TRATTALA COME UNA PASSWORD**
|
||||
|
||||
Hai un numero limitato di chiavi. Puoi utilizzare una chiave su un server per volta, quindi non puoi far partire due server con la stessa chiave nello stesso momento.
|
||||
|
||||
#### 2.4. Copiare la chiave
|
||||
|
||||
Copia il testo del campo "key", in questo esempio è `3173a2e-6az0-4542-a3p0-ddqq5ff95558` e tienilo pronto per il passo successivo. Puoi fare questo cliccando l'icona a destra della chiave:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
### 3. Installazione
|
||||
|
||||
Il BeamMP-Server è disponibile per Windows e Linux. Le prossime due sezioni sono dedicate all'installazione su Windows e Linux rispettivamente.
|
||||
|
||||
#### 3.a Installazione su Windows
|
||||
|
||||
Per l'installazione su Linux, salta alla sezione succesiva.
|
||||
|
||||
Ricordati di fare il port forwarding, altrimenti il tuo server non sarà raggiungibile al pubblico!
|
||||
|
||||
1. Assicurati di aver installato i [Visual C++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe), necessari per eseguire il server.
|
||||
2. Scarica l'eseguibile del server da [beammp.com](https://www.beammp.com/). Dovresti trovarti con un file chiamato `BeamMP-Server.exe`.
|
||||
3. Una volta scaricato, crea una cartella dove desideri e sposta al suo interno `BeamMP-Server.exe`. Qui è dove il server risiederà.
|
||||
4. Avvia il server cliccandoci due volte. Questo genererà tutti i files necessari e quando vedi del testo sul terminale, puoi chiuderlo. Dovresti vedere questo file chiamato `ServerConfig.toml` nella stessa cartella di `BeamMP-Server.exe`.
|
||||
5. (opzionale) Per accedere velocemente al server, crea un collegamento al desktop **cliccando col tasto destro** su `BeamMP-Server.exe` > **Invia a** > **Desktop (crea collegamento)**.
|
||||
|
||||
Passare ora al punto "4. Configurazione".
|
||||
|
||||
#### 3.b Installazione su Linux
|
||||
|
||||
##### Utilizzando la build precompilata (consigliato)
|
||||
|
||||
Questo passo è valido per tutte le distribuzioni Linux per cui offriamo i files binari [qui](https://github.com/BeamMP/BeamMP-Server/releases/latest). Se usi una distribuzione o architettura differente, salta al passo "Compilazione file sorgente".
|
||||
|
||||
1. Assicurati di avere installato tutte le dipendenze che sono elencate [qui](https://github.com/BeamMP/BeamMP-Server#runtime-dependencies).
|
||||
2. Vai su [beammp.com](https://www.beammp.com/) e clicca il pulsante "Download server", sarai reindirizzato alla pagina Github delle release del server.
|
||||
3. Scarica la versione corretta per la tua distribuzione. Per semplicità sarà chiamata `BeamMP-Server-xxx` durante la guida, dove `xxx` è la versione per la distribuzione che stai usando.
|
||||
4. Una volta scaricato, crea una cartella dove desideri e sposta al suo interno `BeamMP-Server-xxx`. Qui è dove il server risiederà.
|
||||
5. Apri un terminale, naviga alla cartella dove si trova `BeamMP-Server-xxx` e incolla il comando `chmod +x BeamMP-Server-xxx`. Questo farà in modo che si abbiano i permessi per eseguire il server.
|
||||
6. Avvia il server con il comando `./BeamMP-Server-xxx`. Questo genererà tutti i files necessari e quando vedi del testo sul terminale, puoi chiuderlo. Dovresti vedere questo file chiamato `ServerConfig.toml` nella stessa cartella di `BeamMP-Server-xxx`.
|
||||
7. (opzionale) È consigliato creare un utente chiamato `beammpserver` (o simile), siccome **non** raccomandiamo di eseguire il server come root, sudo o con il proprio utente personale. Dovresti poi rendere possibile l'esecuzione del server solo da questo utente.
|
||||
|
||||
Passare ora al punto "4. Configurazione".
|
||||
|
||||
##### Compilazione file sorgente
|
||||
|
||||
È molto probabile, ma non è stato ufficialmente provato, che BeamMP-Server per Linux funzioni su distribuzioni differenti da quelle per cui offriamo i files binari [qui](https://github.com/BeamMP/BeamMP-Server/releases/latest). Se vuoi compilare i codice sorgente puoi farlo, scaricando il codice dal nostro [GitHub](https://github.com/BeamMP/BeamMP-Server), una guida si può trovare [qui](https://github.com/BeamMP/BeamMP-Server#build-instructions).
|
||||
|
||||
Infine ricordati di eseguire il server con il comando `./BeamMP-Server-xxx`, dopodiché vai al passo successivo.
|
||||
|
||||
### 4. Configurazione
|
||||
|
||||
Dopo che il server è stato avviato almeno una volta, dovrebbe aver creato diversi files e mostrato un paio di errori; questo perché manca ancora qualcosa. La tua cartella dovrebbe contenere questi files:
|
||||
|
||||
<figure markdown>
|
||||
|
||||
</figure>
|
||||
|
||||
Potrebbero chiamarsi `ServerConfig`, `Server` e `BeamMP-Server` senza estensioni, ma è corretto anche questo!
|
||||
|
||||
Apri `ServerConfig.toml` con un editor di testo come `Blocco note`. Per fare ciò **click col tasto destro** > **Apri con** > **Blocco note** o un qualsiasi altro editor di testo.
|
||||
|
||||
Dovresti vedere qualcosa di simile a questo:
|
||||
|
||||
```TOML
|
||||
[General]
|
||||
AuthKey = ''
|
||||
Debug = false
|
||||
Description = 'BeamMP Default Description'
|
||||
Map = '/levels/gridmap_v2/info.json'
|
||||
MaxCars = 1
|
||||
MaxPlayers = 10
|
||||
Name = 'BeamMP Server'
|
||||
Port = 30814
|
||||
Private = false
|
||||
ResourceFolder = 'Resources'
|
||||
```
|
||||
|
||||
Questo è il tuo file di configurazione. Utilizza un formato chiamato TOML. Fai anche riferimento alla sezione di [Manutenzione Server](server-maintenance.md) per maggiori informazioni.
|
||||
|
||||
Per ora ci interessa soltanto il campo `AuthKey`. Incolla tra le virgolette `''` la chiave ottenuta nel passo "2. Ottenere una chiave di autenticazione".
|
||||
|
||||
Per questo esempio, dovrà essere così:
|
||||
```TOML
|
||||
AuthKey = '3173a2e-6az0-4542-a3p0-ddqq5ff95558'
|
||||
```
|
||||
Dai anche un nome al tuo server tramite il campo `Name`. Puoi utilizzare colori e altri tipi di formattazione seguendo le indicazioni di [questa sezione](server-maintenance.md#personalizza-laspetto-del-nome-del-tuo-server) della pagina di manutenzione del server.
|
||||
|
||||
Se hai scelto una **porta** differente da **30814** inseriscila al posto di quella predefinita in `Port`.
|
||||
|
||||
**IMPORTANTE:** Il tuo server **non** sarà visibile sulla lista di server fintanto che `Private = true`. *Se* vuoi rendere visibile su tale lista il tuo server, metti **`Private = false`**.
|
||||
|
||||
### 5. Verifica di corretto funzionamento
|
||||
|
||||
Avvia nuovamente il server e guarda se mostra altri messaggi con l'etichetta `[ERROR]`. La finestra deve rimanere aperta. A questo punto puoi avviare BeamMP utilizzando il BeamMP-Launcher e dovresti trovare il tuo server con il nome specificato nel file `ServerConfig.toml` nella lista dei server.
|
||||
|
||||
---
|
||||
|
||||
#### 5.1. Come aggiungere mod al tuo server
|
||||
|
||||
Sia le mod dei veicoli che una mappa mod, vanno inserite nella cartella `Resources/Client` all'interno della cartella del server.
|
||||
|
||||
#### 5.2. Mod generiche
|
||||
|
||||
Se ti interessa aggiungere mod di veicoli, basta aggiungerle alla cartella `Resources/Client`. Verranno scaricate automaticamente da chiunque si connetta al server.
|
||||
|
||||
#### 5.3. Mappe
|
||||
|
||||
Tutte le mappe ufficiali del gioco (quindi che non sono mod) non necessitano di essere installate, devi soltanto cambiare il valore del campo `Map` del file `ServerConfig.toml` con una di [queste stringhe](server-maintenance.md#tutti-i-nomi-delle-mappe-vanilla). Per mappe non ufficiali (mod), bisogna fare così:
|
||||
|
||||
1. Inserire il file `.zip` della mappa nella cartella `Resources/Client` all'interno della cartella del server.
|
||||
2. Apri il file `.zip` della mappa senza estrarlo e naviga alla cartella `/levels/`. In questa cartella ce ne dovrebbe essere un'altra con il nome della mappa, ad esempio `myawesomedriftmap2021`. Copia o ricordati questo nome *esattamente come è scritto su tale cartella*.
|
||||
3. Apri il file `ServerConfig.toml`. Nel campo `Map` dovresti vedere il valore `/levels/MAPNAME/info.json`, dove `MAPNAME` è molto probabilmente `gridmap_v2`. Cambia `MAPNAME` col nome della cartella del passo precedente, per questo esempio `myawesomedriftmap2021`. Salvo rare eccezioni, tutte le mappe necessitano di avere `/info.json` alla fine. Dovresti ottenere qualcosa di simile:
|
||||
|
||||
```TOML
|
||||
Map = '/levels/myawesomedriftmap2021/info.json'
|
||||
```
|
||||
|
||||
La mappa, come tutte le altre mod, verrà scaricata automaticamente da chiunque si connetta al server.
|
||||
|
||||
**Se la connessione non va a buon fine**, installa la mappa in BeamNG.drive (non multigiocatore) e caricala. Quando sei in gioco, apri la console con il tasto `ò` (se non utilizzi il layout Italiano è un tasto differente, guarda l'assegnazione di **Toggle System Console** in **Options > Controls > Bindings** nella sezione **General Debug**), ed esegui questo comando: `print(getMissionFilename())`. Otterrai così il corretto nome da utilizzare.
|
||||
|
||||
Il tuo server con la mappa moddata è pronto!
|
||||
|
||||
### 6. Come connettersi a un server
|
||||
|
||||
Come tu e altre persone possono connettersi al tuo server.
|
||||
|
||||
#### 6.a. Connettersi al proprio server
|
||||
|
||||
Se sei il proprietario del server devi connetterti tramite connessione diretta, per fare questo, clicca il pulsante **Direct Connect** a sinistra della lista dei server. Lascia i parametri predefiniti (IP `127.0.0.1` e porta `30814`) e clicca `Connect`. Se il tuo server è in esecuzione all'esterno della tua LAN devi prima [trovare il suo IP](https://whatismyipaddress.com/) e poi connetterti direttamente.
|
||||
|
||||
#### 6.b. Connessione di altre persone al proprio server privato
|
||||
|
||||
Avviare il server. Devi condividere l'indirizzo IP e la porta del tuo server alle persone che vuoi che si connettano. Presta attenzione a chi condividi il tuo indirizzo IP! Per connettersi a un server privato clicca il pulsante **Direct Connect** a sinistra della lista dei server, dopodiché inserisci l'indirizzo IP e la porta del server.
|
||||
|
||||
#### 6.c. Connessione di altre persone al proprio server pubblico
|
||||
|
||||
Per connettersi a un server pubblico basta andare sulla lista dei server, cercare il nome del server e cliccare `Connect`. Se non sei sicuro del nome del server, è lo stesso che hai messo nel file `ServerConfig.toml`.
|
||||
Assicurarsi che i filtri di ricerca siano disabilitati e che la ricerca per mappa sia impostata su "Any".
|
||||
Puoi controllare il [Keymaster](https://beammp.com/keymaster) per recuperare l'indirizzo IP.
|
||||
|
||||
Nel caso in cui si vede l'errore "Connection Failed!", controllare il launcher per dei codici come 10060, 10061, 10030.
|
||||
In questo caso siete sotto CGNAT o qualcosa è andato storto nel passo `1. Port forwarding` o `1.1 Firewall`.
|
||||
Per controllare se si è sotto CGNAT, confrontare l'indirizzo IP WAN dalla pagina del router con l'indirizzo IP visibile da [_whatsmyip.org_](https://www.whatsmyip.org/).
|
||||
IPv6 **non** è ancora supportato.
|
||||
|
||||
#### 6.e. **[POTREBBE NON FUNZIONARE]** Connessione di altre persone al proprio server (Hamachi)
|
||||
|
||||
Solo le persone nel tuo network di Hamachi possono connettersi al tuo server, non è necessario fare port forwarding in questo caso. Chi vuole connettersi, dopo essere entrato nel tuo network Hamachi, userà l'IP di Hamachi e la porta predefinita per eseguire una connessione diretta al tuo server. Per maggiori informazioni guarda la nostra guida per gli utenti [Hamachi](https://forum.beammp.com/t/tutorial-how-to-host-a-server-with-logmein-hamachi/52).
|
||||
|
||||
## Hai ancora dei problemi?
|
||||
|
||||
Apri un thread sul [Forum](https://forum.beammp.com) o sul nostro [server Discord](https://discord.gg/beammp) nel canale `#support`.
|
||||
@@ -0,0 +1,227 @@
|
||||
# Manutenzione del server
|
||||
|
||||
Guide e suggerimenti per come configurare e mantenere al meglio il Server BeamMP.
|
||||
|
||||
## Come installare
|
||||
|
||||
Per delle istruzioni dettagliate, per favore guarda [la nostra guida](create-a-server.md).
|
||||
|
||||
## Il file ServerConfig
|
||||
|
||||
Il file per la configurazione del server, chiamato `ServerConfig.toml`, è in [formato TOML](https://toml.io/en/).
|
||||
|
||||
*NOTA*: Il *vecchio* file di configurazione chiamato `Server.cfg`, non è più utilizzato e il server ti avviserà nel caso sia ancora presente. I due formati di configurazione **non** sono compatibili tra loro.
|
||||
|
||||
Il file ha una sezione di default chiamata `[General]`, che contiene i seguenti valori:
|
||||
|
||||
| Chiave | Tipo di valore | Descrizione |
|
||||
|-------------|----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| AuthKey | Formato della AuthKey `xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` dove le x sono caratteri alfanumerici (numeri e lettere) | Usato per identificare il tuo server nel backend. Dovresti averne una avendo seguito la guida di installazione del server. |
|
||||
| Debug | true /false | Quando è abilitato (true) mostrerà diversi messaggi in più nei log e fornirà più informazioni. Abilita questo valore se incontri dei problemi. Abilitare questo valore farà aumentare la dimensione del file di log. |
|
||||
| Private | true/false | Quando è abilitato (true) il tuo server non sarà visibile nella lista pubblica dei server. Le persone con l'IP e la porta del server potranno però connettersi. |
|
||||
| Description | Qualunque "testo" | La descrizione del server sarà visibile a tutti (se il server è pubblico). Puoi usare caratteri speciali per formattare il testo con diversi colori e stili. |
|
||||
| Name | Qualunque "testo" | Il nome / titolo del tuo server che apparirà nella lista dei server. Puoi usare caratteri speciali per formattare il testo con diversi colori e stili. |
|
||||
| Map | Una posizione valida della mappa, come `/levels/gridmap_v2/info.json` | La mappa del tuo server. Può essere una delle mappe predefinite del gioco (una lista di tali mappe è presente qui sotto) o come una mod del server. |
|
||||
| MaxCars | Qualunque numero ≥ 1 | Il numero massimo di veicoli per giocatore. Ulteriori veicoli che un giocatore proverà a caricare saranno rimossi immediatamente. |
|
||||
| Port | 1024-65535 | La porta sulla quale il server sarà raggiungibile. Un giocatore che volesse connettersi direttamente al tuo server necessiterà del tuo IP e di questa porta. |
|
||||
|
||||
Altre sezioni possono e devono essere usate dai plugin del server (la API Lua è in arrivo), così: `[MyMod]`.
|
||||
|
||||
La AuthKey **DEVE** essere impostata da te. Di base sarà un valore vuoto che dovrà essere riempito con con la tua AuthKey ottenuta seguendo la guida di installazione. Non condividere questa chiave con nessuno e negli screenshot offuscala.
|
||||
|
||||
### Tutti i nomi delle mappe vanilla
|
||||
|
||||
Di seguito ci sono tutte le mappe vanilla:
|
||||
|
||||
- /levels/gridmap_v2/info.json
|
||||
- /levels/johnson_valley/info.json
|
||||
- /levels/automation_test_track/info.json
|
||||
- /levels/east_coast_usa/info.json
|
||||
- /levels/hirochi_raceway/info.json
|
||||
- /levels/italy/info.json
|
||||
- /levels/jungle_rock_island/info.json
|
||||
- /levels/industrial/info.json
|
||||
- /levels/small_island/info.json
|
||||
- /levels/smallgrid/info.json
|
||||
- /levels/utah/info.json
|
||||
- /levels/west_coast_usa/info.json
|
||||
- /levels/driver_training/info.json
|
||||
- /levels/derby/info.json
|
||||
|
||||
### Personalizza l'aspetto del nome del tuo server
|
||||
|
||||
Puoi usare questi simboli prima del tuo testo per applicarci un effetto:
|
||||
|
||||
| Valore | Descrizione |
|
||||
|:------:|----------------------------------|
|
||||
| `^r` | Reset |
|
||||
| `^p` | A capo (solo per le descrizioni) |
|
||||
| `^n` | Sottolineato |
|
||||
| `^l` | Grassetto |
|
||||
| `^m` | Barrato |
|
||||
| `^o` | Corsivo (italico) |
|
||||
| `^0` | Nero |
|
||||
| `^1` | Blu |
|
||||
| `^2` | Verde |
|
||||
| `^3` | Turchese |
|
||||
| `^4` | Rosso |
|
||||
| `^5` | Rosa |
|
||||
| `^6` | Arancione |
|
||||
| `^7` | Grigio |
|
||||
| `^8` | Grigio scuro |
|
||||
| `^9` | Viola chiaro |
|
||||
| `^a` | Verde chiaro |
|
||||
| `^b` | Azzurro |
|
||||
| `^c` | Arancione scuro |
|
||||
| `^d` | Rosa chiaro |
|
||||
| `^e` | Giallo |
|
||||
| `^f` | Bianco |
|
||||
|
||||
### Personalizza i tag del server
|
||||
|
||||
Le etichette del server possono aiutare le persone a filtrare la ricerca per un tipo specifico di server. Il tuo file serverConfig.toml genererà in automatico l'etichetta `Tags = "Freeroam"`.
|
||||
|
||||
Puoi aggiungere ulteriori etichette separandole con una virgola `Tags = "Events,Offroad,lang:english"`, non c'è differenza tra maiuscole o minuscole.
|
||||
|
||||
Puoi scegliere tra le seguenti etichette:
|
||||
|
||||
- Età/Contenuto:
|
||||
- `Mature/18+`
|
||||
|
||||
- Tipo di gameplay:
|
||||
- `Freeroam`
|
||||
- `Roleplay`
|
||||
- `Economy`
|
||||
- `Traffic`
|
||||
|
||||
- Categorie di corse:
|
||||
- `Racing`
|
||||
- `Racing:NASCAR`
|
||||
- `Racing:Track`
|
||||
- `Racing:Drag`
|
||||
- `Racing:Rally`
|
||||
- `Touge`
|
||||
|
||||
- Fuori strada e sfide:
|
||||
- `Offroad`
|
||||
- `Crawling`
|
||||
- `Dakar`
|
||||
- `Challenge`
|
||||
|
||||
- Demolition derby:
|
||||
- `Derby`
|
||||
- `Arena`
|
||||
|
||||
- Condizioni meteo e orario:
|
||||
- `Snow/Ice`
|
||||
- `Rain`
|
||||
- `Night`
|
||||
- `Weather`
|
||||
|
||||
- Modalità di gioco:
|
||||
- `Gamemode`
|
||||
- `Gamemode:Racing`
|
||||
- `Gamemode:Rally`
|
||||
- `Gamemode:Drag`
|
||||
- `Gamemode:Derby`
|
||||
- `Gamemode:Infection`
|
||||
- `Gamemode:Cops-Robbers`
|
||||
- `Gamemode:Delivery`
|
||||
- `Gamemode:Sumo`
|
||||
|
||||
- Comunità ed eventi:
|
||||
- `Scenarios`
|
||||
- `Events`
|
||||
- `Leaderboard`
|
||||
|
||||
- Mod:
|
||||
- `Modded`
|
||||
- `Mod:BeamPaint`
|
||||
- `Mod:BeamJoy`
|
||||
- `Mod:CEI`
|
||||
|
||||
- Lingua:
|
||||
- `Lang:English`
|
||||
- `Lang:Russian`
|
||||
- `Lang:French`
|
||||
- `Lang:Spanish`
|
||||
- `Lang:Portuguese`
|
||||
- `Lang:German`
|
||||
- `Lang:Polish`
|
||||
- `Lang:Arabic`
|
||||
|
||||
- Altro:
|
||||
- `Vanilla`
|
||||
- `Moderated`
|
||||
|
||||
|
||||
Se manca qualche etichetta da questa lista, siete pregati di creare una richiesta per aggiungerla [qui](https://forum.beammp.com/t/introducing-server-tags/1320081).
|
||||
|
||||
## Il file Server.log
|
||||
|
||||
Questo file è generato automaticamente quando il server è avviato. Contiene tutti i messaggi visualizzati nella console del server. È buona norma allegare questo file nel caso chiedessi aiuto al nostro staff di supporto; in questo file non è mai presente la tua AuthKey quindi puoi inviarlo senza alcuna modifica.
|
||||
|
||||
Il formato dei messaggi è spiegato di seguito:
|
||||
|
||||
```
|
||||
[$DATA $ORA] $CONTESTO [$LIVELLO_DI_LOG] $MESSAGGIO
|
||||
```
|
||||
|
||||
Dove:
|
||||
|
||||
- `$DATA` è la data del messaggio, per esempio 21/07/2021
|
||||
- `$ORA` è l'ora del messaggio, per esempio 11:05:23
|
||||
- `$CONTESTO` (visibile soltanto se la variabile Debug è abilitata) è il contesto del messaggio che può essere:
|
||||
- `(ID giocatore) “Nome Giocatore”`, dove l'ID del giocatore è utile per la moderazione
|
||||
- Un nome corto come “HeartbeatThread”
|
||||
- `$LIVELLO_DI_LOG` è il livello di importanza del messaggio:
|
||||
- `DEBUG`: Visibile solo se la variabile Debug è abilitata, importante solo per gli sviluppatori
|
||||
- `INFO`: Informazioni generali
|
||||
- `LUA`: Messaggio da un plugin Lua
|
||||
- `WARN`: Descrive qualcosa che di solito non dovrebbe accadere
|
||||
- `ERROR`: Descrive qualcosa che è andato storto, o un imprevisto
|
||||
- `FATAL`: Descrive qualcosa che ha causato l'arresto del server
|
||||
- `$MESSAGGIO` il messaggio in se al quale devi prestare attenzione e capire. In alcuni casi il messaggio può essere criptico, ma in generale se il server funziona e non ci sono messaggi ERROR, non ci sono problemi.
|
||||
|
||||
## Aggiornare il server
|
||||
|
||||
### Perché aggiornare
|
||||
|
||||
Quando un aggiornamento è rilasciato, è sempre consigliato aggiornare il server. Di solito le nuove versioni portano risoluzioni di bug, maggiore stabilità e correzioni di sicurezza senza dimenticare nuove funzionalità.
|
||||
|
||||
Per rimanere aggiornato sulle nuove versioni, puoi seguire il canale "updates" sul nostro Discord, guardare sul nostro forum o guardare la [pagina delle release di GitHub](https://github.com/BeamMP/BeamMP-Server/releases).
|
||||
|
||||
### Come aggiornare
|
||||
|
||||
#### Se stai usando un fornitore di hosting partner
|
||||
|
||||
Se stai usando un fornitore di hosting partner, le seguenti istruzioni non funzioneranno. Si consiglia di attendere ulteriori dettagli dal proprio fornitore di hosting o di contattarlo per ricevere assistenza.
|
||||
|
||||
#### Gestire il server autonomamente
|
||||
|
||||
Il server è aggiornabile cambiando l'eseguibile vecchio del server con quello nuovo. Se non sai come farlo, di seguito troverai le istruzioni.
|
||||
|
||||
Se hai compilato i file sorgente, ri-compila di nuovo i file. Prima di ri-compilare i file esegui `git submodule update --init --recursive` in un terminale.
|
||||
|
||||
#### Su Windows
|
||||
|
||||
1. Assicurati di aver installato i [Visual C++ Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe), necessari per eseguire il server.
|
||||
2. Scarica l'eseguibile del server da [beammp.com](https://www.beammp.com/). Dovresti trovarti con un file chiamato `BeamMP-Server.exe`.
|
||||
3. Chiameremo il file appena scaricato "nuovo eseguibile".
|
||||
4. Vai nella cartella dove è presente il corrente `BeamMP-Server.exe` (normalmente la stessa cartella con `ServerConfig.toml`). Chiameremo questo eseguibile "vecchio eseguibile".
|
||||
5. Sposta il nuovo eseguibile nella cartella di quello vecchio sovrascrivendolo.
|
||||
|
||||
#### Su Linux
|
||||
|
||||
1. Vai su [beammp.com](https://www.beammp.com/) e clicca il pulsante "Download server", sarai reindirizzato alla pagina Github delle release del server.
|
||||
2. Scarica la versione corretta per la tua distribuzione. Per semplicità sarà chiamata `BeamMP-Server-xxx` durante la guida, dove `xxx` è la versione per la distribuzione che stai usando.
|
||||
3. Chiameremo il file appena scaricato "nuovo eseguibile".
|
||||
4. Vai nella cartella dove è presente il corrente `BeamMP-Server-xxx` (normalmente la stessa cartella con `ServerConfig.toml`). Chiameremo questo eseguibile "vecchio eseguibile".
|
||||
5. Sposta il nuovo eseguibile nella cartella di quello vecchio sovrascrivendolo.
|
||||
6. Apri un terminale, naviga alla cartella dove si trova `BeamMP-Server-xxx` e incolla il comando `chmod +x BeamMP-Server-xxx`. Questo farà in modo che si abbiano i permessi per eseguire il server.
|
||||
|
||||
### Aggiornamenti automatici
|
||||
|
||||
Il server non supporta (ancora) gli aggiornamenti automatici.
|
||||
|
||||
Puoi però vedere quale sia l'ultima versione disponibile tramite la API di GitHub, con una richiesta GET da `https://api.github.com/repos/BeamMP/BeamMP-Server/git/refs/tags`.
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
layout: home
|
||||
|
||||
hero:
|
||||
name: Documentazione BeamMP
|
||||
text: Tutto quello che devi sapere
|
||||
tagline: Guide complete per giocatori, proprietari di server e sviluppatori
|
||||
image:
|
||||
src: /assets/core/beammp_dark.png
|
||||
alt: BeamMP
|
||||
actions:
|
||||
- theme: brand
|
||||
text: Inizia
|
||||
link: /it/game/getting-started
|
||||
- theme: alt
|
||||
text: Visualizza su GitHub
|
||||
link: https://github.com/beammp/docs
|
||||
|
||||
features:
|
||||
- icon: 🎮
|
||||
title: Per i Giocatori
|
||||
details: Scopri come installare BeamMP, connettersi ai server e ottenere il massimo dalla tua esperienza multiplayer
|
||||
link: /it/game/getting-started
|
||||
- icon: 🖥️
|
||||
title: Per i Proprietari di Server
|
||||
details: Configura e gestisci il tuo server BeamMP con le nostre guide complete e risorse di risoluzione dei problemi
|
||||
link: /it/server/create-a-server
|
||||
- icon: 💻
|
||||
title: Per gli Sviluppatori
|
||||
details: Crea mod, risorse e app UI con documentazione API dettagliata ed esempi di codice
|
||||
link: /it/guides/index
|
||||
- icon: ❓
|
||||
title: Domande Frequenti
|
||||
details: Trova risposte rapide alle domande più frequenti su configurazione, risoluzione dei problemi e best practice
|
||||
link: /it/FAQ/player-faq
|
||||
- icon: 📋
|
||||
title: Regole della Comunità
|
||||
details: Scopri le nostre linee guida sulla comunità e come segnalare problemi o contestare decisioni
|
||||
link: /it/community/rules
|
||||
- icon: 🔗
|
||||
title: Comunità
|
||||
details: Unisciti al nostro Discord, seguici sui social media e connettiti con altri giocatori e sviluppatori BeamMP
|
||||
link: /it/community/index
|
||||
---
|
||||
|
||||
## Per i Proprietari di Server
|
||||
|
||||
Stai pensando di creare il tuo server BeamMP? La nostra guida completa [qui](../server/create-a-server.md) ti accompagnerà nel processo, assicurandoti di avere tutti gli strumenti e le conoscenze necessarie per configurare il tuo server in modo efficiente.
|
||||
|
||||
## Per gli Sviluppatori
|
||||
|
||||
Esplora tutti i dettagli sulla creazione di risorse per il server BeamMP nella nostra [Guida allo Sviluppo delle Risorse](../guides/mod-creation/server/getting-started.md).
|
||||
|
||||
Stiamo lavorando a entusiasmanti aggiornamenti, tra cui una nuova homepage progettata per migliorare la tua esperienza di navigazione. Resta sintonizzato per ulteriori novità! :slight_smile:
|
||||
Reference in new issue
Block a user