-
Notifications
You must be signed in to change notification settings - Fork 62
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #6 from AlexITA1100/main
Updates FAQs
- Loading branch information
Showing
5 changed files
with
210 additions
and
24 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,49 @@ | ||
| # 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. | ||
| # Contesto | ||
|
|
||
| Il server è influenzato dallo stato di diversi parametri esterni: | ||
|
|
||
| - La cartella "Resources" | ||
| - L'ENV (il contesto del processo) | ||
| - Gli argomenti da linea di comando | ||
| - Il file `ServerConfig.toml` | ||
| - La cartella di lavoro | ||
|
|
||
| ## Cartella "Resources" | ||
|
|
||
| La cartella "Resources" è creata al primo avvio del server, insieme alle sottocartelle "Client" e "Server". | ||
| La cartella "Server" accetta altre cartelle al suo interno, ognuna contenente almeno un file `.lua`. Ciascuna delle cartelle nella cartella "Server" è considerato un "Plugin". I file `.lua` contenuti nel livello di cartelle più alto all'interno del plugin a seguito di una modifica sono ricaricati durante l'esecuzione. | ||
| La cartella "Client" accetta *solo* file `.zip` che sono caricati all'avvio del server e non mutano durante l'esecuzione. | ||
|
|
||
| ## ENV | ||
|
|
||
| Con la versione v3.2.0, il server BeamMP accetta varaibili di contesto, che **sovrascrivono** le impostazioni contenute nel file `ServerConfig.toml`. Tutte le variabili che esistono nella sezione "General" seguono la convenzione [PascalCase](https://it.wikipedia.org/wiki/Notazione_a_cammello), le variabili di contesto sono IN_MAIUSCOLO e con il prefisso `BEAMMP_`. Per esempio il campo `MaxPlayers` convertito IN_MAIUSCOLO diventa `MAX_PLAYERS` (si noti il `_` all'inizio di una nuova parola) e con il prefisso diventa `BEAMMP_MAX_PLAYERS`. Questa formattazione è seguita per tutte le impostazioni della sezione "General". Altri esempi di seguito: | ||
|
|
||
| - `AuthKey` -> `BEAMMP_AUTH_KEY` | ||
| - `Port` -> `BEAMMP_PORT` | ||
| - `Description` -> `BEAMMP_DESCRIPTION` | ||
| - ...ecc. | ||
|
|
||
| Qualsiasi variabile di contesto corrispondenti a un parametro di configurazione che è una stringa o un numero, deve essere una stringa, ad esempio `BEAMMP_NAME="Cool Server"`, `BEAMMP_NAME=Server1`, `BEAMMP_PORT=12345`. | ||
| Le variabili di contesto che corrispondono a un parametro di configurazione che è booleano (true/false, on/off) devono essere `true` o `1` (entrambi significano ON), o qualsiasi altro valore (significa OFF). | ||
|
|
||
| ## Argomenti da linea di comando | ||
|
|
||
| Avvia il server BeamMP con l'argomento `--help` per scoprirne di più. Ad esempio: `./BeamMP-Server --help`. | ||
|
|
||
| ## ServerConfig.toml | ||
|
|
||
| Questo file è generato al primo avvio. I commenti all'interno del file sono il modo migliore e più aggiornato per capire che cosa faccia ogni impostazione. | ||
|
|
||
| ## Cartella di lavoro | ||
|
|
||
| La cartella di lavoro del server, e non la posizione dell'eseguibile del server, è il fattore decisivo per la generazione di `ServerConfig.toml`, dei file di log e della cartella "Resources". | ||
|
|
||
| # Limitazioni | ||
|
|
||
| Le seguenti limitazioni sono imposte dal backend e riguardano il 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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,54 @@ | ||
| # F.A.Q. e problemi noti | ||
| Una lista di domande frequenti e bug noti. | ||
|
|
||
| --- | ||
| ## **Client** | ||
|
|
||
| --- | ||
| #### **Come si installa BeamMP?** | ||
|
|
||
| C'è una guida per installare BeamMP, la puoi trovare [qui](https://docs.beammp.com/it/game/getting-started/). | ||
|
|
||
| --- | ||
| #### **BeamMP funziona su versioni piratate del gioco?** | ||
|
|
||
| Le versioni piratate o non aggiornate di BeamNG.drive non sono supportate. Se vuoi usare BeamMP, acquista il gioco. | ||
|
|
||
| --- | ||
| #### **BeamMP funziona su Linux?** | ||
|
|
||
| Il client non è ufficialmente supportato su Linux, ma dovrebbe comunque funzionare tramite `wine` o utilizzando lo stesso prefisso del gioco tramite `proton`. | ||
|
|
||
| --- | ||
| #### **Perché il launcher è segnalato come un virus da Windows defender?** | ||
|
|
||
| Il launcher è segnalato come **falso positivo** perché non è stato firmato con delle licenze specifiche che, essendo molto costose, non sono state acquistate. | ||
| Non c'è alcun codice malevolo in BeamMP; tutto il codice per il server, launcher e il client Lua è disponibile sul nostro [GitHub](https://github.com/BeamMP). | ||
|
|
||
| --- | ||
| #### **Le prestazioni del gioco sono basse, cosa posso fare?** | ||
|
|
||
| Stiamo lavorando il più possibile per garantire prestazioni stabili a tutti. Se hai già abbassato le impostazioni grafiche, purtroppo non c'è molto che puoi fare se non giocare con un numero minore di persone. Il gioco è strettamente legato alla potenza e al numero di core della CPU, quindi con processori più vecchi (anche con quattro core) avrai difficoltà ad avere buone prestazioni con più di una manciata di giocatori. | ||
|
|
||
| --- | ||
| ## **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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,70 @@ | ||
| # 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). |