Cómo instalar plugins en tu servidor de Minecraft

Los plugins añaden funciones a tu servidor de Minecraft, como una economía, la protección de zonas, comandos o minijuegos. Esta guía te muestra cómo instalar plugins en Minecraft desde la página Plugins de OuiPanel, el panel de juego. También explica la instalación a mano, con el Gestor de archivos o por SFTP. Por último, trata la configuración, la actualización y la eliminación de un plugin.

---

Comprobar que tu servidor acepta plugins

Un plugin solo se instala en el servidor. Un mod se instala en el servidor y en el juego de cada jugador.

	Plugin	Mod
Instalación	solo en el servidor	en el servidor y en el jugador
Software	Paper, Spigot, Purpur	Forge, Fabric
Jugadores	no tienen que instalar nada	deben instalar los mismos mods
Carpeta	archivos .jar en /plugins	archivos .jar en /mods

Esta guía trata de los plugins. Para los mods, sigue la guía Cómo instalar mods en tu servidor de Minecraft (Forge/Fabric).

Los plugins solo funcionan con algunos programas de servidor.

Software	Plugins	Comentario
Paper	sí	recomendado por su rendimiento
Spigot	sí	buena opción
Purpur	sí	basado en Paper
Bukkit	sí	antiguo, mejor Paper
Vanilla	no	ningún plugin posible
Forge	no	usa mods
Fabric	no	usa mods
Mohist, Arclight	sí	mods de Forge y plugins juntos, menos estable
Bedrock	no	usa add-ons

Un servidor Fabric no carga plugins de Bukkit ni de Paper. Instala mods de Fabric o pasa el servidor a Paper.

Pasar un servidor Vanilla a Paper

1. En el menú lateral, abre Versiones/Modpacks › Gestor de Versiones.

2. En la columna Software, elige Paper y luego una Versión de Minecraft.

3. Haz clic en Instalar.

4. El panel te propone una copia de seguridad. Haz clic en Guardar y continuar o en Continuar sin copia de seguridad.

5. En la ventana «¿Cómo instalar esta versión?», elige Actualizar, sin borrar nada y luego Actualizar.

Tus mundos y tus configuraciones se conservan. El panel avisa de que cambia el tipo de software, de Vanilla a Plugins.

---

Instalar un plugin desde la página Plugins

La página Plugins busca en Modrinth, SpigotMC y Hangar e instala el plugin en /plugins por ti. Es el método más seguro, porque comprueba la compatibilidad con tu versión.

La página Plugins no está incluida en la oferta Minecraft gratuita. En esa oferta, usa el Gestor de archivos, como se explica más abajo.

Buscar el plugin

1. En el menú lateral, abre Plugins. La cabecera recuerda tu software y su versión, por ejemplo Paper 1.21.11.

2. En la pestaña Catálogo, escribe el nombre del plugin, por ejemplo LuckPerms, y haz clic en Buscar.

3. Si hace falta, filtra por fuente: Todas las fuentes, Modrinth, Hangar, Editores oficiales o SpigotMC. La casilla Ocultar los plugins incompatibles viene marcada.

Cada tarjeta indica la fuente, el número de descargas y las versiones de Minecraft compatibles. Una etiqueta resume la compatibilidad.

Etiqueta	Significado
Compatible	la versión del plugin declara tu versión de Minecraft
Probablemente compatible	el plugin declara la misma serie que tu servidor, pero no exactamente tu versión
No verificado	SpigotMC no publica huellas, así que el archivo no se puede verificar

El botón Ver la página abre la ficha del plugin en su fuente.

Confirmar la instalación

1. En la tarjeta del plugin, haz clic en Instalar.

2. Si el panel te pide la versión, elígela en la lista Versión y haz clic en Continuar.

3. Lee la ventana de confirmación. Indica el archivo que se coloca en /plugins y las Dependencias obligatorias del plugin.

