Cómo instalar plugins en un servidor Minecraft con Paper

Instalar plugins en un servidor Minecraft con Paper consiste en descargar el archivo .jar compatible, detener el servidor, subirlo directamente a la carpeta plugins y volver a iniciarlo. Después debes comprobar la consola y usar /plugins para confirmar que se ha cargado correctamente.

El proceso es sencillo, pero conviene hacerlo con orden. Un archivo para otra versión, una dependencia ausente o dos copias del mismo plugin pueden impedir que arranque.

Antes de instalar un plugin

Comprueba estas cuatro cosas:

1. El servidor usa Paper. Un servidor Vanilla no carga plugins. Spigot y Bukkit tienen un ecosistema compatible en muchos casos, pero esta guía está pensada para Paper.
2. El plugin es compatible con tu versión de Minecraft. Revisa la página de descarga y las notas de la versión. No des por hecho que un plugin antiguo funcionará en una versión nueva.
3. Has descargado el archivo desde una fuente fiable. Prioriza la web oficial del proyecto, Hangar, Modrinth o SpigotMC. Evita páginas que vuelven a subir archivos sin indicar su origen.
4. Tienes una copia de seguridad. Antes de cambiar plugins importantes, guarda el mundo y la configuración. Puedes seguir nuestra lista de backups para servidores Minecraft.

Si aún estás eligiendo extensiones, consulta primero nuestros plugins imprescindibles para servidores Minecraft. Es mejor empezar con pocos plugins útiles que instalar veinte a la vez.

Cómo instalar plugins en Paper paso a paso

1. Descarga el archivo correcto

Descarga la versión del plugin que indique compatibilidad con tu versión de Minecraft y Paper. El archivo que necesita el servidor suele terminar en .jar.

Si la descarga es un .zip, lee las instrucciones del proyecto antes de subirlo. A veces el ZIP contiene documentación o varios archivos y debes extraer el JAR correcto.

Revisa también si el plugin necesita una dependencia. Por ejemplo, algunos complementos requieren Vault, ProtocolLib u otro plugin para funcionar.

2. Detén el servidor

Detén el servidor desde el panel y espera a que la consola confirme el apagado. No reemplaces archivos mientras Paper está guardando el mundo.

Un apagado completo reduce el riesgo de archivos incompletos y evita que una versión antigua del plugin quede cargada en memoria.

3. Sube el JAR a la carpeta plugins

Abre el gestor de archivos del servidor, entra en plugins y sube ahí el .jar. El archivo debe quedar directamente dentro de esa carpeta, no en una subcarpeta.

La ruta debería tener este aspecto:

/plugins/NombreDelPlugin.jar

Si no existe la carpeta plugins, inicia Paper una vez y vuelve a detenerlo. Paper crea sus carpetas durante el primer arranque.

4. Inicia de nuevo el servidor

Arranca el servidor y observa la consola. Durante el inicio, Paper detecta los JAR, comprueba sus dependencias y habilita los plugins válidos.

Usa un reinicio completo. /reload no es una forma segura de sustituir plugins en un servidor activo y puede dejar tareas, comandos o configuraciones en un estado extraño.

5. Comprueba que el plugin está activo

Cuando el servidor termine de arrancar, ejecuta:

/plugins

También puedes escribir plugins en la consola. Un plugin habilitado suele aparecer en verde; uno deshabilitado o que no ha podido cargar puede aparecer en rojo.

No te quedes solo con la lista. Busca mensajes WARN o ERROR relacionados con el plugin en la consola o en logs/latest.log. El registro normalmente indica si falta una dependencia, si el JAR no es válido o si la versión no es compatible.

Configura y prueba el plugin

Muchos plugins crean una carpeta propia dentro de plugins después del primer inicio:

/plugins/NombreDelPlugin/

Ahí suelen estar config.yml, archivos de mensajes y datos del plugin. Detén el servidor antes de hacer cambios importantes, respeta la indentación YAML y guarda una copia del archivo original.

Después de configurar:

1. reinicia el servidor;
2. revisa la consola;
3. prueba los comandos con una cuenta sin OP;
4. confirma que los jugadores normales solo tienen los permisos necesarios.

Para organizar grupos y permisos, sigue nuestra guía básica de LuckPerms.

Errores frecuentes al instalar plugins

Problema	Causa probable	Qué hacer
El plugin no aparece	El JAR está en una subcarpeta, sigue comprimido o no es un plugin	Coloca el .jar directamente en plugins y reinicia
Aparece en rojo	Falta una dependencia o la versión no es compatible	Revisa logs/latest.log y la página del plugin
El servidor no arranca	JAR incorrecto, dependencia rota o conflicto	Retira el último plugin, arranca y revisa el error completo
Sale “ambiguous plugin name”	Hay dos versiones del mismo plugin	Deja un solo JAR y reinicia
El comando existe, pero el jugador no puede usarlo	Faltan permisos	Configura el nodo correspondiente con LuckPerms
No existe la carpeta plugins	El servidor no usa Paper o aún no ha arrancado	Verifica el software e inicia Paper una vez

Evita cambiar varios plugins al mismo tiempo. Si instalas uno, reinicias y pruebas, sabrás exactamente qué cambio causó un problema.

Cómo actualizar o eliminar un plugin

Para actualizarlo:

1. crea un backup;
2. detén el servidor;
3. retira el JAR antiguo;
4. sube la nueva versión compatible;
5. asegúrate de que no quedan dos copias;
6. inicia y revisa la consola.

Normalmente debes conservar la carpeta de configuración, aunque siempre conviene leer las notas de actualización por si cambia algún ajuste.

Para eliminar un plugin, detén el servidor, borra su JAR y vuelve a iniciarlo. No borres su carpeta de datos hasta confirmar que no necesitas recuperar su configuración.

Plugins y mods no son lo mismo

Paper carga plugins creados para las API de Paper, Bukkit o Spigot. Los mods de Fabric, Forge o NeoForge utilizan cargadores distintos y no funcionan simplemente colocándolos en plugins.

Si quieres usar un modpack, elige el software adecuado y comprueba si los jugadores también deben instalar los mods. Si quieres añadir comandos, permisos, protección o herramientas de administración sin modificar el cliente, Paper suele ser la opción más directa.

Checklist final

• Paper está seleccionado como software del servidor.
• El JAR procede de una fuente fiable y coincide con tu versión.
• Has revisado las dependencias.
• Existe un backup reciente.
• El archivo está directamente en plugins.
• Has hecho un reinicio completo, no /reload.
• /plugins y logs/latest.log confirman que ha cargado.
• Has probado comandos y permisos con una cuenta normal.

En Mineando puedes gestionar los archivos y la consola desde el panel. Instala primero un plugin, comprueba que funciona y añade el siguiente solo cuando la base sea estable. Ese ritmo evita casi todos los problemas difíciles de diagnosticar.

La referencia técnica principal para este proceso es la documentación de plugins de Paper.