Resolver los timeouts en un servidor Minecraft modificado

¿Tus jugadores vuelven al menú con «Timed out» o «Read timed out» antes de entrar en tu servidor de Minecraft con mods? Ese tiempo de espera agotado en Minecraft se resuelve alargando el timeout en Forge, NeoForge y Fabric, en el servidor y en el cliente. Esta guía te explica cómo hacerlo y dónde cambiar el comando de inicio en OuiPanel, el panel de juegos de OuiHeberg.

---

Comprender los timeouts

El problema de las desconexiones

Los cortes de conexión por tiempo de espera son uno de los problemas más habituales en los servidores de Minecraft con modpacks grandes. El escenario típico: inicias el juego, intentas entrar en el servidor y, tras una larga espera, el juego te devuelve al menú principal con un error de tiempo de espera agotado.

La causa suele ser el tiempo que hace falta para cargar muchos mods y sincronizarse con el servidor. Unos pocos ajustes o el mod adecuado bastan normalmente para recuperar una conexión estable.

Cómo funcionan los tiempos de espera

Minecraft concede alrededor de medio minuto a las operaciones críticas: inicialización de los mods, conexión con el servidor, transferencia de los datos de sincronización. Es suficiente para una instalación vanilla. Con mods, se queda corto muy rápido.

---

Orígenes del problema

Factores desencadenantes

Los timeouts son más frecuentes en estas situaciones.

Situación	Impacto
Modpack grande (más de 100 mods)	Muy alto
Conexión de red inestable o lenta	Alto
Equipo con recursos limitados (RAM, CPU)	Alto
Mods que exigen un procesamiento intensivo	Moderado
Servidor saturado o mal configurado	Moderado

Diagnóstico rápido

El mensaje de error indica de dónde viene el problema.

Mensaje	Causa probable
Timed out o Read timed out	Tiempo de espera agotado
Connection lost	Red inestable o tiempo de espera agotado
Cierre con una traza de error completa (stacktrace)	Conflicto de mods o incompatibilidad
Missing mod	Falta un mod en el cliente o en el servidor, instalación incompleta

---

Soluciones por modloader

La solución depende del cargador de mods. Forge y NeoForge aceptan argumentos JVM o un mod específico. Fabric usa su propio mod.

Argumentos JVM para Forge y NeoForge

Es el método recomendado. Alarga el tiempo de espera de medio minuto a dos minutos, añadiendo estos argumentos al comando de inicio.

-Dfml.readTimeout=120 -Dfml.loginTimeout=120

Estos parámetros dan a Forge y NeoForge más tiempo durante la carga y la autenticación. Los cortes se vuelven mucho menos frecuentes con los modpacks grandes. El valor se expresa en segundos.

Los argumentos deben ir entre java y -jar para que la JVM los lea.

# Estructura correcta
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui

# Posición errónea (no funcionará)
java -Xms4G -Xmx8G -jar server.jar -Dfml.readTimeout=120 nogui

Alargar el timeout no empeora el rendimiento. Solo fija la espera máxima antes de dar una operación por fallida, sin efecto sobre la CPU, la memoria ni el ancho de banda.

Los argumentos -Dfml.readTimeout y -Dfml.loginTimeout solo los reconocen Forge y NeoForge. Una instalación vanilla los ignora. En vanilla, los timeouts son raros y suelen venir de la red.

Mod TimeoutFixes para Forge y NeoForge

Para no tocar nada técnico, instala el mod TimeoutFixes. Es compatible con Forge y NeoForge y ajusta los tiempos de espera por sí solo. Debe instalarse en el servidor y en el cliente.

Mod TimeOutOut para Fabric

Fabric tiene su propia solución, sin argumentos JVM que cambiar. El mod TimeOutOut aumenta los tiempos de espera de conexión para evitar cortes mientras se inicializan los mods. Está hecho para Fabric, sus tiempos se ajustan libremente y en multijugador debe instalarse en el cliente y en el servidor.

Un mod de timeout instalado en un solo lado puede causar comportamientos imprevisibles. En tu servidor de OuiHeberg, añádelo desde el Mods Manager o deja su archivo .jar en la carpeta mods. La guía Cómo instalar mods en tu servidor de Minecraft (Forge/Fabric) explica los dos métodos.

---

Configuración del servidor

En OuiPanel

1. Inicia sesión en OuiPanel en dash.ouipanel.com y abre tu servidor.

2. Abre Configuración › Parámetros del servidor.

3. En la tarjeta Lanzamiento del servidor, haz clic en Modificar el comando de inicio.

4. En la ventana «Modificación del comando de inicio», añade -Dfml.readTimeout=120 -Dfml.loginTimeout=120 justo después de java, antes de -jar.

5. Haz clic en Guardar.

6. En la Consola, haz clic en Reiniciar y revisa el registro de arranque.

Por ejemplo, un comando de esta forma:

java -Xms4G -Xmx8G -jar server.jar nogui

queda así:

java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui

Un comando de inicio mal modificado puede impedir que el servidor arranque. Copia el comando original antes de tocarlo, para poder restaurarlo.

En la oferta gratuita de Minecraft, el comando de inicio no se puede modificar. El panel muestra entonces «Comando de arranque editable en un plan premium».

En tu propia máquina

Si administras tu propio servidor, crea un script de inicio específico.

Linux (start.sh):

#!/bin/bash
java -Dfml.readTimeout=120 \
     -Dfml.loginTimeout=120 \
     -Xms4G \
     -Xmx8G \
     -XX:+UseG1GC \
     -XX:+ParallelRefProcEnabled \
     -XX:MaxGCPauseMillis=200 \
     -jar server.jar nogui

