Cómo subir un modpack personalizado

Si ya tienes un modpack armado (por ejemplo, exportado desde CurseForge o Modrinth, o hecho a mano) y quieres subirlo directamente al servidor en vez de instalarlo desde un launcher, esta guía es para ti. Si en cambio quieres instalarlo desde tu propio PC con un launcher, consulta Cómo instalar un modpack en el lanzador de CurseForge o de Modrinth.

Antes de empezar: distingue el pack de cliente del pack de servidor

La mayoría de modpacks se descargan en dos versiones:

• Pack de cliente: pensado para el launcher, incluye mods que solo funcionan en tu PC (shaders, mods visuales…).
• Pack de servidor (server pack): contiene el loader, los mods compatibles con servidor y las configs. Es el que necesitas subir a tu servidor de XSTAR.

Si subes el pack de cliente, el servidor no arrancará o dará errores por mods que solo existen del lado del cliente.

Paso 1: haz que el loader coincida

Antes de subir nada:

1. Entra a Xpanel y ve a la configuración/versión de tu servidor.
2. Elige el mismo loader (Forge, NeoForge, Fabric…) que usa el modpack.
3. Asegúrate de que la versión de Minecraft y la versión del loader coincidan exactamente con lo que pide el modpack. Un pack de Forge 1.20.1 no funciona en un servidor Forge 1.19.2.
4. Guarda y espera a que el servidor reinicie con la nueva versión antes de subir archivos.

Paso 2: sube el pack de servidor

Desde el gestor de archivos del panel:

1. Ve a “Archivos” en Xpanel y entra a la raíz del servidor (donde están server.properties, world/, etc.).
2. Si vienes de una instalación anterior, borra la carpeta mods/ vieja para evitar mezclar versiones.
3. Sube el pack de servidor como un único .zip.
4. Haz clic derecho sobre el zip y extráelo.
5. Si el contenido queda dentro de una subcarpeta (por ejemplo nombre-del-pack/mods/), muévelo un nivel arriba para que quede /mods/ directamente en la raíz.
6. Borra el .zip sobrante.

Por SFTP (recomendado para packs de varios cientos de MB): conéctate con tus datos de SFTP (ver Cómo conectarse por SFTP o monta el servidor como una unidad) y sube ahí las carpetas mods/, config/ y demás directamente a la raíz del servidor.

Estructura final esperada

/
├── mods/
├── config/
├── defaultconfigs/
├── libraries/
├── server.properties
├── eula.txt
└── world/

La estructura exacta varía según el pack, pero mods/ y su config/ correspondiente son siempre imprescindibles.

Paso 3: reinicia y vigila la consola

Reinicia el servidor desde Xpanel. El primer arranque con un modpack pesado es lento (el loader genera registros de mods) y puede tardar varios minutos en llegar a “Done” — no lo reinicies antes de tiempo pensando que se ha colgado.

Fallos típicos al arrancar

Problema	Solución
Falta un mod del que dependen otros	Añade el mod que falte a mods/ (el log de la consola suele decir cuál)
Minecraft o el loader no coinciden con el pack	Corrige la versión en la configuración del servidor
Hay un mod de cliente en mods/	Quita los mods pensados solo para el cliente
Se queda sin memoria / muy lento	Sube el plan de RAM: packs de 300+ mods suelen necesitar 6 GB o más

Volver a vanilla

Borra las carpetas mods/ y config/ y reinicia el servidor.

Notas

• Los datos sobrevienen a reinicios y cambios de plan: tu mundo y configuración no se pierden al redimensionar el servidor.
• El gestor de archivos de Xpanel puede limitar cuántos archivos subes de golpe — para packs grandes, sube el .zip completo y extráelo, en vez de arrastrar archivo por archivo.