Questa guida copre tutto ciò che ti serve per far funzionare il tuo server alt:V su Legion Hosting, dal primo avvio e la configurazione di server.toml alle risorse per le modalità di gioco, la configurazione CDN, la chat vocale e come i giocatori si connettono tramite il launcher alt:V. Per lo sviluppo delle risorse, la configurazione del database e la gestione admin, consulta alt:V Configurazione Admin e Risorse.

Cos'è alt:V?

alt:V è una modifica multiplayer gratuita e open-source per Grand Theft Auto V. Permette ai giocatori di connettersi a server personalizzati con modalità di gioco uniche come roleplay (RP), deathmatch, corse, freeroam e altro. Il server esegue risorse personalizzate scritte in JavaScript, TypeScript o C#, dando ai proprietari del server il pieno controllo sulla logica di gioco. I giocatori si connettono tramite il launcher alt:V, che modifica GTA V per la connettività multiplayer.

Primo Avvio

Quando ricevi per la prima volta il tuo server alt:V, segui questi passaggi per metterlo online:

1. Accedi a GPanel e seleziona il tuo server alt:V.
2. Vai alla scheda Startup e configura il nome del server, il numero massimo di giocatori e altre variabili di avvio.
3. Vai alla scheda Console e clicca Start.
4. Il server scaricherà i file del server alt:V al primo avvio. Questo potrebbe richiedere alcuni minuti.
5. Una volta che la console mostra che il server è in ascolto e pronto per le connessioni, il tuo server è online.
6. Per impostazione predefinita, il server si avvia senza risorse per la modalità di gioco. Dovrai aggiungere risorse per creare il gameplay. Consulta alt:V Configurazione Admin e Risorse per i dettagli.

Variabili di Avvio di GPanel

alt:V espone diverse opzioni di configurazione come variabili di avvio in GPanel. Vai alla scheda Startup per modificarle. Le modifiche richiedono un riavvio del server.

Configurazione del Server (server.toml)

Il file di configurazione principale per i server alt:V è server.toml, situato nella directory radice del server. Puoi modificare questo file tramite la scheda Files in GPanel o via SFTP.

Esempio di server.toml

name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]

Impostazioni principali: name (nome visualizzato nel browser), host (mantieni 0.0.0.0), port (deve corrispondere a GPanel), players (numero massimo), password (vuoto per server pubblico), announce (true per apparire nel browser), token (token di annuncio dal sito web alt:V, richiesto per la visibilità nel browser), gamemode (etichetta nel browser come "Roleplay"), modules (moduli script: js-module o csharp-module), resources (array di cartelle risorse da caricare) e tags (tag filtro nel browser).

Token di Annuncio

Affinché il tuo server appaia nel browser dei server alt:V, hai bisogno di un token di annuncio dal master server alt:V:

1. Visita il sito web alt:V e accedi o crea un account.
2. Vai alla sezione di gestione server e genera un nuovo token per il server.
3. Copia il token e incollalo nel campo token del tuo server.toml.
4. Assicurati che announce = true nella tua configurazione.
5. Riavvia il server. Ora dovrebbe apparire nel browser pubblico.

Risorse per le Modalità di Gioco

I server alt:V sono alimentati da risorse — script che definiscono tutta la logica di gioco. Senza risorse, un server non ha funzionalità personalizzate. Le risorse vengono posizionate nella directory resources/.

Struttura delle Risorse