Windows (start.bat):

@echo off
java -Dfml.readTimeout=120 -Dfml.loginTimeout=120 -Xms4G -Xmx8G -jar server.jar nogui
pause

En todos los casos, guarda la configuración, reinicia el servidor por completo y comprueba en los logs que se aplican los parámetros.

---

Configuración del cliente

Los jugadores también pueden alargar el tiempo de espera por su lado, en su launcher.

Launcher oficial de Minecraft

1. Abre el launcher de Minecraft y ve a la pestaña Instalaciones.

2. Selecciona el perfil de tu modpack.

3. Haz clic en Más opciones para ver los parámetros avanzados.

4. En el campo Argumentos JVM, completa los parámetros existentes como se muestra abajo.

5. Haz clic en Guardar y lanza el juego con este perfil.

-Xms4G -Xmx8G -Dfml.readTimeout=120 -Dfml.loginTimeout=120

CurseForge

1. Abre los ajustes de la aplicación.

2. Selecciona la sección Minecraft.

3. En el campo Argumentos Java adicionales, añade -Dfml.readTimeout=120 -Dfml.loginTimeout=120.

Prism Launcher y MultiMC

1. Haz clic derecho en la instancia.

2. Elige Editar (o Edit Instance).

3. Abre la pestaña Ajustes y luego Java.

4. Escribe los argumentos en el campo correspondiente.

ATLauncher

1. Abre Settings (ajustes).

2. Abre la pestaña Java/Minecraft.

3. Añade los argumentos en Extra JVM Arguments.

GDLauncher

1. Haz clic en el icono de ajustes (engranaje).

2. Selecciona Java.

3. Rellena el campo Additional Arguments.

---

Diagnóstico y resolución avanzada

Comprobar que se aplican los parámetros

Revisa los registros de arranque del servidor. En OuiPanel, abre logs/latest.log desde el Gestor de archivos, o sigue la Consola. En tu propia máquina, este comando encuentra las líneas útiles.

# Buscar en los logs
grep -i "timeout" logs/latest.log

Buenas señales: ningún mensaje «Timed out» al conectarse los jugadores, y conexiones más largas pero que funcionan.

Ajustar los valores por pasos

Empieza con 120, es decir dos minutos, lo que sirve para la mayoría de las configuraciones. Si los cortes siguen, sube de 60 en 60, un minuto más cada vez.

Nivel	Valor	Caso de uso
Estándar	120 (2 minutos)	Modpacks habituales (de 50 a 100 mods)
Ampliado	180 (3 minutos)	Modpacks grandes (de 100 a 200 mods)
Máximo	240 (4 minutos)	Modpacks enormes (más de 200 mods)
Extremo	300 (5 minutos)	Configuraciones muy lentas

Ejemplo con el tiempo ampliado:

-Dfml.readTimeout=180 -Dfml.loginTimeout=180

Por encima de 300, o cinco minutos, el problema está más en el modpack o en el hardware que en el tiempo de espera. Optimiza el modpack en lugar de seguir alargando.

Leer los mensajes de error

Mensaje	Significado	Solución
io.netty.handler.timeout.ReadTimeoutException	Tiempo de lectura agotado	Aumentar readTimeout
Login timed out	Autenticación demasiado lenta	Aumentar loginTimeout
Connection reset	Conexión interrumpida	Comprobar la estabilidad de la red
Internal Exception	Error interno	Leer la traza de error completa

Si el problema continúa

1. Comprueba en los logs que los parámetros se aplican.

2. Prueba tu conexión de red (ping, estabilidad).

3. Quita mods temporalmente para encontrar el que da problemas.

4. Aumenta los recursos asignados, sobre todo la RAM.

5. Actualiza todos tus mods a su última versión.

---

Optimizaciones complementarias

Mods de rendimiento

Alargar el timeout a veces solo es un parche. Para atacar el problema de raíz, instala mods de optimización.

Mod	Efecto	Cargadores
ModernFix	Optimiza la gestión de la memoria y acelera la carga de recursos. Reduce mucho el tiempo de arranque.	Forge, NeoForge, Fabric
FerriteCore	Reduce mucho el consumo de RAM en instalaciones grandes, hasta un 50 % de RAM ahorrada.	Forge, NeoForge, Fabric
LazyDFU	Retrasa la inicialización de DataFixerUpper para un arranque más rápido.	Forge, Fabric

Estabilización de la red

El mod Connectivity optimiza el protocolo de red. Mejora la gestión de las conexiones y reduce los cortes por inestabilidad. Funciona con Forge y NeoForge.

Connectivity no puede convivir con TimeoutFixes. Elige uno u otro según tu problema principal.

Configuración de red del servidor

En server.properties:

# Aumentar si es necesario
max-tick-time=120000
network-compression-threshold=256

En spigot.yml, si tu servidor lo tiene:

settings:
  timeout-time: 120
  restart-on-crash: true

En OuiPanel, server.properties se edita en Configuración › Editor de propiedades, o abriendo el archivo en el Gestor de archivos.

El parámetro player-idle-timeout de server.properties no tiene nada que ver con estos errores. Expulsa a los jugadores inactivos tras el número de minutos indicado, y player-idle-timeout=0 desactiva la expulsión.

---

Recursos útiles

Documentación

• Wiki de Forge

• Wiki de Fabric

• Documentación de Paper

Herramientas de diagnóstico

• Spark Profiler

• Timings

Comunidades

• Reddit r/feedthebeast

• Discord de Forge

• Discord de Fabric

---

¿Necesitas ayuda?

Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.

Abrir un ticketDiscord