Aquesta guia cobreix tot el que necessiteu per posar en marxa el vostre servidor alt:V a Legion Hosting, des del primer inici i la configuració de server.toml fins als recursos de mode de joc, la configuració del CDN, el xat de veu i com els jugadors es connecten a través del llançador alt:V. Per al desenvolupament de recursos, la configuració de bases de dades i la gestió d'administració, consulteu alt:V Admin and Resource Setup.
Què és alt:V?
alt:V és una modificació multijugador gratuïta i de codi obert per a Grand Theft Auto V. Permet als jugadors connectar-se a servidors personalitzats que executen modes de joc únics com roleplay (RP), deathmatch, curses, freeroam i molt més. El servidor executa recursos personalitzats escrits en JavaScript, TypeScript o C#, donant als propietaris de servidors control total sobre la lògica de joc. Els jugadors es connecten a través del llançador alt:V, que modifica GTA V per a la connectivitat multijugador.
Primer inici
Quan rebeu el vostre servidor alt:V per primera vegada, seguiu aquests passos per posar-lo en línia:
- Inicieu sessió a GPanel i seleccioneu el vostre servidor alt:V.
- Navegueu a la pestanya Startup i configureu el nom del servidor, el màxim de jugadors i altres variables d'inici.
- Aneu a la pestanya Console i feu clic a Start.
- El servidor descarregarà els fitxers del servidor alt:V al primer inici. Això pot trigar uns minuts.
- Un cop la consola mostri que el servidor està escoltant i preparat per a connexions, el vostre servidor està en línia.
- Per defecte, el servidor s'inicia sense recursos de mode de joc. Haureu d'afegir recursos per crear jugabilitat. Consulteu alt:V Admin and Resource Setup per a més detalls.
Variables d'inici de GPanel
alt:V exposa diverses opcions de configuració com a variables d'inici a GPanel. Navegueu a la pestanya Startup per modificar-les. Els canvis requereixen un reinici del servidor.
| Variable | Per defecte | Descripció |
|---|---|---|
PASSWORD |
ChangeMe |
Contrasenya per unir-se al servidor. Mínim 6 caràcters. |
SERVER_DESC |
A Pterodactyl Hosted Server |
Descripció del servidor mostrada al navegador de servidors alt:V. |
BUILD |
release |
La branca del servidor alt:V: release (estable), rc (candidata a llançament) o dev (desenvolupament). |
Configuració del servidor (server.toml)
El fitxer de configuració principal dels servidors alt:V és server.toml, ubicat al directori arrel del servidor. Podeu editar aquest fitxer a través de la pestanya Files a GPanel o via SFTP.
Exemple de 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"]Paràmetres clau: name (nom mostrat al navegador), host (manteniu 0.0.0.0), port (ha de coincidir amb GPanel), players (nombre màxim), password (buit per a públic), announce (true per aparèixer al navegador), token (token d'anunci del lloc web d'alt:V, requerit per al llistat al navegador), gamemode (etiqueta del navegador com "Roleplay"), modules (mòduls de scripts: js-module o csharp-module), resources (array de carpetes de recursos per carregar) i tags (etiquetes de filtre del navegador).
Token d'anunci
Perquè el vostre servidor aparegui al navegador de servidors alt:V, necessiteu un token d'anunci del servidor mestre d'alt:V:
- Visiteu el lloc web d'alt:V i inicieu sessió o creeu un compte.
- Navegueu a la secció de gestió de servidors i genereu un nou token de servidor.
- Copieu el token i enganxeu-lo al camp
tokendel vostreserver.toml. - Assegureu-vos que
announce = truea la vostra configuració. - Reinicieu el servidor. Ara hauria d'aparèixer al navegador públic.
server.toml.
Recursos de mode de joc
Els servidors alt:V funcionen amb recursos — scripts que defineixen tota la lògica de joc. Sense recursos, un servidor no té funcionalitat personalitzada. Els recursos es col·loquen al directori resources/.
Estructura dels recursos
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)Càrrega de recursos
Afegiu els noms dels recursos a l'array resources a server.toml per carregar-los a l'inici:
resources = ["chat", "freeroam", "spawn"]Cada recurs ha de tenir un fitxer resource.toml al seu directori que defineixi el seu tipus, dependències i punts d'entrada dels scripts. Per a detalls sobre la creació i gestió de recursos, consulteu alt:V Admin and Resource Setup.
Configuració del CDN
alt:V utilitza un mecanisme CDN per servir fitxers del costat del client (models, textures, scripts) als jugadors que es connecten. El CDN integrat serveix fitxers directament des del servidor sense necessitat de configuració addicional — aquest és el mètode per defecte i funciona bé per a la majoria de servidors. Per a servidors a gran escala amb molts recursos personalitzats, podeu configurar opcionalment un CDN extern pujant els fitxers del client a un servidor web i establint l'URL del CDN a la configuració del vostre recurs, reduint l'ús d'ample de banda del servidor de joc.
Xat de veu
alt:V inclou un sistema de xat de veu integrat que permet la comunicació per veu posicional (3D) entre jugadors. El xat de veu s'activa i es configura a server.toml.
Configuració de veu
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0El bitrate controla la qualitat de la veu (64000 és l'estàndard). Els camps external* configuren un servidor de veu extern — deixeu-los buits/zero per utilitzar el servidor de veu integrat, que és recomanat per a la majoria de configuracions. L'opció de servidor de veu extern només és necessària per a configuracions avançades on el processament de veu es delega a una màquina separada.
Com es connecten els jugadors
Els jugadors es connecten als servidors alt:V a través del llançador alt:V, no directament a través de GTA V.
A través del navegador de servidors
- Descarregueu i instal·leu el llançador alt:V des d'altvmp.com.
- Inicieu el llançador alt:V. Detectarà i verificarà la instal·lació de GTA V.
- Des del llançador, navegueu pel Server Browser.
- Cerqueu el vostre servidor pel nom o utilitzeu filtres (mode de joc, etiquetes, nombre de jugadors).
- Feu clic al vostre servidor i seleccioneu Connect.
- Si el servidor té contrasenya, el jugador haurà d'introduir-la.
- GTA V s'iniciarà amb el mod multijugador alt:V i es connectarà al vostre servidor.
A través de connexió directa
- Al llançador alt:V, seleccioneu Direct Connect.
- Introduïu l'adreça IP i el port del vostre servidor en el format
IP:PORT(p. ex.,192.168.1.1:7788). - Feu clic a Connect.
Per trobar l'adreça IP i el port del vostre servidor, consulteu How to Find Your Server IP and Port.
announce = true al vostre server.toml i que teniu un token d'anunci vàlid. El servidor pot trigar un minut a registrar-se després de l'inici. Comproveu la consola per a errors de connexió amb el servidor mestre. Tingueu en compte que el vostre port s'assigna aleatòriament tret que tingueu una IP privada -- comproveu GPanel per al valor correcte.
Màxim de jugadors i rendiment
Els servidors alt:V poden suportar recomptes elevats de jugadors, però el rendiment depèn en gran mesura dels vostres recursos i del pla de servidor:
- 32–128 jugadors: Un rang comú per a la majoria de servidors. Els modes de joc senzills funcionen sense problemes amb recomptes més alts.
- 128–512+ jugadors: Possible per a servidors optimitzats amb recursos eficients. Requereix més CPU i RAM.
- Eficiència dels recursos: Els scripts mal optimitzats són la causa principal dels problemes de rendiment. Els scripts del costat del servidor que executen operacions pesants cada tick o mantenen grans estructures de dades a la memòria poden crear colls d'ampolla al servidor.
- Consultes a la base de dades: Els modes de joc que utilitzen bases de dades (MySQL, MongoDB) haurien d'utilitzar consultes asíncrones per evitar bloquejar el fil principal.
Articles relacionats
- alt:V Admin and Resource Setup — Desenvolupament de recursos, configuració de bases de dades, eines d'administració i resolució de problemes
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Server Startup Guide — Guia general per iniciar qualsevol servidor de joc a Legion Hosting
Necessiteu més ajuda?
Si teniu problemes no coberts en aquesta guia, el nostre equip de suport està disponible per ajudar-vos. Obriu un tiquet a legionhosting.net/submitticket.php amb els detalls del vostre servidor i una descripció del problema.
