Added the most important things to the Italian localization

Added:
- Italian localization for: "create-a-server.md", "manual.md", "getting-started.md".
Fixed:
- "getting-started.md": updated some links, reorganized it to be more similar to "create-a-server.md".
- "create-a-server.md": updated some links;
This commit is contained in:
alex.ita 2023-12-17 16:37:00 +01:00
parent 551b3f6582
commit 5ca22dde3a
5 changed files with 278 additions and 20 deletions

View File

@ -5,26 +5,31 @@
BeamMP is only compatible with legitimate, Steam versions of the game. "Cracked" copies are not supported.
---
## **Windows Installation**
1. Go to our [Official Website](https://beammp.com/) and download the latest `BeamMP_Installer.zip` by clicking the green, "Download Client" button.
2. Open the `BeamMP_Installer.zip` archive.
## **Installation**
BeamMP is natively compatible only with Windows at the moment.
### **Windows Installation**
1. Go to [beammp.com](https://beammp.com/) and click the "Download client" button.
2. Extract the `BeamMP_Installer.zip` archive.
3. Launch `BeamMP_Installer.exe` and follow the instructions.
4. The BeamMP Launcher icon should appear on your desktop. If not, just search for “BeamMP” in the windows search bar. Afterwards you should see a little black window appear, shortly after BeamNG.drive should start. Remember to keep this console open while you are playing.
5. Once BeamNG launches, press “Play”. In the main menu you should see “Multiplayer” and from there you can play BeamMP.
6. You will be prompted with a login pop-up, you can either play as a guest (not all servers will allow guests), or create an account on our [Forum](https://forum.beammp.com) and then login to BeamMP with your credentials.
7. Select any server you like, and press “Connect”. Enjoy!
4. The BeamMP Launcher icon should appear on your desktop. If not, just search for “BeamMP” in the windows search bar.
5. Once the launcher has started, you should see a terminal window, shortly after BeamNG.drive should automatically start. **Do not** close the terminal window.
6. Once BeamNG launches, in the main menu, click the `Multiplayer` button to start multiplayer.
7. You will be prompted to login or play as a guest (not all servers will allow guests). You can create an account on our [forum](https://forum.beammp.com) and then login to BeamMP with the same credentials.
8. Select any server you like, and press `Connect`. Enjoy!
Just to note, as you are loading into a map with multiple vehicles spawned it might take longer than expected to join.
Note: _As you are loading into a map with multiple vehicles spawned it might take longer than expected to join._
---
## **Known Issues**
If you dont see the “Multiplayer” button. Make sure that the BeamMP mod is activated in the “Mod Manager” then try pressing CTRL + L.
It's also important that BeamMP is the **only** mod activated in the “Mod Manager” as otherwise this can cause issues.
If you need further help with installation, you are welcome to create a post on our [Forum](https://forum.beammp.com) or ask in the [Official Discord](https://discord.gg/beammp)
---
## **Linux Installation**
BeamMP should work with `wine`, but is not officially supported (yet).
BeamMP should work with `wine`, but is not officially supported (yet).
---
## **Known Issues**
- If you dont see the “Multiplayer” button. Make sure that the BeamMP mod is activated in the “Mod Manager” then try pressing CTRL + L.
- It's also important that BeamMP is the **only** mod activated in the “Mod Manager” as otherwise this can cause issues.
If you need further help with installation, you are welcome to create a post on our [forum](https://forum.beammp.com) or ask on our [Discord server](https://discord.gg/beammp).

View File

@ -12,7 +12,7 @@ Servers are an integral part of BeamMP; players are connected to each other thro
You can make private servers, which only people you invite can join, or public servers, which will show in our official server list.
Getting a server up and running is a process with a few steps! It's quite easy, but if you run into any issues, feel free to ask on our [Forum](https://forum.beammp.com) or on our [Discord server](https://discord.gg/beammp) in the `#server-support` channel. Also refer to the [Server Maintenance](https://wiki.beammp.com/en/home/server-maintenance) section for more info. 
Getting a server up and running is a process with a few steps! It's quite easy, but if you run into any issues, feel free to ask on our [Forum](https://forum.beammp.com) or on our [Discord server](https://discord.gg/beammp) in the `#support` channel. Also refer to the [Server Maintenance](https://wiki.beammp.com/en/home/server-maintenance) section for more info. 
Please make sure to read the [LICENSE](https://raw.githubusercontent.com/BeamMP/BeamMP-Server/master/LICENSE) of the server before use.
@ -32,7 +32,7 @@ This step is the same for almost every game's server, such as Minecraft Servers,
While the default **Port** you want to “forward” is **30814**, you can choose any other number >1024, but you need to note down what you picked if it's not 30814\. You need to forward both **TCP** and **UDP**. 
If you have issues, also feel free to ask on our [Forum](https://forum.beammp.com) or on our [Discord server](https://discord.gg/beammp) in the `#server-support` channel.
If you have issues, also feel free to ask on our [Forum](https://forum.beammp.com) or on our [Discord server](https://discord.gg/beammp) in the `#support` channel.
#### 1.1 Firewall

View File

@ -0,0 +1,33 @@
# Per iniziare
---
## **Prima di iniziare**
BeamMP è compatibile solo con versioni originali del gioco. Le versioni piratate non sono supportate.
---
## **Installazione**
BeamMP è nativamente compatibile solo con Windows al momento.
### **Installazione su Windows**
1. Vai su [beammp.com](https://beammp.com/) e clicca il pulsante "Download client".
2. Estrai la cartella `BeamMP_Installer.zip`.
3. Avvia `BeamMP_Installer.exe` e segui le istruzioni a schermo.
4. L'icona di `BeamMP-Launcher` dovrebbe apparire sul tuo desktop. Se questo non fosse il caso cerca `BeamMP` nella barra di ricerca di Windows, dopodiché clicca il l'icona per avviarlo.
5. Una volta avviato l'eseguibile vedrai un terminale e in seguito BeamNG si avvierà automaticamente. **Non** chiudere la finestra del terminale.
6. Raggiunto il menù principale del gioco, clicca sul pulsante `Multiplayer` per giocare in multigiocatore.
7. Prima di giocare, ti sarà richiesto di effettuare il login o di giocare come ospite (non tutti i server accettano giocatori ospiti). Puoi creare un account sul nostro [forum](https://forum.beammp.com) e poi usare le credenziali del forum per fare il login in gioco.
8. Seleziona un server che ti piace e premi `Connect`.
Nota: _Se ti connetti ad un server con molti giocatori potresti impiegare più tempo ad entrare in gioco._
### **Installazione su Linux**
BeamMP non è (ancora) ufficialmente supportato su Linux ma dovrebbe comunque funzionare tramite `wine`.
---
## **Problemi noti**
- Se il pulsante `Multiplayer` non è visibile, assicurarsi che la mod `multiplayerbeammp` sia l'unica attiva nel "Mod Manager" dopodiché premi `ctrl + L`.
- Assicurarsi che la mod `multiplayerbeammp` sia l'unica attiva nel "Mod Manager", altrimenti potrebbero sorgere diversi problemi.
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`.

View File

@ -0,0 +1,214 @@
# Installazione del server
## **Creazione del server**
Basi per la creazione di un server
---
### **Introduzione**
**Creare un server per BeamMP è facile e veloce!**
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](https://wiki.beammp.com/en/home/server-maintenance) 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.
Questo passo è praticamente il medesimo per tutti i server di gioco, come i server di Minecraft, quindi puoi trovare molte guide su internet riguardo all'argomento, anche per il tuo router in specifico. Una buona guida è [la seguente](https://www.aranzulla.it/come-aprire-le-porte-del-router-31808.html). Assicurati di aggiungere nelle regole di forwarding la porta **30814** sia in protocollo **TCP** sia in **UDP**.
La **porta** di default può essere cambiata con quella che desideri, basta che non sia già utilizzata da altri servizi e che il numero sia >1024. Ricordati o segnati quale porta hai scelto se non usi quella predefinita\. Il forwarding deve essere sempre fatto sia in protocollo **TCP** sia in **UDP**.
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`.
#### 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
Richiedi la tua chiave al [Keymaster](https://beammp.com/keymaster), clicca su "Keys" sulla sinistra (con il simbolo di una chiave) e poi clicca sul testo blu '_here_'.
<figure markdown>
![](/assets/content/keymaster1.png)
</figure>
#### 2.2
Inserisci il nome del server (questo è solo il nome per la chiave, non è il nome vero e proprio del server), ad esempio:
<figure class="image image_resized" style="width:44.84%;" markdown>
![](/assets/content//keymaster_key.png)
</figure>
Il risultato dovrebbe essere simile a questo:
<figure markdown>
![](/assets/content//keymaster3.png)
</figure>
Ignora il campo '_IP_'.
**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.3
Copia il testo del campo "key", in questo esempio è `3173a2e-6az0-4542-a3p0-ddqq5ff95558` e tienilo pronto per il passo successivo.
### 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 questi files chiamati `Server.log` e `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)**.
Procedi ora al passo "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 questi files chiamati `Server.log` e `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.
Procedi ora al passo "4\. Configurazione".
#### Compilazione file sorgente
BeamMP-Server per Linux può essere compilato in modo ufficiale su Debian, Ubuntu, altre distribuzioni derivate da Debian e ArchLinux. Altre distribuzioni non sono state provate, ma è molto probabile che funzionino lo stesso. 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>
![](/assets/content/after-running-once.png)
</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](https://wiki.beammp.com/en/home/server-maintenance) 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](https://wiki.beammp.com/en/home/server-maintenance#customize-the-look-of-your-server-name) 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.
---
## 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.
### Mod generiche
Se ti interessa aggiungere mod di veicoli, basta aggiungerle alla cartella `Resources/Client`. Verranno scaricate automaticamente da chiunque si connetta al server.
### 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](https://wiki.beammp.com/en/home/server-maintenance#all-vanilla-maps-names). 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!
## Come connettersi a un server
Come tu e altre persone possono connettersi al tuo server.
### 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.
### Connessione di altre persone al proprio server (Pubblico)
Chiunque può connettersi al tuo server fintanto che si sia fatto port forwarding (una buona guida è [la seguente](https://www.aranzulla.it/come-aprire-le-porte-del-router-31808.html)). 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`.
### Connessione di altre persone al proprio server (Privato)
Chiunque può connettersi al tuo server fintanto che si sia fatto port forwarding (una buona guida è [la seguente](https://www.aranzulla.it/come-aprire-le-porte-del-router-31808.html)). 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. Se non sei sicuro di quale sia il tuo IP, puoi verificarlo da [questo sito](https://whatismyipaddress.com/). Se non sei sicuro della porta, è la stessa che hai messo nel file `ServerConfig.toml`.
### 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).

6
docs/it/server/manual.md Normal file
View File

@ -0,0 +1,6 @@
# Manuale d'uso del server
Il nome del server è limitato a 250 caratteri.
La descrizione del server è limitata a 1000 caratteri.
La mappa è limitata a 100 caratteri.
I tag sono limitati a 100 caratteri.