15 Errores Comunes en Servidor Minecraft y Sus Soluciones

Administrar un servidor de Minecraft conlleva inevitablemente enfrentarse a errores. Desde el clásico OutOfMemoryError hasta plugins que no cargan correctamente, cada error tiene su solución. Esta guía cubre los 15 problemas más frecuentes con sus causas y soluciones paso a paso.

1 OutOfMemoryError — Server se Cae por Falta de RAM

Este es el error más común. El servidor se queda sin memoria RAM asignada y se cuelga.

Solución:

Aumenta el heap máximo en tu script de inicio. Para un servidor con 20 jugadores, usa al menos 4GB:

java -Xms2G -Xmx6G -jar paper.jar nogui

También activa el GC optimizado con flags de Aikar:

java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -jar paper.jar nogui

2 Connection Refused — No se Puede Conectar al Servidor

El jugador no puede unirse aunque el servidor esté encendido.

Causas y soluciones:

• Puerto no abierto: Abre el puerto 25565 (TCP) en el firewall de Windows/Linux y en el router
• IP incorrecta: Usa la IP externa del servidor, no la IP local (192.168.x.x)
• server.properties: Verifica que server-port=25565 está configurado
• online-mode bloqueando: Si usas BungeeCord, pon online-mode=false en los subservidores

3 Plugin No Carga — Error en la Consola al Iniciar

Causas más comunes:

• Versión incorrecta: Descarga la versión del plugin compatible con tu versión de Paper
• Dependencia faltante: El plugin requiere otro plugin (ej: Vault, LuckPerms). Instala las dependencias primero
• Archivo corrupto: Descarga el plugin de nuevo desde SpigotMC o Hangar oficial
• Conflicto de nombres: Verifica que no tienes dos versiones del mismo plugin en la carpeta

4 TPS Bajo — Lag Interno del Servidor

TPS significa "Ticks Per Second". Un servidor saludable corre a 20 TPS. Por debajo de 18 se nota lag.

Diagnóstico:

/tps       # Ver TPS actual
/timings report  # Generar informe de rendimiento

Soluciones:

• Reduce view-distance en server.properties a 6-8
• Activa simulation-distance=4 en paper.yml
• Instala plugins de optimización: ClearLag, EntityTrackerFixer
• Revisa si algún plugin específico consume muchos recursos con /timings
• Reduce la población de mobs: spawn-limits en bukkit.yml

5 Eula.txt — Servidor No Arranca

Solución:

Edita el archivo eula.txt en la carpeta del servidor y cambia:

eula=false  →  eula=true

6 Java Version — Versión Incorrecta de Java

Minecraft 1.21+ requiere Java 21. Versiones anteriores del servidor necesitan versiones específicas de Java.

• Minecraft 1.21+: Java 21
• Minecraft 1.17–1.20: Java 17
• Minecraft 1.12–1.16: Java 8 o 11

Descarga la versión correcta desde adoptium.net.

7 Config.yml Roto — YAML Inválido

Un error de indentación o carácter especial en un archivo de configuración YAML puede impedir que el plugin (o el servidor) cargue.

Solución:

• Usa yamlchecker.com para validar el archivo
• Asegúrate de usar espacios (no tabulaciones) para la indentación
• Los caracteres especiales como : { } [ ] deben ir entre comillas

8 Database Connection Failed — Error de MySQL

• Verifica host, puerto, usuario y contraseña en la config del plugin
• Asegúrate que MySQL está corriendo: systemctl status mysql
• Comprueba que el usuario tiene permisos para la base de datos
• En VPS, verifica que el puerto 3306 no esté bloqueado por firewall

9 World Corruption — Mundo Dañado

Ocurre cuando el servidor se apaga abruptamente sin guardar correctamente el mundo.

Prevención:

• Siempre usa /stop para apagar el servidor, nunca cierres la ventana
• Configura autoguardado frecuente: /save-on
• Haz backups diarios con scripts o plugins como EssentialsX backup

10 BungeeCord UUID Problem

• Pón online-mode=false en todos los servidores backend (no en BungeeCord)
• En BungeeCord config.yml, pon ip_forward: true
• En Paper, activa bungeecord: true en paper.yml

11 Too Many Open Files

El sistema operativo tiene un límite de archivos abiertos simultáneamente.

Solución (Linux):

ulimit -n 65536
# O permanente en /etc/security/limits.conf:
minecraft soft nofile 65536
minecraft hard nofile 65536

12 Permisos No Funcionan

• Verifica que LuckPerms está instalado y los grupos son correctos: /lp user <nombre> info
• Comprueba que la herencia del grupo está bien configurada
• Algunos comandos requieren op independientemente de LuckPerms
• Usa /lp verbose on para depurar permisos en tiempo real

13 Kicked for Flying

El servidor detectó movimiento de vuelo en un jugador legítimo (con lag o usando elytra).

• En server.properties: allow-flight=true si usas elytras
• Ajusta la sensibilidad del anticheat para elytra y creatividad
• Asegúrate de que el jugador tiene el permiso de vuelo si es admin

14 ChatEvent Deprecated (Paper 1.21)

Algunos plugins viejos usan el sistema de chat deprecado de Paper 1.19+.

• Actualiza el plugin en cuestión a su versión más reciente
• O en paper.yml añade: use-async-chat-event: true

15 Plugins Incompatibles Entre Sí

• Identifica el plugin conflictivo quitándolos uno a uno y reiniciando
• Revisa los logs de arranque: logs/latest.log
• Busca el conflicto en los foros de SpigotMC del plugin
• Verifica que todas las dependencias están en la misma versión