Esta guía cubre todo lo que necesitas para poner en funcionamiento tu servidor alt:V en Legion Hosting, desde el primer inicio y la configuración de server.toml hasta los recursos del modo de juego, configuración de CDN, chat de voz y cómo los jugadores se conectan a través del launcher de alt:V. Para el desarrollo de recursos, configuración de base de datos y gestión de administración, consulta Configuración de Administración y Recursos de alt:V.

¿Qué es alt:V?

alt:V es una modificación multijugador gratuita y de código abierto para Grand Theft Auto V. Permite a los jugadores conectarse a servidores personalizados que ejecutan modos de juego únicos como roleplay (RP), deathmatch, carreras, freeroam y más. El servidor ejecuta recursos personalizados escritos en JavaScript, TypeScript o C#, dando a los propietarios del servidor control total sobre la lógica del juego. Los jugadores se conectan a través del launcher de alt:V, que modifica GTA V para la conectividad multijugador.

Primer Inicio

Cuando recibas tu servidor alt:V por primera vez, sigue estos pasos para ponerlo en línea:

1. Inicia sesión en GPanel y selecciona tu servidor alt:V.
2. Navega a la pestaña Startup y configura el nombre de tu servidor, máximo de jugadores y otras variables de inicio.
3. Ve a la pestaña Console y haz clic en Start.
4. El servidor descargará los archivos del servidor alt:V en el primer arranque. Esto puede tardar unos minutos.
5. Una vez que la consola muestre que el servidor está escuchando y listo para conexiones, tu servidor está en línea.
6. Por defecto, el servidor inicia sin recursos de modo de juego. Necesitarás añadir recursos para crear la jugabilidad. Consulta Configuración de Administración y Recursos de alt:V para más detalles.

Variables de Inicio de GPanel

alt:V expone varias opciones de configuración como variables de inicio en GPanel. Navega a la pestaña Startup para modificarlas. Los cambios requieren un reinicio del servidor.

Configuración del Servidor (server.toml)

El archivo de configuración principal para los servidores alt:V es server.toml, ubicado en el directorio raíz del servidor. Puedes editar este archivo a través de la pestaña Files en GPanel o vía SFTP.

Ejemplo 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"]

Configuraciones clave: name (nombre que se muestra en el navegador), host (mantener 0.0.0.0), port (debe coincidir con GPanel), players (cantidad máxima), password (vacío para público), announce (true para aparecer en el navegador), token (token de anuncio del sitio web de alt:V, requerido para aparecer en el listado del navegador), gamemode (etiqueta del navegador como "Roleplay"), modules (módulos de scripts: js-module o csharp-module), resources (array de carpetas de recursos a cargar) y tags (etiquetas de filtro del navegador).

Token de Anuncio

Para que tu servidor aparezca en el navegador de servidores de alt:V, necesitas un token de anuncio del servidor maestro de alt:V:

1. Visita el sitio web de alt:V e inicia sesión o crea una cuenta.
2. Navega a la sección de gestión de servidores y genera un nuevo token de servidor.
3. Copia el token y pégalo en el campo token de tu server.toml.
4. Asegúrate de que announce = true en tu configuración.
5. Reinicia el servidor. Ahora debería aparecer en el navegador público.

Recursos del Modo de Juego

Los servidores alt:V funcionan con recursos — scripts que definen toda la lógica del juego. Sin recursos, un servidor no tiene funcionalidad personalizada. Los recursos se colocan en el directorio resources/.

Estructura de 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)

Carga de Recursos

Añade los nombres de los recursos al array resources en server.toml para cargarlos al inicio:

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

Cada recurso debe tener un archivo resource.toml en su directorio que define su tipo, dependencias y puntos de entrada de scripts. Para detalles sobre la creación y gestión de recursos, consulta Configuración de Administración y Recursos de alt:V.

Configuración de CDN

alt:V utiliza un mecanismo de CDN para servir archivos del lado del cliente (modelos, texturas, scripts) a los jugadores que se conectan. El CDN integrado sirve archivos directamente desde el servidor sin necesidad de configuración adicional — esto es lo predeterminado y funciona bien para la mayoría de los servidores. Para servidores a gran escala con muchos assets personalizados, opcionalmente puedes configurar un CDN externo subiendo los archivos del cliente a un servidor web y estableciendo la URL del CDN en la configuración de tu recurso, reduciendo el uso de ancho de banda del servidor de juego.

Chat de Voz

alt:V incluye un sistema de chat de voz integrado que permite la comunicación por voz posicional (3D) entre jugadores. El chat de voz se habilita y configura en server.toml.

Configuración de Voz

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

El bitrate controla la calidad de voz (64000 es estándar). Los campos external* configuran un servidor de voz externo — déjalos vacíos/cero para usar el servidor de voz integrado, que es lo recomendado para la mayoría de las configuraciones. La opción de servidor de voz externo solo se necesita para configuraciones avanzadas donde el procesamiento de voz se descarga a una máquina separada.

Cómo se Conectan los Jugadores

Los jugadores se conectan a los servidores alt:V a través del launcher de alt:V, no directamente a través de GTA V.

A través del Navegador de Servidores

1. Descarga e instala el launcher de alt:V desde altvmp.com.
2. Inicia el launcher de alt:V. Detectará y verificará la instalación de GTA V.
3. Desde el launcher, navega por el Server Browser.
4. Busca tu servidor por nombre o usa filtros (modo de juego, etiquetas, cantidad de jugadores).
5. Haz clic en tu servidor y selecciona Connect.
6. Si el servidor tiene contraseña, se le pedirá al jugador que la ingrese.
7. GTA V se iniciará con el mod multijugador de alt:V y se conectará a tu servidor.

A través de Conexión Directa

1. En el launcher de alt:V, selecciona Direct Connect.
2. Ingresa la dirección IP y el port de tu servidor en el formato IP:PORT (por ejemplo, 192.168.1.1:7788).
3. Haz clic en Connect.

Para encontrar la dirección IP y el port de tu servidor, consulta Cómo Encontrar la IP y el Puerto de tu Servidor.

Máximo de Jugadores y Rendimiento

Los servidores alt:V pueden soportar altas cantidades de jugadores, pero el rendimiento depende en gran medida de tus recursos y plan de servidor:

• 32–128 jugadores: Un rango común para la mayoría de los servidores. Los modos de juego simples funcionan sin problemas con cantidades más altas.
• 128–512+ jugadores: Posible para servidores optimizados con recursos eficientes. Requiere más CPU y RAM.
• Eficiencia de recursos: Los scripts mal optimizados son la causa principal de problemas de rendimiento. Los scripts del lado del servidor que ejecutan operaciones pesadas cada tick o mantienen grandes estructuras de datos en memoria pueden crear cuellos de botella en el servidor.
• Consultas a la base de datos: Los modos de juego que usan bases de datos (MySQL, MongoDB) deben usar consultas asíncronas para evitar bloquear el hilo principal.

Artículos Relacionados

• Configuración de Administración y Recursos de alt:V — Desarrollo de recursos, configuración de base de datos, herramientas de administración y solución de problemas
• Cómo Encontrar la IP y el Puerto de tu Servidor
• Cómo Subir Archivos vía SFTP
• Guía de Inicio del Servidor — Guía general para iniciar cualquier servidor de juegos en Legion Hosting

¿Necesitas Más Ayuda?

Si estás experimentando problemas no cubiertos en esta guía, nuestro equipo de soporte está disponible para asistirte. Abre un ticket en legionhosting.net/submitticket.php con los detalles de tu servidor y una descripción del problema.