Configurar tu servidor Vintage Story: whitelist, admin y mods

Dificultad: Principiante ⭐
Servidores compatibles: Vintage Story en OuiPanel

---

📋 Introducción

Esta guía explica cómo preparar tu servidor Vintage Story en OuiPanel. Verás cómo añadir a tus jugadores a la whitelist, convertirte en administrador, ajustar el archivo serverconfig.json, añadir mods de la ModDB y cambiar de versión.

Tu servidor se instala solo, sin ninguna cuenta que facilitar. Eso sí, cada jugador, tú incluido, debe tener el juego con su propia cuenta de Vintage Story.

⚠️ Un servidor dedicado de Vintage Story solo acepta a los jugadores de su whitelist. Mientras no hayas añadido a nadie, el servidor rechaza todas las conexiones: empieza por la parte «Añadir a tus jugadores a la whitelist».

---

📂 Abrir los archivos del servidor

Tienes dos formas de abrir los archivos del servidor.

• El Gestor de archivos de OuiPanel. Abre tu servidor y haz clic en Gestor de archivos en el menú. Haz clic en un archivo para abrirlo, modifícalo y guarda.
• SFTP, con un programa como FileZilla. Nuestra guía Cómo conectarse por SFTP con FileZilla explica la conexión.

Todo lo que concierne a tu partida está en la carpeta data:

Elemento	Contenido
Saves	Tu mundo, el archivo default.vcdbs.
Mods	Tus mods, en archivos .zip.
serverconfig.json	Los ajustes del servidor, creados en el primer arranque.
Logs	Los registros del servidor.
Backups, Cache, ModData	Archivos gestionados por el juego.

---

🔐 Añadir a tus jugadores a la whitelist

La whitelist es la lista de jugadores autorizados a entrar en tu servidor. Está activada por defecto en un servidor dedicado.

1. Arranca el servidor desde la Consola de OuiPanel y espera la línea Dedicated Server now running on Port.
2. En el campo de comandos de la consola, escribe /whitelist add seguido del nombre del jugador, el de su cuenta de Vintage Story, y valida. Por ejemplo: /whitelist add Alex
3. Repite con cada jugador, sin olvidarte de ti.

---

👑 Convertirte en administrador

Los roles del juego dan más o menos permisos. El rol por defecto de un jugador nuevo es suplayer. El rol admin da todos los permisos.

1. Añade primero tu nombre a la whitelist (parte anterior).
2. En la consola de OuiPanel, escribe /player, tu nombre y luego role admin. Por ejemplo: /player Alex role admin
3. El servidor responde Ok, role admin assigned to Alex. Ya tienes todos los permisos en el juego.

---

⚙️ Ajustar el archivo serverconfig.json

El archivo data/serverconfig.json guarda los ajustes del juego. El servidor lo crea en su primer arranque.

Clave	Función
ServerName	El nombre del servidor.
WhitelistMode	La whitelist, activa por defecto en un servidor dedicado (0).
AllowPvP	El combate entre jugadores, permitido por defecto (true).
DefaultRoleCode	El rol que se da a los jugadores nuevos, suplayer por defecto.

1. Detén el servidor desde la Consola.
2. Abre data/serverconfig.json en el Gestor de archivos, modifica el valor que quieras y guarda.
3. Arranca el servidor.

💡 OuiPanel fija el puerto y el número de jugadores al arrancar. Cambiarlos en el archivo no sirve de nada: usa las variables (parte siguiente).

💡 El juego ve todas las conexiones llegar desde la dirección de nuestro servidor, y no desde la de cada jugador. Deja por tanto las claves LoginFloodProtection y TemporaryIpBlockList en false, su valor por defecto: si se activan, podrían bloquear a todos tus jugadores a la vez.

El archivo contiene otras claves, descritas en la wiki oficial del juego. La clave Password, por ejemplo, está pensada por el juego para pedir una contraseña a los jugadores. Modifica una clave cada vez y guarda antes una copia del archivo.

---

👥 Ajustar el número de jugadores

Tu servidor acepta 16 jugadores por defecto.

1. En OuiPanel, ve a Configuración › Parámetros del servidor.
2. En la sección Variables de entorno, modifica Max Clients y haz clic en la marca a la derecha del campo para guardarlo.
3. Reinicia el servidor desde la Consola.

Más jugadores necesitan más memoria. El desarrollador del juego cuenta 1 GB, más 300 MB por jugador, y más con mods grandes.

---

🧩 Añadir mods de la ModDB

Los mods de Vintage Story se descargan en la ModDB oficial, mods.vintagestory.at.

1. En la página del mod, descarga el archivo .zip de la versión que corresponda a la de tu servidor.
2. Detén el servidor desde la Consola.
3. Sube el archivo .zip, sin descomprimirlo, a la carpeta data/Mods, por SFTP o en el Gestor de archivos.
4. Arranca el servidor.

⚠️ Los mods quedan sin soporte por nuestra parte. Haz una copia de seguridad antes de añadirlos y comprueba en la ModDB que cada mod existe para tu versión del juego.

---

🔄 Elegir la versión y actualizar

En la entrega, el servidor instala la última versión estable del juego. No se actualiza solo.

• Actualizar: cuando sale una versión nueva, reinstala el servidor desde OuiPanel. Descarga la última versión estable.
• Elegir otra versión: en las variables, indica la versión que quieras en Release version (por ejemplo 1.22.7), o la rama en Release branch (stable o unstable), guarda con la marca y reinstala.

La reinstalación sustituye los archivos del juego y conserva la carpeta data: tu mundo, serverconfig.json y tus mods.

💡 Haz una copia de seguridad antes de cambiar de versión y comprueba que tus mods son compatibles con la versión nueva.

---

💾 Guardar tu mundo

En OuiPanel, la página Copias de seguridad crea una copia a petición, y la página Planificación programa copias, por ejemplo cada noche. Una copia incluye todo el servidor, con tu mundo, el archivo data/Saves/default.vcdbs.

---

🎮 Unirte al servidor

1. Abre Vintage Story e inicia sesión con tu cuenta.
2. Abre Multijugador y después Añadir un Servidor.
3. Introduce la dirección y el puerto de tu servidor, tal como aparecen en OuiPanel, y conéctate.

Si el juego rechaza la conexión, comprueba que tu nombre de jugador está en la whitelist.