resources/
  myresource/
    resource.toml       <-- Resource configuration
    server/
      index.js          <-- Server-side script
    client/
      index.js          <-- Client-side script (runs on the player's GTA V)

Caricamento delle Risorse

Aggiungi i nomi delle risorse all'array resources in server.toml per caricarle all'avvio:

resources = ["chat", "freeroam", "spawn"]

Ogni risorsa deve avere un file resource.toml nella sua directory che definisce il tipo, le dipendenze e i punti di ingresso degli script. Per dettagli sulla creazione e gestione delle risorse, consulta alt:V Configurazione Admin e Risorse.

Configurazione CDN

alt:V utilizza un meccanismo CDN per servire i file lato client (modelli, texture, script) ai giocatori che si connettono. Il CDN integrato serve i file direttamente dal server senza necessità di configurazione aggiuntiva — questa è l'impostazione predefinita e funziona bene per la maggior parte dei server. Per server su larga scala con molte risorse personalizzate, puoi opzionalmente configurare un CDN esterno caricando i file client su un web server e impostando l'URL del CDN nella configurazione delle risorse, riducendo l'utilizzo di banda del server di gioco.

Chat Vocale

alt:V include un sistema di chat vocale integrato che permette la comunicazione vocale posizionale (3D) tra i giocatori. La chat vocale viene abilitata e configurata in server.toml.

Configurazione Vocale

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

Il bitrate controlla la qualità vocale (64000 è lo standard). I campi external* configurano un server vocale esterno — lasciali vuoti/a zero per utilizzare il server vocale integrato, consigliato per la maggior parte delle configurazioni. L'opzione del server vocale esterno è necessaria solo per configurazioni avanzate in cui l'elaborazione vocale viene delegata a una macchina separata.

Come si Connettono i Giocatori

I giocatori si connettono ai server alt:V tramite il launcher alt:V, non direttamente tramite GTA V.

Tramite il Browser dei Server

1. Scarica e installa il launcher alt:V da altvmp.com.
2. Avvia il launcher alt:V. Rileverà e verificherà l'installazione di GTA V.
3. Dal launcher, sfoglia il Server Browser.
4. Cerca il tuo server per nome o usa i filtri (modalità di gioco, tag, numero di giocatori).
5. Clicca sul tuo server e seleziona Connect.
6. Se il server ha una password, al giocatore verrà chiesto di inserirla.
7. GTA V si avvierà con la mod multiplayer alt:V e si connetterà al tuo server.

Tramite Connessione Diretta

1. Nel launcher alt:V, seleziona Direct Connect.
2. Inserisci l'indirizzo IP e la porta del tuo server nel formato IP:PORT (es. 192.168.1.1:7788).
3. Clicca Connect.

Per trovare l'indirizzo IP e la porta del tuo server, consulta Come Trovare l'IP e la Porta del Tuo Server.

Numero Massimo di Giocatori e Prestazioni

I server alt:V possono supportare un elevato numero di giocatori, ma le prestazioni dipendono fortemente dalle tue risorse e dal piano del server:

• 32–128 giocatori: Un intervallo comune per la maggior parte dei server. Le modalità di gioco semplici funzionano senza problemi con numeri più elevati.
• 128–512+ giocatori: Possibile per server ottimizzati con risorse efficienti. Richiede più CPU e RAM.
• Efficienza delle risorse: Script poco ottimizzati sono la causa principale dei problemi di prestazioni. Gli script lato server che eseguono operazioni pesanti ad ogni tick o mantengono grandi strutture dati in memoria possono creare un collo di bottiglia per il server.
• Query al database: Le modalità di gioco che utilizzano database (MySQL, MongoDB) dovrebbero usare query asincrone per evitare di bloccare il thread principale.

Articoli Correlati

• alt:V Configurazione Admin e Risorse — Sviluppo risorse, configurazione database, strumenti admin e risoluzione dei problemi
• Come Trovare l'IP e la Porta del Tuo Server
• Come Caricare File via SFTP
• Guida all'Avvio del Server — Guida generale per avviare qualsiasi server di gioco su Legion Hosting

Hai Bisogno di Ulteriore Aiuto?

Se riscontri problemi non trattati in questa guida, il nostro team di supporto è disponibile ad assisterti. Apri un ticket su legionhosting.net/submitticket.php con i dettagli del tuo server e una descrizione del problema.