¿Qué Java necesita tu servidor de Minecraft? (Java 25 para 26.x)

Un servidor de Minecraft es un programa Java, y Java viene en versiones que no siempre se llevan bien. Mojang sube la versión requerida cada pocos años, y cada vez una parte de los servidores se estrella contra un mensaje de error que no parece decir nada sobre Java. Desde Minecraft 26.1 la exigencia es Java 25; un servidor en 1.20.4 necesita Java 17, y un modpack nostálgico en 1.12.2 quiere Java 8. Este artículo da la tabla completa, muestra cómo reconocer el error y cómo cambiar de versión de Java sin que tu mundo ni tus plugins se vean afectados.

La tabla: versión de Minecraft y Java correspondiente

• 1.12.2 y anteriores: Java 8. Las Java más nuevas normalmente no funcionan con el Forge de esa época.
• 1.13 a 1.16.5: Java 8 es la base; Java 11 suele funcionar también, pero los modpacks de Forge de ese periodo van más seguros en 8.
• 1.17: Java 16 como mínimo.
• 1.18 a 1.20.4: Java 17 como mínimo. Java 21 suele funcionar en Paper, pero plugins antiguos y versiones de Forge pueden tropezar.
• 1.20.5 a 1.21.x: Java 21 como mínimo.
• 26.1, 26.2 y 26.3: Java 25 como mínimo. Es la exigencia actual; quien siga en 1.21 y quiera actualizar tiene por delante una actualización de Java además de una versión nueva del servidor.

La regla: usa la versión mínima que exige Mojang o la siguiente versión LTS por encima. Una Java más antigua que la exigida no funciona nunca; una mucho más nueva a veces no funciona con plugins o mods que se apoyan en las entrañas de Java.

Reconocer el mensaje de error

El mensaje clásico de una Java demasiado antigua es java.lang.UnsupportedClassVersionError: ... has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0. El número tras «class file version» revela la exigencia: 52 es Java 8, 61 es Java 17, 65 es Java 21, 69 es Java 25. Si ves una línea así en la consola, el servidor corre con una Java demasiado antigua.

La situación inversa — una Java demasiado nueva — es más difícil de reconocer. Forge 1.12 o 1.16 se cae entonces con mensajes como ClassCastException, module java.base does not export o Unable to make ... accessible. También ahí la solución no es el mod, sino la versión de Java.

Comprobar tu versión de Java

En la consola del servidor, al arrancar suele aparecer una línea como Starting minecraft server version 26.2 seguida de información del entorno; Paper indica la versión de Java expresamente en las primeras líneas. En un servidor alojado eliges la versión en el panel, y el comando java -version en una sesión SFTP o de consola muestra la activa. En MC-Node eliges Java por servidor en el panel: cambiar la versión de Java. En un VPS instalas tú la versión deseada; la guía es instalar Java en tu VPS.

Cambiar de Java sin daños

Cambiar de Java no toca tu mundo: la partida guardada, los plugins y la configuración son independientes del entorno de ejecución. Lo que puede fallar es un plugin o un mod que dependía de la Java antigua. Hazlo así:

1. Haz copia de toda la carpeta del servidor.
2. Para el servidor, cambia la versión de Java en el panel (o en el VPS) y arranca de nuevo.
3. Lee las treinta primeras líneas de la consola: los errores de Java aparecen ahí, no a mitad.
4. Prueba los plugins más integrados en el servidor: permisos, economía, gestión del mundo.
5. Si algo falla, vuelve atrás; el mundo está intacto.

Java 25 y las versiones 26.x: qué cambia

Desde 26.1 el servidor corre en Java 25, y 26.2 y 26.3 mantienen esa exigencia. Quien ya está en 26.2 no cambia nada de Java para 26.3. Quien viene de 1.21 tiene que hacer dos cosas a la vez: actualizar el entorno Java y pasar el software del servidor y los plugins a una versión 26.x. No lo hagas el día del lanzamiento: Paper, Purpur y los plugins grandes suelen necesitar una semana tras una versión nueva de Minecraft. Qué cambia en la propia 26.3 y qué datapacks se rompen está en Minecraft 26.3 y tu servidor.

Java en un VPS: varias versiones a la vez

Si tienes varios servidores en un VPS, a menudo quieres dos versiones de Java a la vez: 17 para un modpack antiguo y 25 para un servidor 26.x. Se hace sin complicaciones instalando cada versión en su propia carpeta (por ejemplo con los paquetes de Adoptium o de la distribución) y usando en el script de arranque de cada servidor la ruta completa al java correcto en lugar del comando a secas. Así decide el script qué versión recibe cada servidor, y no el valor por defecto del sistema. Eso sí, comprueba tras una actualización del sistema que la Java por defecto no haya cambiado; un apt upgrade puede mover el enlace simbólico y el servidor arranca con la versión equivocada.

Memoria y opciones de Java

Además de la versión, la configuración de Java determina cuánta memoria puede usar el servidor: las opciones -Xms y -Xmx fijan el mínimo y el máximo. En un servidor alojado lo gestiona el panel según la RAM de tu plan; en un VPS lo ajustas tú y dejas alrededor de 1 GB para el sistema operativo. Las conocidas «Aikar's flags» para el recolector de basura siguen funcionando muy bien en Java 21 y 25 y evitan los tirones que da una configuración por defecto en mundos grandes.

En resumen

• 26.x: Java 25. 1.20.5 a 1.21: Java 21. 1.18 a 1.20.4: Java 17. 1.17: Java 16. 1.16 y anteriores: Java 8.
• «class file version 69» en el error significa: el servidor quiere Java 25.
• Cambiar no toca tu mundo; haz copia de todos modos y lee las primeras líneas de la consola.
• Actualiza Java antes de pasar a 26.x, pero no el día del lanzamiento de una versión nueva de Minecraft.
• Hosting Minecraft barato: en qué fijarse de verdad al comparar
• Ganar dinero con tu servidor de Minecraft: lo que permite la EULA