4. Haz clic en Instalar.

5. Reinicia el servidor. Los plugins solo se cargan al arrancar.

---

Gestionar los plugins instalados

La pestaña Instalados muestra los plugins de /plugins con su versión, su fuente y su estado Activo o Desactivado. También avisa de las actualizaciones.

• Actualizar instala la última versión compatible. Actualizar todo se ocupa de todos los plugins a la vez. La versión anterior se guarda en /plugins/.ouipanel/backup.

• Desactivar deja el plugin de lado sin borrarlo. Activar lo vuelve a poner en marcha.

• Eliminar quita el archivo .jar de /plugins.

• Actualizar, arriba a la derecha, vuelve a leer la carpeta, por ejemplo después de añadir un archivo a mano.

La tarjeta Versiones guardadas muestra esas versiones anteriores. El panel guarda como máximo 3 por plugin, durante 30 días, y Volver atrás reinstala una de ellas. Mostrar el historial recoge las instalaciones, actualizaciones y eliminaciones.

Después de cada cambio, reinicia el servidor para aplicarlo.

---

Instalar un plugin a mano

Este método sirve para un plugin que no está en el catálogo, o en la oferta gratuita.

Descargar el plugin

Descarga los plugins solo desde fuentes de confianza.

Sitio	Dirección	Descripción
SpigotMC	spigotmc.org/resources	la mayor biblioteca de plugins
Modrinth	modrinth.com/plugins	plataforma reciente, plugins verificados
Hangar (PaperMC)	hangar.papermc.io	plugins para Paper
Bukkit	dev.bukkit.org	histórico, sigue activo

1. Busca el plugin, por ejemplo EssentialsX.

2. Comprueba que admite tu versión de Minecraft.

3. Apunta sus dependencias, por ejemplo Vault para los plugins de economía.

4. Haz clic en Download para obtener el archivo .jar.

No descargues nunca un plugin desde un sitio no oficial o un enlace de Discord dudoso. El archivo puede contener malware.

Para elegir tus plugins según lo que necesitas, la página Plugins de Minecraft presenta una selección.

Colocar el archivo en la carpeta plugins

1. En el menú lateral, abre Gestor de archivos y luego la carpeta plugins.

2. Arrastra el archivo .jar desde tu ordenador a la página. No hay botón de subida.

3. Suelta el archivo cuando aparezca el aviso «Arrastra tus archivos aquí» y espera a que termine la subida.

El plugin aparece en la lista de archivos. El arrastre admite 100 MB por archivo como máximo.

¿Todavía no existe la carpeta plugins? Arranca el servidor una vez con Paper o Spigot y luego detenlo. La carpeta se crea al arrancar.

Por SFTP para un archivo de más de 100 MB

1. Conéctate por SFTP con FileZilla. La guía Cómo conectarse por SFTP con FileZilla explica cómo hacerlo.

2. Abre la carpeta /plugins.

3. Arrastra a ella el archivo .jar.

4. Reinicia el servidor.

Reiniciar y comprobar

1. En Consola, haz clic en Reiniciar y espera a que el servidor esté en marcha.

2. En el registro, comprueba que el plugin se carga.

[Server] [INFO] [EssentialsX] Enabling EssentialsX v2.20.1
[Server] [INFO] [EssentialsX] Essentials: Using 1.20.4+ Provider as support

En el juego, escribe uno de estos comandos para ver la lista de plugins.

/plugins

/pl

Un plugin en verde está activo. Un plugin en rojo está desactivado o tiene un error.

En la consola de OuiPanel, escribe el comando sin la barra: plugins.

---

Configurar un plugin

La mayoría de los plugins crean su carpeta de configuración en el primer arranque. Tras el reinicio, la carpeta plugins se parece al ejemplo siguiente.

