Guía de Configuración del Servidor de Vintage Story

Esta guía cubre cómo configurar tu servidor dedicado de Vintage Story alojado con Legion Hosting, incluyendo el primer inicio, variables de GPanel, gestión de versiones, configuración del servidor, ajustes del mundo, conexión de jugadores y gestión de partidas guardadas. Para la instalación de mods, consulta Instalación de Mods de Vintage Story. Para la configuración de administrador y comandos, consulta Comandos de Administrador de Vintage Story.

Antes de comenzar: Asegúrate de que tu servidor esté creado en GPanel. Si necesitas ayuda para encontrar la dirección IP y el puerto de tu servidor, consulta Cómo Encontrar la IP y el Puerto de tu Servidor.

Primer Inicio

Cuando inicias tu servidor de Vintage Story por primera vez desde GPanel, el servidor descargará automáticamente los archivos del juego desde la API oficial de Vintage Story y generará un mundo predeterminado. Este inicio inicial puede tardar varios minutos mientras los archivos se descargan y extraen.

Inicia sesión en GPanel y selecciona tu servidor de Vintage Story.
Antes de iniciar, revisa la pestaña Startup para confirmar tu rama de versión preferida (stable, unstable o pre-release).
Haz clic en Start en la pestaña Console. Observa la salida de la consola para ver los mensajes de progreso mientras el servidor descarga e instala los archivos del juego.
Una vez que veas un mensaje indicando que el servidor está escuchando conexiones, el servidor está listo. Se generará automáticamente un archivo serverconfig.json predeterminado.

El primer inicio tarda más de lo habitual. El servidor debe descargar el paquete completo del servidor de Vintage Story antes de poder iniciar. Los inicios posteriores serán mucho más rápidos a menos que cambies la versión o la rama.

Variables de Inicio de GPanel

Los ajustes principales del servidor se controlan a través de la pestaña Startup en GPanel. Revisa y ajusta estos antes de iniciar tu servidor.

Variable	Predeterminado	Descripción
`SERVER_PORT`	(asignado)	El puerto del juego que los jugadores usan para conectarse. Es asignado automáticamente por GPanel -- consulta la pestaña Network para ver tu puerto asignado.
`MAX_CLIENTS`	`16`	Número máximo de jugadores simultáneos. Se puede configurar hasta 256. Debe coincidir con los recursos de tu plan de alojamiento.
`FILES_BRANCH`	`stable`	Qué rama de lanzamiento usar. Opciones: `stable`, `unstable` o `pre`. Consulta la sección de Gestión de Versiones a continuación para más detalles.
`RELEASE_VERSION`	`latest`	La versión específica a instalar. Configúralo como `latest` para usar siempre la versión más reciente en tu rama elegida, o ingresa un número de versión específico (por ejemplo, `1.19.8`) para fijar esa versión.
`OPTIONS`	(vacío)	Argumentos adicionales de línea de comandos pasados al proceso del servidor al iniciar. Déjalo vacío a menos que necesites flags de inicio específicos.
`SQLITE_TMPDIR`	(auto)	Directorio temporal utilizado por SQLite para operaciones de base de datos. Generalmente no necesita ser cambiado.

Después de actualizar las variables de inicio, reinicia el servidor desde GPanel para que los cambios surtan efecto.

Gestión de Versiones

Vintage Story ofrece tres ramas de lanzamiento. Tu elección de rama se configura mediante la variable de inicio FILES_BRANCH en GPanel.

Rama	Valor	Descripción
Stable	`stable`	La rama recomendada para la mayoría de los servidores. Estas versiones han sido probadas exhaustivamente y son las más confiables para mundos a largo plazo.
Unstable	`unstable`	Versiones beta con nuevas características y cambios que aún están siendo probados. Pueden contener errores. Usa esta si quieres acceso anticipado a nuevo contenido y aceptas cierta inestabilidad.
Pre-release	`pre`	Compilaciones de desarrollo temprano. Son las menos probadas y pueden tener problemas significativos. Solo recomendada para propósitos de prueba -- no para servidores de producción.

Fijar una Versión Específica

Por defecto, RELEASE_VERSION está configurado como latest, lo que significa que el servidor descargará e instalará la versión más nueva disponible en tu rama elegida cada vez que el servidor se inicie (si hay una versión más nueva disponible). Para prevenir actualizaciones automáticas y bloquear tu servidor en una versión específica:

Ve a la pestaña Startup en GPanel.
Cambia RELEASE_VERSION de latest al número de versión exacto que deseas (por ejemplo, 1.19.8).
Reinicia el servidor. Usará solo la versión fijada independientemente de las nuevas versiones.

Compatibilidad de mods: Si estás ejecutando mods, se recomienda fijar una versión específica. Las actualizaciones del juego pueden romper la compatibilidad de los mods, y actualizar a mitad de una partida puede causar problemas. Verifica que tus mods sean compatibles con la versión objetivo antes de actualizar. Consulta Instalación de Mods de Vintage Story para más detalles.

Cambiar de rama puede requerir un reinicio del mundo. Moverse entre las ramas stable y unstable puede introducir cambios en el formato del mundo. Siempre haz una copia de seguridad de tu mundo antes de cambiar de rama. Si la nueva versión es incompatible con tu mundo existente, es posible que necesites iniciar uno nuevo.

serverconfig.json

El archivo de configuración principal del servidor es serverconfig.json, ubicado en el directorio raíz del servidor. Este archivo se genera automáticamente en el primer inicio. Detén el servidor antes de editarlo, luego reinicia para que los cambios surtan efecto.

Detén el servidor desde la pestaña Console de GPanel.
Abre la pestaña Files y haz clic en serverconfig.json para editarlo.
Modifica los ajustes que necesites (consulta la tabla a continuación).
Guarda el archivo e inicia el servidor.

Ajustes Principales

