Plugins y mods

Por qué un plugin «para 1.16» a veces funciona en 1.21

Revisado el 6 de septiembre de 2026 2 min de lectura

Los números de versión de los plugins son una guía aproximada, no un contrato. Que un plugin funcione depende de qué partes del servidor toca, y un plugin pequeño de hace cuatro años suele ser más fiable que uno grande del mes pasado.

Qué declara api-version

Todo plugin trae un plugin.yml, y dentro una línea que dice contra qué generación de la API del servidor se escribió. El servidor la lee y decide cómo tratarlo, incluido si aplicar conversión de compatibilidad para nombres de materiales y bloques antiguos. Un plugin sin api-version se trata como anterior a la 1.13, y por eso los plugins muy viejos a veces se portan raro en vez de fallar sin más.

Qué hace frágil a un plugin entre versiones

Usa¿Sobrevive a los cambios de versión?
Solo la API estándar del servidorNormalmente sí, durante años.
NMS o clases internas del servidorNo. Esas se reescriben entre versiones.
Manipulación de paquetesRara vez. Los cambios de protocolo lo rompen.
Nombres de materiales y bloquesCasi siempre, pero los renombrados existen.
Manejo de chat y componentesFrágil desde que llegó la firma de chat.

Juzgar un plugin antes de fiarte

  1. Lee la nota de compatibilidad del propio plugin

    Un plugin bien mantenido dice qué versiones admite. Esa afirmación vale más que el número de versión del nombre del archivo.

  2. Mira qué hace

    Un plugin que renombra prefijos del chat toca poco. Uno que añade entidades personalizadas lo toca todo. Calcula en consecuencia.

  3. Pruébalo antes en una copia

    «Carga sin errores» no es lo mismo que «funciona». Cárgalo y luego usa la función por la que lo instalaste.

  4. Mira la consola por avisos de obsolescencia

    El servidor te avisa cuando un plugin usa una API vieja. Eso es un aviso sobre el futuro, no un error de hoy, pero te nombra tu próxima migración.

«Cargó» no es compatibilidad

Un plugin puede arrancar limpio y lanzar un error la primera vez que se ejecuta una función concreta, que puede ser una semana después cuando la dispare un jugador. La consola al arrancar es una prueba floja; usar cada función una vez es una de verdad.

Prefiere plugins que declaren un rango de versiones

«Admite 1.20–1.21» es un proyecto mantenido. Una página de descarga que solo dice «Minecraft 1.16» y no se toca desde 2021 es un proyecto que vas a mantener tú, lo hubieras planeado o no.