mirror of
https://github.com/BeamMP/Docs.git
synced 2026-07-23 23:30:32 +00:00
More work!!!
This commit is contained in:
Starystars67
@@ -0,0 +1,46 @@
|
||||
# Contribuire alla creazione di BeamMP Docs
|
||||
|
||||
BeamMP utilizza come tema [Material per MkDocs](https://squidfunk.github.io/mkdocs-material). Questo tema è per [MkDocs](https://www.mkdocs.org).
|
||||
La documentazione completa è disponibile ai rispettivi siti web.
|
||||
|
||||
## Per cominciare
|
||||
|
||||
Se vuoi aiutare contribuendo a questa documentazione puoi seguire uno dei due approcci qui sotto:
|
||||
|
||||
### 1. Modificare direttamente i file markdown
|
||||
|
||||
Modificare direttamente i file markdown è il metodo più veloce per correzioni grammaticali, ortografiche o per l'aggiunta di nuove parti di contenuto.
|
||||
Questo modo necessita di una conoscenza del linguaggio di Markdown, siccome devi sapere già come verrà visualizzata la tua modifica.
|
||||
|
||||
Se questo metodo fa per te, segui questi passi:
|
||||
|
||||
1. Clicca "Modifica" sulla pagina che desideri modificare.
|
||||
2. Fai una fork del progetto sul tuo account GitHub personale.
|
||||
3. Fai le modifiche che vuoi.
|
||||
4. Fai commit dei cambiamenti sulla tua fork.
|
||||
5. Apri una pull request sul nostro repo [qui](https://github.com/BeamMP/Docs).
|
||||
|
||||
Una volta creata la pull request, qualcuno del team di BeamMP la controllerà e potrà approvarla o richiedere delle modifiche.
|
||||
Nel caso fossero richieste delle correzioni, a seguito del loro completamento ri-controlleremo la pull request.
|
||||
La tua pull request, quando viene approvata, verrà unita tramite merge al repo e sarà automaticamente rilasciata al pubblico.
|
||||
|
||||
### 2. Modificare con l'anteprima live
|
||||
|
||||
La modifica della documentazione in questo modo è molto simile all'opzione 1, ma potrai vedere un'anteprima dei cambiamenti effettuati.
|
||||
|
||||
1. Clicca "Modifica" sulla pagina che desideri modificare.
|
||||
2. Fai una fork del progetto sul tuo account GitHub personale.
|
||||
3. Clona il progetto in locale.
|
||||
4. Prepara Material per MkDocs seguendo la loro guida [qui](https://squidfunk.github.io/mkdocs-material/getting-started/).
|
||||
5. Esegui `mkdocs serve` per avviare il server per visualizzare l'anteprima live da dove hai clonato la fork.
|
||||
6. Fai le modifiche che vuoi.
|
||||
7. Fai commit dei cambiamenti sulla tua fork.
|
||||
8. Apri una pull request sul nostro repo [qui](https://github.com/BeamMP/Docs).
|
||||
|
||||
|
||||
## Layout del progetto
|
||||
|
||||
mkdocs.yml # File di configurazione.
|
||||
docs/
|
||||
index.md # La homepage della documentazione.
|
||||
... # Altre pagine markdown, immagini e altri file.
|
||||
@@ -0,0 +1,43 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Riferimento per lo scripting lato client
|
||||
|
||||
BeamMP ti permette di creare i tuoi personali plugin da eseguire lato client. Abbiamo creato delle funzioni che ti permettono di comunicare con altre mod legate al multiplayer e ad altri giocatori tramite il server.
|
||||
|
||||
# Funzioni
|
||||
|
||||
Lista di funzioni disponibili per gli script:
|
||||
|
||||
| Funzione | Note |
|
||||
|-------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| `TriggerServerEvent("eventName", "data")` | Scatena un evento nel contesto Lua lato server, entrambi i parametri sono stringhe. |
|
||||
| `TriggerClientEvent("eventName", "data")` | Scatena un evento nel contesto Lua lato client, entrambi i parametri sono stringhe. Buono da usare per la comunicazione tra plugin diversi. |
|
||||
| `AddEventHandler("eventName", Function)` | Aggiunge il secondo parametro alla tabella che viene invocata quando viene ricevuto `eventName` (sia localmente sia dal server), `Function` riceverà un (1) parametro, una stringa contenente i dati dell'evento. |
|
||||
|
||||
# Esempi di codice
|
||||
|
||||
Per esempio si può analizzare la chat usando il suo evento evento `ChatMessageIncluded`:
|
||||
|
||||
```lua
|
||||
local function chatReceived(msg) -- Receive event with parameters
|
||||
print("chat received: "..msg)
|
||||
local i = string.find(s, ":") -- Find where our first ':' is, used to separate the sender and message
|
||||
if i == nil then
|
||||
print("error parsing message: separator could not be found!")
|
||||
return -- Could not find separator, cancel function
|
||||
end
|
||||
print("index of separator: "..tostring(i))
|
||||
local sender = string.sub(msg, 1, i-1) -- Substring our input to separate its 2 parts
|
||||
local message = string.sub(msg, i+1, -1) -- Do whatever you want to with the message
|
||||
print("sender: " .. sender)
|
||||
print("message: ".. message)
|
||||
end
|
||||
|
||||
AddEventHandler("ChatMessageReceived", chatReceived) -- Add our event handler to the list managed by BeamMP
|
||||
```
|
||||
@@ -0,0 +1,43 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Riferimento per lo scripting lato client
|
||||
|
||||
BeamMP ti permette di creare i tuoi personali plugin da eseguire lato client. Abbiamo creato delle funzioni che ti permettono di comunicare con altre mod legate al multiplayer e ad altri giocatori tramite il server.
|
||||
|
||||
# Funzioni
|
||||
|
||||
Lista di funzioni disponibili per gli script:
|
||||
|
||||
| Funzione | Note |
|
||||
|-------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||
| `TriggerServerEvent("eventName", "data")` | Scatena un evento nel contesto Lua lato server, entrambi i parametri sono stringhe. |
|
||||
| `TriggerClientEvent("eventName", "data")` | Scatena un evento nel contesto Lua lato client, entrambi i parametri sono stringhe. Buono da usare per la comunicazione tra plugin diversi. |
|
||||
| `AddEventHandler("eventName", Function)` | Aggiunge il secondo parametro alla tabella che viene invocata quando viene ricevuto `eventName` (sia localmente sia dal server), `Function` riceverà un (1) parametro, una stringa contenente i dati dell'evento. |
|
||||
|
||||
# Esempi di codice
|
||||
|
||||
Per esempio si può analizzare la chat usando il suo evento evento `ChatMessageIncluded`:
|
||||
|
||||
```lua
|
||||
local function chatReceived(msg) -- Receive event with parameters
|
||||
print("chat received: "..msg)
|
||||
local i = string.find(s, ":") -- Find where our first ':' is, used to separate the sender and message
|
||||
if i == nil then
|
||||
print("error parsing message: separator could not be found!")
|
||||
return -- Could not find separator, cancel function
|
||||
end
|
||||
print("index of separator: "..tostring(i))
|
||||
local sender = string.sub(msg, 1, i-1) -- Substring our input to separate its 2 parts
|
||||
local message = string.sub(msg, i+1, -1) -- Do whatever you want to with the message
|
||||
print("sender: " .. sender)
|
||||
print("message: ".. message)
|
||||
end
|
||||
|
||||
AddEventHandler("ChatMessageReceived", chatReceived) -- Add our event handler to the list managed by BeamMP
|
||||
```
|
||||
@@ -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,85 @@
|
||||
::: warning "Questo sito è in costruzione!"
|
||||
|
||||
Questo sito è attualmente in fase di lavorazione.
|
||||
|
||||
Pensate di poter aiutare? Per favore, fatelo cliccando sulla pagina con una matita a destra!
|
||||
|
||||
Questo può essere fatto anche su qualsiasi altra pagina.
|
||||
|
||||
# Per iniziare
|
||||
|
||||
Per iniziare a sviluppare per BeamMP avrai bisogno di almeno queste cose:
|
||||
|
||||
- BeamNG.drive, installato in locale
|
||||
- BeamMP, installato in locale; come minimo il launcher, anche il server se necessario
|
||||
- Git, installato in locale, e un account di GitHub.com
|
||||
- Un editor di codice, come VSCode o notepad++
|
||||
|
||||
---
|
||||
# Differenze tra mod, launcher e server
|
||||
|
||||
BeamMP è diviso in tre componenti principali:
|
||||
|
||||
- La mod è caricata da BeamNG, come qualsiasi altra mod per il gioco. La sua funzione principale è quella di stabilire una connessione in locale con il launcher e mostrare gli elementi di interfaccia utente per il multiplayer. È scritta principalmente in Lua, con parti in JavaScript, HTML e CSS per gli elementi di UI. Il suo repo è [https://github.com/BeamMP/BeamMP](https://github.com/BeamMP/BeamMP)
|
||||
- Il launcher stabilisce una connessione costante alla mod, quando necessario apre una connessione al server selezionato in gioco, infine si occupa del login del giocatore tramite il backend di BeamMP. È scritto principalmente in C++, viene precompilato da BeamMP e il suo repo è [https://github.com/BeamMP/BeamMP-Launcher](https://github.com/BeamMP/BeamMP-Launcher)
|
||||
- Il server stabilisce una connessione tra uno o più launcher, inoltre manda "heartbeat" al backend di BeamMP contenenti diverse informazioni tra cui l'IP, la porta, la versione, il numero di giocatori, ecc. Gestisce ed esegue plugin Lua lato server. È scritto in C++, viene precompilato da BeamMP per diversi sistemi operativi e architetture CPU, il suo repo è [https://github.com/BeamMP/BeamMP-Server](https://github.com/BeamMP/BeamMP-Server)
|
||||
|
||||
---
|
||||
# Creare un ambiente di sviluppo per lavorare sulla mod
|
||||
|
||||
## Usare una cartella unpacked per BeamNG
|
||||
|
||||
Per lavorare in modo efficiente alle mod in BeamNG è molto consigliato usare una cartella `unpacked`, invece di ricreare zip dopo ogni cambiamento.
|
||||
|
||||
Apri la cartella utente di BeamNG navigando a `%appdata%/Local/BeamNG.drive/0.xx/mods` dove `xx` è l'ultima versione di BeamNG.
|
||||
Crea una cartella chiamata `unpacked` all'interno della cartella `mods`.
|
||||
|
||||
Altre informazioni riguardo la cartella utente si possono qui [https://documentation.beamng.com/support/userfolder/](https://documentation.beamng.com/support/userfolder/)
|
||||
|
||||
## Abilitare la modalità sviluppatore per il launcher BeamMP
|
||||
|
||||
Per evitare che gli aggiornamenti automatici cancellino la tua git clone locale, bisogna disabilitarli usando `--no-download`.
|
||||
Se non vuoi che il launcher apra BeamNG e vuoi vedere stampe di debug, è consigliato usare `--dev`.
|
||||
|
||||
| Parametri | Note |
|
||||
|:--------------------------------------|:-------------------------------------------|
|
||||
| `--help` o `-h` | Stampa a video questa lista di parametri |
|
||||
| `--port <port>` o `-p` | Cambia la porta di ascolto da quella di default a `<port>`. Deve essere configurata anche in gioco |
|
||||
| `--verbose` o `-v` | Modalità verbosa, stampa messaggi di debug |
|
||||
| `--no-download` | Salta il download e l'installazione della mod Lua di BeamMP |
|
||||
| `--no-update` | Salta l'aggiornamento automatico del launcher (bisognerà aggiornare manualmente) |
|
||||
| `--no-launch` | Salta l'avvio automatico del gioco (bisognerà avviare il gioco manualmente) |
|
||||
| `--dev` | Modalità sviluppatore, equivalente a --verbose --no-download --no-launch --no-update |
|
||||
| `--game <args...>` o `-- <args...>` | Passa dei parametri al gioco |
|
||||
|
||||
## Clonare il repo di BeamMP nella cartella unpacked
|
||||
|
||||
Nonostante si possa copiare manualmente i file di BeamMP dal nostro repo di Github, è consigliato usare un sistema di source-control come git.
|
||||
Per prima cosa crea una fork di [https://github.com/BeamMP/BeamMP](https://github.com/BeamMP/BeamMP)
|
||||
|
||||
La cosa più efficiente sarebbe quella di clonare il repo direttamente nella cartella `unpacked`.
|
||||
|
||||
Per `git`, lanciare `git clone https://github.com/yourName/BeamMP` da una finestra PowerShell o CMD, avviata nella cartella `unpacked`.
|
||||
Controlla che nella cartella utente di BeamNG non ci sia alcuna cartella `multiplayer` in `mods` e che invece ci sia `unpacked/beammp`.
|
||||
|
||||
Ora puoi provare la modalità sviluppatore. Avvia il launcher BeamMP, avvia BeamNG manualmente, controlla che BeamMP sia l'unica mod attiva.
|
||||
Dovresti riuscire a giocare normalmente.
|
||||
|
||||
Usando un editor di codice, puoi aggiungere o cambiare codice direttamente dalla cartella `unpacked`.
|
||||
In seguito alle modifiche ricarica Lua in gioco premendo `Ctrl+L` (e `F5` se hai effettuato modifiche all'interfaccia utente).
|
||||
|
||||
Quando sei soddisfatto delle modifiche, puoi effettuare una commit tramite git. Guarda [il sito Git-SCM](https://git-scm.com/doc) per guide e documentazione sull'utilizzo di Git. Non appena hai effettuato commit e push (al tuo repo), puoi aprire una pull-request.
|
||||
|
||||
Chiedi pure nel canale #scripting nel nostro [Discord](https://discord.gg/beammp) se hai dei problemi.
|
||||
|
||||
---
|
||||
# Creare un server in locale
|
||||
|
||||
Mentre si lavora su BeamMP può essere d'aiuto l'utilizzo di un server in locale. Puoi seguire la [guida di installazione del server](../../server/create-a-server.md) saltando i primi due passi per quanto riguarda le connessioni locali.
|
||||
|
||||
Imposta il server come privato in `serverConfig.toml` e puoi usare una qualunque stringa come `AuthKey`.
|
||||
|
||||
---
|
||||
# Linee guida per contribuire
|
||||
|
||||
Per i dettagli riguardo la formattazione del codice, formato dei messaggi di commit, migliori pratiche per lo sviluppo, ecc. leggere il file `CONTRIBUTING.md` presente in ogni repo. Questo file contiene informazioni dettagliate su come contribuire. Il file `README.md` in ogni repo, di solito contiene anche dei passi per compilare il codice (per i progetti precompilati).
|
||||
@@ -0,0 +1,18 @@
|
||||
---
|
||||
title: Guides
|
||||
description: This set of pages provides some basic guides for BeamMP
|
||||
status: new
|
||||
---
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Guide sullo sviluppo per BeamMP
|
||||
|
||||
Questa pagina sarà l'introduzione per la creazione di contenuti sia lato server sia lato client.
|
||||
|
||||
Questa pagina deve ancora essere completata.
|
||||
@@ -0,0 +1,10 @@
|
||||
::: warning "Questo sito è in costruzione!"
|
||||
|
||||
Questo sito è attualmente in fase di lavorazione.
|
||||
|
||||
Pensate di poter aiutare? Per favore, fatelo cliccando sulla pagina con una matita a destra!
|
||||
|
||||
Questo può essere fatto anche su qualsiasi altra pagina.
|
||||
|
||||
# Per iniziare
|
||||
Questa pagina ti aiuterà a creare mod per BeamMP lato server.
|
||||
@@ -0,0 +1,9 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Introduzione allo sviluppo per BeamNG.drive
|
||||
@@ -0,0 +1,19 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Creazione di una mappa su BeamNG.drive
|
||||
|
||||
...
|
||||
|
||||
## Introduzione
|
||||
|
||||
...
|
||||
|
||||
## Primi passi
|
||||
|
||||
...
|
||||
@@ -0,0 +1,19 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Creazione di prop su BeamNG.drive
|
||||
|
||||
...
|
||||
|
||||
## Introduzione
|
||||
|
||||
...
|
||||
|
||||
## Primi passi
|
||||
|
||||
...
|
||||
@@ -0,0 +1,19 @@
|
||||
::: warning "Questo sito è ancora in costruzione"
|
||||
|
||||
Questo sito è in fase di lavorazione.
|
||||
|
||||
Pensi di poter aiutare? Puoi farlo cliccando sulla pagina con la matita in alto a destra!
|
||||
|
||||
Puoi contribuire a qualsiasi pagina.
|
||||
|
||||
# Creazione di un veicolo su BeamNG.drive
|
||||
|
||||
...
|
||||
|
||||
## Introduzione
|
||||
|
||||
...
|
||||
|
||||
## Primi passi
|
||||
|
||||
...
|
||||
@@ -0,0 +1,10 @@
|
||||
# Benvenuto nella documentazione di BeamNG.drive
|
||||
Questa documentazione non è ufficiale, ma è realizzata dal team di BeamMP e dalla comunità di BeamNG.
|
||||
|
||||
## Capire la struttura dei file
|
||||
...
|
||||
|
||||
|
||||
## Snippet
|
||||
|
||||
Degli snippet di codice possono essere trovati qui: [Snippets](snippets.md)
|
||||
@@ -0,0 +1,2 @@
|
||||
# imgui-windows.md
|
||||
Questa pagina deve ancora essere creata.
|
||||
@@ -0,0 +1,2 @@
|
||||
# lua-mods.md
|
||||
Questa pagina deve ancora essere creata.
|
||||
@@ -0,0 +1 @@
|
||||
# Creazione di app UI
|
||||
@@ -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,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,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,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,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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -51,7 +51,26 @@
|
||||
"Version 2.X (Deprecated)": "Versione 2.X (Deprecata)",
|
||||
"Contributing": "Contribuire",
|
||||
"Getting Started": "Primi passi",
|
||||
"Get Started": "Primi passi",
|
||||
"Community": "Comunità",
|
||||
"Players": "Giocatori",
|
||||
"Server Owners": "Proprietari di server",
|
||||
"Developers": "Sviluppatori",
|
||||
"Game Documentation": "Documentazione di gioco",
|
||||
"Troubleshooting": "Risoluzione problemi",
|
||||
"Install BeamMP": "Installa BeamMP",
|
||||
"Join Your First Server": "Unisciti al tuo primo server",
|
||||
"First-Time Multiplayer Settings": "Impostazioni multigiocatore iniziali",
|
||||
"Gameplay Basics": "Nozioni base di gameplay",
|
||||
"Mod Safety": "Sicurezza mod",
|
||||
"Host a Server": "Ospitare un server",
|
||||
"Check for CGNAT": "Verifica CGNAT",
|
||||
"Server Error Codes": "Codici errore server",
|
||||
"BeamMP Scripting Reference": "Riferimento scripting BeamMP",
|
||||
"Community Info": "Informazioni comunità",
|
||||
"Launcher Update Issues": "Problemi aggiornamento Launcher",
|
||||
"Connection / Networking Issues": "Problemi di connessione / rete",
|
||||
"Defender / Firewall Exclusions": "Esclusioni Defender / Firewall",
|
||||
"General Information": "Informazioni generali",
|
||||
"Rules": "Regole"
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
# F.A.Q. per il giocatore
|
||||
|
||||
---
|
||||
## Come collego il mio account Discord?
|
||||
|
||||
Puoi collegare il tuo account Discord a BeamMP mandando il messaggio `!link` al bot [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/).
|
||||
Il bot ti risponderà con un link dove potrai fare login con il tuo account BeamMP. Una volta effettuato il login riceverai un secondo messaggio di conferma del collegamento. :tada:
|
||||
|
||||
## Come ottengo l'early access?
|
||||
|
||||
L'early access (che include la tag in gioco viola e altri vantaggi), si può ottenere facendo server boost al nostro server Discord, oppure supportandoci su [Patreon](https://patreon.com/BeamMP).
|
||||
|
||||
## Ho supportato tramite Patreon, come ottengo i benefici?
|
||||
|
||||
Effettua le seguenti operazioni per ottenere automaticamente i vantaggi dell'early access:
|
||||
|
||||
1. Collega il tuo account Discord con Patreon per ricevere i ruoli di early access nel nostro server Discord.
|
||||
2. Assicurati di aver usato la stessa email sia per Patreon sia per il tuo account [BeamMP](https://forum.beammp.com/).
|
||||
|
||||
Potrebbero volerci fino a 4 ore per la sincronizzazione tra Patreon e BeamMP. Se dopo 12 ore non hai ancora ottenuto i benefici di Patreon e hai correttamente effettuato i passi precedenti, contatta il supporto di BeamMP.
|
||||
|
||||
## Ho altre domande
|
||||
|
||||
Se la tua domanda o problema riguarda il gioco o come giocare, guarda le [FAQ del gioco](game-faq.md).
|
||||
Se la tua domanda o problema riguarda la gestione del server, guarda le [FAQ del server](server-faq.md).
|
||||
In alternativa puoi consultare il nostro [forum](https://forum.beammp.com/c/faq/35) dove puoi trovare domande e risposte dalla comunità.
|
||||
@@ -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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -0,0 +1,26 @@
|
||||
# F.A.Q. per il giocatore
|
||||
|
||||
---
|
||||
## Come collego il mio account Discord?
|
||||
|
||||
Puoi collegare il tuo account Discord a BeamMP mandando il messaggio `!link` al bot [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/).
|
||||
Il bot ti risponderà con un link dove potrai fare login con il tuo account BeamMP. Una volta effettuato il login riceverai un secondo messaggio di conferma del collegamento. :tada:
|
||||
|
||||
## Come ottengo l'early access?
|
||||
|
||||
L'early access (che include la tag in gioco viola e altri vantaggi), si può ottenere facendo server boost al nostro server Discord, oppure supportandoci su [Patreon](https://patreon.com/BeamMP).
|
||||
|
||||
## Ho supportato tramite Patreon, come ottengo i benefici?
|
||||
|
||||
Effettua le seguenti operazioni per ottenere automaticamente i vantaggi dell'early access:
|
||||
|
||||
1. Collega il tuo account Discord con Patreon per ricevere i ruoli di early access nel nostro server Discord.
|
||||
2. Assicurati di aver usato la stessa email sia per Patreon sia per il tuo account [BeamMP](https://forum.beammp.com/).
|
||||
|
||||
Potrebbero volerci fino a 4 ore per la sincronizzazione tra Patreon e BeamMP. Se dopo 12 ore non hai ancora ottenuto i benefici di Patreon e hai correttamente effettuato i passi precedenti, contatta il supporto di BeamMP.
|
||||
|
||||
## Ho altre domande
|
||||
|
||||
Se la tua domanda o problema riguarda il gioco o come giocare, guarda le [FAQ del gioco](game-faq.md).
|
||||
Se la tua domanda o problema riguarda la gestione del server, guarda le [FAQ del server](server-faq.md).
|
||||
In alternativa puoi consultare il nostro [forum](https://forum.beammp.com/c/faq/35) dove puoi trovare domande e risposte dalla comunità.
|
||||
@@ -0,0 +1,26 @@
|
||||
# F.A.Q. per il giocatore
|
||||
|
||||
---
|
||||
## Come collego il mio account Discord?
|
||||
|
||||
Puoi collegare il tuo account Discord a BeamMP mandando il messaggio `!link` al bot [BeamMP Accounts](https://discordapp.com/channels/@me/1201234743568634026/).
|
||||
Il bot ti risponderà con un link dove potrai fare login con il tuo account BeamMP. Una volta effettuato il login riceverai un secondo messaggio di conferma del collegamento. :tada:
|
||||
|
||||
## Come ottengo l'early access?
|
||||
|
||||
L'early access (che include la tag in gioco viola e altri vantaggi), si può ottenere facendo server boost al nostro server Discord, oppure supportandoci su [Patreon](https://patreon.com/BeamMP).
|
||||
|
||||
## Ho supportato tramite Patreon, come ottengo i benefici?
|
||||
|
||||
Effettua le seguenti operazioni per ottenere automaticamente i vantaggi dell'early access:
|
||||
|
||||
1. Collega il tuo account Discord con Patreon per ricevere i ruoli di early access nel nostro server Discord.
|
||||
2. Assicurati di aver usato la stessa email sia per Patreon sia per il tuo account [BeamMP](https://forum.beammp.com/).
|
||||
|
||||
Potrebbero volerci fino a 4 ore per la sincronizzazione tra Patreon e BeamMP. Se dopo 12 ore non hai ancora ottenuto i benefici di Patreon e hai correttamente effettuato i passi precedenti, contatta il supporto di BeamMP.
|
||||
|
||||
## Ho altre domande
|
||||
|
||||
Se la tua domanda o problema riguarda il gioco o come giocare, guarda le [FAQ del gioco](game-faq.md).
|
||||
Se la tua domanda o problema riguarda la gestione del server, guarda le [FAQ del server](server-faq.md).
|
||||
In alternativa puoi consultare il nostro [forum](https://forum.beammp.com/c/faq/35) dove puoi trovare domande e risposte dalla comunità.
|
||||
@@ -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**
|
||||
Consultare la [documentazione in inglese](https://docs.beammp.com/game/getting-started/#2b-linux-installation).
|
||||
|
||||
---
|
||||
|
||||
## **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`.
|
||||
@@ -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:
|
||||
@@ -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,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 launcher.
|
||||
|
||||
---
|
||||
|
||||
| Codice | Descrizione | Soluzione possibile |
|
||||
|--------|-------------|---------------------|
|
||||
| 10054 | Connessione reimpostata dal peer | Il server al quale ti stai connettendo è andato offline. |
|
||||
| Bloccato sugli aggiornamenti | Il launcher è bloccato agli aggiornamenti e non procede al passo successivo | Esegui il launcher come amministratore e controlla le regole del tuo antivirus affinché il launcher non sia bloccato. |
|
||||
| Failed to find the game please launch it. Report this if the issue persists code 3. | Il launcher non è stato in grado di trovare le informazioni del gioco (cartella del gioco, cartella del profilo, versione, ecc...) nel registro di sistema | Avvia il gioco almeno una volta per creare i valori nel registro. |
|
||||
| Failed to find the game please launch it. Report this if the issue persists code 4. | Il launcher non è stato in grado di leggere le informazioni del gioco (cartella del gioco, cartella del profilo, versione, ecc...) nel registro di sistema | Questo errore è mostrato per la maggior parte a utenti che hanno una **copia pirata** del gioco. Se hai acquistato il gioco, avvialo almeno una volta per creare i valori nel registro. |
|
||||
| Failed to Launch the game! launcher closing soon | Il launcher non è stato in grado di trovare l'eseguibile del gioco | Avvia il gioco almeno una volta ed esegui di nuovo il launcher. |
|
||||
| Game Closed! launcher closing soon | Il gioco è stato chiuso | Questo messaggio appare alla chiusura del gioco o quando il gioco non si è avviato correttamente. |
|
||||
| Launcher Update failed! | Il launcher non è stato in grado di scaricare una nuova versione | Controlla la tua connessione ad internet e le regole del tuo firewall / antivirus affinché il launcher non sia bloccato. |
|
||||
| Logger file init failed | Il launcher non ha i permessi per creare file | Esegui il launcher come amministratore. |
|
||||
| Please close the game and try again | Il gioco è già aperto e il launcher non riesce a liberare la cartella `multiplayer/mods` | Chiudi il gioco e riprova. |
|
||||
| Please launch the game at least once | Il launcher ha provato e ha fallito a modificare la cartella del gioco | Avvia il gioco almeno una volta ed esegui di nuovo il launcher. |
|
||||
| Primary Servers Offline! sorry for the inconvenience! | Il launcher non è stato in grado di controllare gli aggiornamenti | Controlla la tua connessione ad internet e le regole del firewall. Se non ci sono errori dalla tua parte, guarda il [canale BeamMP updates](<https://discord.com/channels/601558901657305098/697596153943949352>) sul nostro Discord. |
|
||||
| Sorry Backend System Outage! Don't worry it will back on soon! | Il backend BeamMP è irraggiungibile | Controlla la tua connessione ad internet e le regole del firewall. Se non ci sono errori dalla tua parte, guarda il [canale BeamMP updates](<https://discord.com/channels/601558901657305098/697596153943949352>) sul nostro Discord. |
|
||||
|
||||
Se il launcher si chiude immediatamente, controlla il file `Launcher.log` nella cartella dove hai installato BeamMP.
|
||||
@@ -0,0 +1,57 @@
|
||||
# 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/LICENSE) |
|
||||
| Client Lua | [LICENSE](https://github.com/BeamMP/BeamMP/blob/development/LICENSE) |
|
||||
|
||||
---
|
||||
#### **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,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