Ajuste	Valor de Ejemplo	Descripción
`ServerName`	`"My Legion VS Server"`	El nombre que se muestra en el navegador de servidores del juego. Hazlo descriptivo para que los jugadores puedan encontrar tu servidor.
`WelcomeMessage`	`"Welcome to the server!"`	Mensaje mostrado a los jugadores cuando se unen. Soporta formato básico.
`MaxClients`	`16`	Número máximo de jugadores simultáneos. Debe coincidir con la variable de inicio `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Contraseña requerida para unirse al servidor. Déjalo como cadena vacía (`""`) para un servidor público.
`AllowPvP`	`true`	Configúralo como `true` para habilitar el combate jugador contra jugador, o `false` para un servidor solo PvE.
`SpawnRadius`	`50`	Radio (en bloques) alrededor del punto de aparición del mundo donde los nuevos jugadores pueden aparecer. Un valor mayor dispersa más a los jugadores al unirse.
`MapSizeX`	`1024000`	Ancho del mundo en bloques. El valor predeterminado crea un mundo muy grande. Reducirlo limita qué tan lejos pueden viajar los jugadores de este a oeste.
`MapSizeZ`	`1024000`	Profundidad del mundo en bloques. El valor predeterminado crea un mundo muy grande. Reducirlo limita qué tan lejos pueden viajar los jugadores de norte a sur.
`WorldSeed`	`"myseed123"`	Semilla utilizada para la generación del mundo. La misma semilla produce el mismo mundo. Déjalo como cadena vacía para una semilla aleatoria.

Un ejemplo mínimo de los ajustes principales en serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

El archivo debe ser JSON válido. Asegúrate de que todas las cadenas estén entre comillas dobles, los booleanos estén en minúsculas (true/false), y no haya comas finales después del último elemento en un objeto o arreglo. Si el servidor no se inicia después de editar, verifica si hay errores de sintaxis JSON.

Configuración del Mundo

Vintage Story genera su mundo basándose en los ajustes de serverconfig.json. La generación del mundo solo ocurre en el primer inicio con un mundo dado -- cambiar los ajustes de generación después de que el mundo haya sido creado no alterará retroactivamente el terreno existente.

Ajustes de Generación del Mundo

WorldSeed: Determina el diseño del terreno, la ubicación de los biomas y la distribución de recursos. Establece una semilla específica para compartir el mismo diseño de mundo con otros, o déjalo vacío para un mundo generado aleatoriamente.
MapSizeX / MapSizeZ: Controlan el área jugable máxima. Valores más pequeños crean un mundo más contenido y pueden reducir el uso de recursos. Los jugadores que lleguen al borde del mapa no podrán viajar más en esa dirección.
WorldConfig: El objeto WorldConfig dentro de serverconfig.json te permite ajustar con precisión los parámetros de generación del mundo como la escala de las formas del terreno, patrones climáticos y características geológicas. Estos son ajustes avanzados -- los valores predeterminados funcionan bien para la mayoría de los servidores.

Los ajustes de generación del mundo se bloquean después de la creación. Ajustes como WorldSeed, MapSizeX y MapSizeZ solo surten efecto cuando el mundo se genera por primera vez. Para aplicar nuevos ajustes de generación, debes crear un nuevo mundo (consulta Gestión de Partidas Guardadas a continuación).

Elegir una Semilla

La semilla puede ser cualquier cadena de texto o número. Los jugadores de la comunidad de Vintage Story comparten semillas para diseños de mundo interesantes. Si deseas un tipo específico de terreno o ubicación de aparición, busca en los foros de Vintage Story o sitios de la comunidad semillas recomendadas.

Cómo Conectarse

Los jugadores se conectan a tu servidor de Vintage Story a través del menú multijugador del juego.

Conexión Directa

Inicia Vintage Story y haz clic en Multiplayer desde el menú principal.
Haz clic en Direct Connect.
Ingresa la dirección IP de tu servidor y el puerto del juego en el formato:
```
your.server.ip:port
```
Consulta la pestaña Network en GPanel para ver tu IP y puerto asignados.
Haz clic en Connect. Si el servidor tiene contraseña, ingrésala cuando se te solicite.

Navegador de Servidores

Inicia Vintage Story y haz clic en Multiplayer desde el menú principal.
El navegador de servidores cargará una lista de servidores públicos. Usa la barra de búsqueda para encontrar tu servidor por nombre (el valor de ServerName de serverconfig.json).
Haz clic en tu servidor en la lista y haz clic en Join.

¿El servidor no aparece en el navegador? El navegador de servidores puede tardar varios minutos en indexar un servidor recién iniciado. Usa Conexión Directa para acceso inmediato. También confirma que no hayas establecido una contraseña -- los servidores protegidos con contraseña pueden no aparecer en el navegador público dependiendo de la configuración del servidor.

Gestión de Partidas Guardadas

Los datos del mundo de Vintage Story se almacenan en tu servidor y se guardan automáticamente durante el juego.

Ubicación de los Datos del Mundo

Los archivos de guardado del mundo se almacenan en el directorio data/ de tu servidor. La ruta exacta depende del nombre de tu mundo. Puedes acceder a estos archivos a través de la pestaña Files de GPanel o vía SFTP.

Copia de Seguridad de tu Mundo

Detén el servidor para asegurar una copia de seguridad limpia (sin archivos siendo escritos a mitad de guardado).
Conéctate a tu servidor vía SFTP. Consulta Cómo Subir Archivos vía SFTP para instrucciones de conexión.
Descarga el directorio completo data/ a tu máquina local.
Almacena la copia de seguridad en un lugar seguro. Considera mantener múltiples copias de seguridad con fecha en caso de que necesites volver a un punto específico.

Se recomiendan encarecidamente las copias de seguridad regulares. La corrupción del mundo, el griefing accidental o las actualizaciones fallidas de mods pueden resultar en pérdida de datos. Haz una copia de seguridad de tu mundo antes de realizar cambios significativos como actualizar la versión del juego, añadir o eliminar mods, o cambiar la configuración del mundo.

Reiniciar el Mundo

Para iniciar un mundo completamente nuevo:

Detén el servidor desde la pestaña Console de GPanel.
Haz una copia de seguridad de los datos del mundo existente si deseas conservarlos (ver arriba).
Navega al directorio data/ en el administrador de archivos de GPanel y elimina los archivos de guardado del mundo.
Opcionalmente actualiza el WorldSeed en serverconfig.json para generar un diseño de mundo diferente.
Inicia el servidor. Se generará un nuevo mundo desde cero usando tus ajustes de configuración actuales.

Eliminar archivos del mundo es permanente. Una vez eliminados, el mundo no se puede recuperar a menos que tengas una copia de seguridad. Siempre descarga una copia de seguridad antes de realizar un reinicio del mundo.

¿Necesitas Ayuda?

Si encuentras un problema no cubierto en esta guía, abre un ticket de soporte e incluye la dirección IP de tu servidor, una descripción del problema y cualquier salida relevante de la consola de GPanel.

Guía de Configuración del Servidor de Vintage Story - Preguntas Frecuentes - FAQ

Soporte

Categorías

Guía de Configuración del Servidor de Vintage Story