plugins/
├── EssentialsX.jar          <- el plugin
├── EssentialsX/             <- carpeta de configuración
│   ├── config.yml           <- configuración principal
│   ├── messages.properties  <- mensajes personalizables
│   └── ...
├── LuckPerms.jar
├── LuckPerms/
│   └── config.yml
└── ...

1. En el Gestor de archivos, abre la carpeta del plugin.

2. Haz clic en config.yml. Se abre la ventana «Edición de config.yml».

3. Cambia los ajustes que necesites.

4. Haz clic en Guardar.

5. Reinicia el servidor para aplicar los cambios.

Algunos plugins admiten /reload o su propio comando de recarga, lo que evita un reinicio completo.

Para configurar rangos y permisos, sigue la guía Cómo configurar LuckPerms en un servidor Minecraft.

---

Si un plugin no se carga

Problema	Solución
Versión incompatible	comprueba que el plugin admite tu versión de Minecraft
Dependencia que falta	instala los plugins necesarios, por ejemplo Vault
Carpeta equivocada	el archivo .jar debe estar en /plugins, no en una subcarpeta
Archivo dañado	vuelve a descargar el plugin desde su fuente oficial
Servidor Vanilla	pásate a Paper o Spigot

El plugin aparece en rojo en /plugins

Abre Consola para leer el error exacto.

[Server] [ERROR] Could not load 'plugins/MonPlugin.jar'
[Server] [ERROR] java.lang.UnsupportedClassVersionError...

Error	Significado	Solución
UnsupportedClassVersionError	versión de Java demasiado antigua	cambia la Versión del sistema en Configuración › Parámetros del servidor
NoClassDefFoundError: Vault	dependencia que falta	instala Vault
Plugin already initialized	plugin duplicado	elimina los duplicados
Invalid plugin.yml	plugin dañado o mal compilado	vuelve a descargarlo

Conflicto entre plugins

Si el servidor se cuelga o va lento tras una instalación, sigue estos pasos en orden.

1. Detén el servidor.

2. Elimina o desactiva el último plugin instalado.

3. Arranca el servidor.

4. Comprueba si el problema sigue.

5. Consulta la página del plugin para ver las incompatibilidades conocidas.

El plugin no funciona bien

1. Revisa su configuración en config.yml.

2. Consulta la wiki o la documentación del plugin.

3. Revisa los permisos, por ejemplo en LuckPerms.

4. Prueba con derechos de operador: /op TuUsuario.

---

Eliminar un plugin

Lo más sencillo es pasar por la pestaña Instalados de la página Plugins.

1. Haz clic en Eliminar junto al plugin.

2. Deja marcada Guardar una copia del .jar (recomendado) si quieres poder volver atrás.

3. Marca Eliminar también la carpeta de configuración solo si no piensas reinstalarlo.

4. Confirma y reinicia el servidor.

A mano, detén el servidor, elimina el archivo .jar de plugins desde el Gestor de archivos y arranca el servidor. La carpeta de configuración del plugin puede quedarse.

Conserva la carpeta de configuración si piensas reinstalar el plugin más adelante.

---

Buenas prácticas

Antes de instalar un plugin, toma estas precauciones.

• Comprueba que admite tu versión de Minecraft.

• Lee las opiniones y la nota en SpigotMC.

• Mira la fecha de su última actualización. Un plugin abandonado acaba fallando.

• Lee la lista de sus dependencias.

• Crea una copia en Copias de seguridad antes de instalar un plugin grande.

Después, mantenlos al día.

• Actualiza tus plugins con regularidad.

• Vigila el rendimiento (TPS) tras cada instalación.

• Elimina los plugins que ya no usas.

• Apunta qué plugins tienes instalados y para qué sirven.

---

¿Necesitas ayuda?

Abre un ticket desde Tickets › Abrir un ticket, o desde el recuadro Contactar con el soporte al pie de la ficha de tu servidor en el área de cliente. También puedes preguntar en el Discord de OuiHeberg.

Abrir un ticketDiscord