Cómo instalar plugins en un servidor de Minecraft

Para instalar plugins en un servidor de Minecraft necesitas ejecutar Paper, Spigot u otro software compatible con la API de Bukkit. El proceso básico consiste en descargar el archivo .jar, colocarlo en la carpeta plugins y reiniciar el servidor, pero conviene comprobar antes su procedencia, versión y dependencias.

En esta guía aprenderás a hacerlo con seguridad, a elegir una base razonable de plugins y a localizar el causante cuando el servidor deja de arrancar.

Plugin y mod no son lo mismo

Un plugin amplía las funciones del servidor mediante la API proporcionada por Paper, Spigot o Bukkit. Puede añadir permisos, comandos, protección de terrenos, registros de bloques o minijuegos sin modificar el programa de Minecraft que utiliza cada jugador.

Un mod, en cambio, altera el juego mediante un cargador como Fabric, NeoForge o Forge. Algunos mods son exclusivamente de servidor, pero muchos añaden bloques, objetos, interfaces o mecánicas que también deben existir en el cliente.

La diferencia práctica es importante: si instalas LuckPerms o GriefPrevention en Paper, los jugadores pueden seguir entrando con un cliente normal de Minecraft. El servidor aplica las reglas y envía al cliente información que este ya sabe representar.

Un plugin puede simular objetos personalizados mediante paquetes de recursos, entidades o elementos existentes, pero eso no equivale a registrar un bloque nuevo en el juego. Si quieres contenido completamente nuevo y lógica compartida entre servidor y cliente, probablemente necesitas mods.

Paper o Spigot: cuál elegir

Spigot es una implementación veterana de la API de Bukkit. Paper parte de ese ecosistema, mantiene compatibilidad con la mayoría de sus plugins y añade mejoras de rendimiento, configuración y funciones para desarrolladores. Para un servidor nuevo, Paper suele ser la opción más práctica, salvo que un plugin concreto exija expresamente otra plataforma.

Antes de cambiar el software de un servidor existente, realiza una copia de seguridad completa. El directorio debe incluir los mundos, la carpeta plugins y los archivos de configuración. Detén siempre el servidor antes de copiar o modificar esos datos.

Dónde descargar plugins con seguridad

Descarga cada plugin desde su página oficial o desde un repositorio reconocido. Entre las fuentes habituales están Hangar de PaperMC, Modrinth, SpigotMC Resources y el repositorio oficial del desarrollador en GitHub.

Antes de descargar, revisa estos datos:

• Autor y proyecto: comprueba que coincidan con la web o documentación oficial.
• Plataforma: la descarga debe indicar Paper, Spigot o Bukkit, no solo Fabric o NeoForge.
• Versiones admitidas: busca tu versión exacta de Minecraft o una declaración explícita de compatibilidad.
• Actividad: revisa la fecha de publicación, los cambios recientes y las incidencias abiertas.
• Dependencias: algunos plugins necesitan otros, como Vault, ProtocolLib o una biblioteca propia.
• Contenido de la descarga: si recibes un ZIP, ábrelo y sigue las instrucciones; no cambies su extensión a .jar.

Evita páginas de reenvío, recopilaciones sin autor identificado y copias de plugins de pago. Un plugin se ejecuta con acceso a los archivos y recursos del proceso del servidor, por lo que un JAR malicioso supone un riesgo real. Conserva además una copia del enlace y de la versión descargada para poder reproducir la instalación.

Cómo instalar un plugin paso a paso

1. Comprueba la versión de Minecraft y la compilación de Paper o Spigot que utiliza el servidor.
2. Lee los requisitos del plugin y descarga la variante correcta.
3. Detén el servidor con el botón del panel o con el comando stop.
4. Haz una copia de seguridad de los mundos y de la configuración.
5. Sube el archivo .jar al nivel superior de la carpeta plugins.
6. Arranca el servidor y espera hasta que aparezca el mensaje de inicio completado.
7. Revisa la consola y confirma que el plugin se ha habilitado.

La estructura habitual queda así:

servidor/
├── paper.jar
├── server.properties
├── logs/
│   └── latest.log
├── plugins/
│   └── LuckPerms-Bukkit.jar
└── world/

Los JAR deben estar directamente dentro de plugins. Paper no busca plugins guardados en subcarpetas creadas para organizarlos. Si utilizas un panel de alojamiento, puedes subirlos desde su gestor de archivos o mediante SFTP. Los servidores de juegos de Overclock Host parten de 2,50 € al mes y cuentan con soporte 24/7.

No instales o actualices plugins mientras el servidor está funcionando. Tampoco uses comandos de recarga general como /reload: pueden dejar tareas, permisos y referencias en un estado incoherente. Haz un reinicio completo.

Primer arranque y generación de configuraciones

En el primer arranque, la mayoría de plugins crea una subcarpeta con su nombre:

plugins/
├── LuckPerms-Bukkit.jar
└── LuckPerms/
    ├── config.yml
    └── luckperms-h2-v2.mv.db

El nombre y los archivos dependen del plugin. Algunos generan una configuración YAML; otros utilizan JSON, TOML o una base de datos local. Espera a que el servidor termine de arrancar y detenlo correctamente antes de editar esos archivos.

Al modificar YAML, respeta la sangría y utiliza espacios, no tabuladores. Una opción mal indentada puede impedir que el plugin cargue. Cambia pocas cosas cada vez, conserva una copia del archivo original y consulta la documentación para conocer los valores admitidos.

Después del reinicio, comprueba el estado desde la consola:

