Cómo instalar plugins en tu servidor de Minecraft Paper, Spigot o Purpur

Los plugins son la forma de extender un servidor Paper, Spigot o Purpur con nuevos comandos, minijuegos, generación de mundos, herramientas anti-grief, sistemas de economía y casi cualquier otra cosa que se te ocurra. El proceso de instalación es el mismo para los tres: suelta un .jar en la carpeta plugins/, reinicia el servidor y configúralo. Esta guía te explica el flujo de trabajo en ServerPrism y señala los errores que suelen cometer los nuevos propietarios de servidores.

Asegúrate de que tu servidor pueda ejecutar plugins

Los plugins solo funcionan con software de servidor que implementa la API de Bukkit. Esto incluye Paper, Spigot, Purpur y Folia, pero no Minecraft vanilla, Forge, NeoForge o Fabric. Esos servidores con cargadores de mods utilizan mods (archivos .jar en mods/), que es un sistema diferente.

En ServerPrism, abre la pestaña Startup de tu servidor en el panel de control y confirma que la línea Server Jar dice algo como paper-X.X.jar, spigot-X.X.jar o purpur-X.X.jar. Si ves vanilla, forge o fabric en su lugar, los plugins no se cargarán; tendrías que reinstalarlo como Paper primero (Settings → Reinstall después de cambiar el egg).

También verifica que el plugin que deseas sea compatible con tu versión exacta de Minecraft. Un plugin creado para la versión 1.20 no siempre funcionará en la 1.21.

Encuentra un plugin

Estos son los principales lugares donde buscar:

• Modrinth — interfaz de usuario limpia, filtrado por versión, el estándar moderno.
• Hangar — el repositorio oficial de PaperMC.
• SpigotMC — el catálogo más grande, pero la calidad varía. Lee las reseñas.
• BukkitDev — más antiguo, pero aún aloja plugins no republicados en otros lugares.

En cada sitio, filtra por tu versión de Minecraft y descarga el .jar (o .zip si incluye configuraciones; extrae primero, necesitas el .jar).

Sube y carga el plugin

1. Inicia sesión en tu panel de control de ServerPrism y abre tu servidor.
2. Haz clic en File Manager en la barra lateral.
3. Abre la carpeta plugins/.
4. Arrastra el .jar a la carpeta o haz clic en Upload.
5. Reinicia el servidor desde la pestaña Console. Los plugins solo se detectan al iniciar.

Puedes instalar varios plugins a la vez; simplemente suelta varios archivos .jar antes de reiniciar.

Verifica que se haya cargado

Después de que el servidor se inicie, ejecuta /plugins en el chat del juego o en la pestaña Console del panel de control. El nombre del plugin debería aparecer en verde. Si está en rojo, el plugin no se cargó; abre el último registro en logs/latest.log y busca la primera línea ERROR. Por lo general, te indicará si tienes la versión incorrecta, una dependencia faltante o un tipo de servidor incompatible.

Configúralo

La mayoría de los plugins generan un config.yml dentro de plugins/<nombre-del-plugin>/ en el primer inicio. Edítalo a través del File Manager y reinicia el servidor para que los cambios surtan efecto.

Algunos plugins admiten /reload <nombre-del-plugin> para aplicar cambios sin un reinicio completo. Úsalo solo cuando la documentación del propio plugin lo recomiende explícitamente; se sabe que reload causa errores sutiles (controladores de eventos rotos, tareas filtradas) en plugins que no lo esperan.

Problemas comunes

• El plugin no aparece en /plugins: el software del servidor no es compatible con Bukkit (tienes Forge/Fabric/vanilla), o el .jar está corrupto o incompleto; vuelve a descargarlo.
• UnsupportedClassVersionError en la consola: el plugin fue compilado para una versión de Java más nueva de la que está ejecutando tu servidor. Verifica la versión de Java requerida por el plugin y cambia la imagen de Docker de tu servidor en la pestaña Startup (java_17, java_21).
• NoClassDefFoundError: falta un plugin de dependencia. La mayoría de los plugins enumeran sus dependencias en su página de descarga; instala también esos.
• Advertencias de incompatibilidad de versión: un plugin 1.20 en 1.21 podría "funcionar" pero fallar aleatoriamente. Usa la versión creada para tu versión de Minecraft.
• El servidor se retrasa después de la instalación: algunos plugins son pesados. Desactívalos uno a la vez (mueve el .jar fuera de plugins/, reinicia) para encontrar al culpable.

Plugins populares para empezar

• LuckPerms — permisos y rangos, utilizado por casi todos los servidores.
• EssentialsX — hogares, teletransportes, kits, conceptos básicos de economía. La caja de herramientas clásica.
• CoreProtect — registro de bloques y reversión, salvavidas para el griefing.
• WorldEdit + WorldGuard — protección de regiones y edición masiva de mundos.
• ViaVersion — permite que jugadores con clientes de Minecraft más antiguos se unan a tu servidor más nuevo.

Próximos pasos

Una vez que te sientas cómodo instalando plugins, configura un sistema de permisos con LuckPerms y acostúmbrate a hacer una copia de seguridad de tu directorio plugins/ antes de añadir algo nuevo; un plugin mal configurado puede borrar las configuraciones al apagarse. Las copias de seguridad se realizan con un solo clic desde la pestaña Backups de tu panel de control.