plugins
version
version LuckPerms

Dentro del juego, los comandos equivalentes llevan una barra inicial. El comando /plugins suele mostrar en verde los plugins habilitados y en rojo los que no han podido activarse. Necesitarás permisos de operador o el permiso administrativo correspondiente.

Plugins imprescindibles para empezar

No existe una lista universal. Instala solo aquello que vayas a configurar y mantener. Una base pequeña reduce conflictos y facilita las actualizaciones.

LuckPerms evita depender del nivel de operador para la administración cotidiana. GriefPrevention encaja bien cuando quieres que los jugadores gestionen sus parcelas, mientras que WorldGuard resulta más adecuado para un spawn, una arena o regiones controladas por el equipo.

CoreProtect complementa la protección: no impide todos los daños, pero aporta un historial para saber quién cambió un bloque y restaurar acciones concretas.

Qué instalar como «anti-lag»

No instales un complemento genérico que elimine objetos o criaturas periódicamente y esperes que resuelva cualquier problema. Puede alterar mecánicas sin corregir la causa. Empieza midiendo con spark, revisa las distancias de simulación y visión, limita aquello que el informe identifique y pregenera el mapa con Chunky si la generación de terreno provoca picos.

Paper ya incluye ajustes de rendimiento. Cambiarlos sin medir puede perjudicar granjas, aparición de criaturas o carga de chunks. Haz una modificación cada vez y compara el resultado.

Cómo comprobar la compatibilidad

No basta con que el archivo se llame «Bukkit» o que funcionase en una versión anterior. Comprueba cuatro capas:

1. Minecraft: la página del plugin debe admitir la versión de tu servidor.
2. Plataforma: confirma que funciona en Paper o Spigot. Un plugin exclusivo de Folia o Velocity no es intercambiable.
3. Java: tanto Paper como algunos plugins requieren versiones concretas de Java.
4. Dependencias: instala la versión compatible de cada biblioteca requerida.

La versión del servidor aparece al ejecutar:

version
java -version

El segundo comando se ejecuta en la terminal del sistema, no en la consola de Minecraft. No interpretes «1.21» como compatibilidad automática con todas sus revisiones. Los cambios internos entre versiones pueden romper plugins que acceden a componentes no estables.

Antes de actualizar producción, crea una copia del servidor y prueba allí la nueva combinación de Paper, Java y plugins. Nunca abras con una versión antigua un mundo que ya haya sido guardado por una versión nueva.

Cómo diagnosticar un plugin que rompe el arranque

El registro principal se encuentra en logs/latest.log. Empieza por la primera línea marcada como ERROR o SEVERE relacionada con la carga del plugin, no por la última excepción del archivo. Los errores posteriores pueden ser simples consecuencias.

[Server thread/ERROR]: Could not load 'plugins/Ejemplo.jar'
org.bukkit.plugin.UnknownDependencyException: Unknown dependency Vault

Este ejemplo indica una dependencia ausente: hay que instalar la versión correcta de Vault. Otros mensajes frecuentes son:

• UnsupportedClassVersionError: el plugin fue compilado para una versión de Java más nueva.
• InvalidPluginException: el JAR no es válido, está dañado o no corresponde a esta plataforma.
• UnknownDependencyException: falta otro plugin obligatorio.
• NoSuchMethodError: suele existir una incompatibilidad entre versiones del plugin, del servidor o de una biblioteca.
• YAMLException: algún archivo de configuración tiene una sintaxis incorrecta.

Busca el nombre del plugin en las primeras líneas de la traza y anota el mensaje que aparece después de Caused by:. Después comprueba su documentación, versión y dependencias.

Si el registro no identifica claramente al culpable, detén el servidor, haz una copia y retira temporalmente la mitad de los plugins. Arranca de nuevo: si el error continúa, el causante está en la mitad instalada; si desaparece, está en la retirada. Repite el proceso manteniendo juntas las dependencias hasta aislar el JAR problemático.

Cuando solicites ayuda, aporta la versión exacta de Paper o Spigot, la versión de Java, la lista de plugins, el registro desde el comienzo del arranque y los cambios realizados. Si necesitas asistencia con la puesta en marcha, puedes contactar con Overclock Host.

Preguntas frecuentes

¿Los jugadores deben instalar los plugins?

No. Los plugins se ejecutan en Paper o Spigot y, normalmente, el jugador entra con el cliente estándar. Solo necesitará una descarga adicional si el servidor exige un paquete de recursos o si realmente utiliza mods de cliente.

¿Puedo instalar un plugin sin reiniciar?

No es recomendable. Detén el servidor, copia el JAR y vuelve a arrancarlo. Las recargas pueden dejar tareas o datos antiguos en memoria y no sustituyen un inicio limpio.

¿Por qué el plugin no aparece en la lista?

Comprueba que sea un archivo .jar, que esté directamente en plugins y que el proceso use ese directorio como raíz. Después revisa logs/latest.log por si el archivo fue rechazado.

¿Se pueden usar plugins de Spigot en Paper?

La mayoría funciona porque Paper mantiene compatibilidad con la API de Bukkit y Spigot, pero no está garantizado para todos. Consulta la página del proyecto y prueba la versión exacta antes de desplegarla.

¿Cuántos plugins puede soportar un servidor?

No existe un número útil como límite general. Influyen la calidad de cada plugin, sus tareas, la cantidad de jugadores, los mundos y la configuración. Mide el servidor con spark y decide según el consumo real, no según el número de JAR.