Cómo instalar plugins en Paper, Spigot y Purpur

Los plugins añaden funciones a tu servidor, como casas, reclamaciones, rangos o minijuegos, y se ejecutan solo en el servidor. Tus jugadores entran con el juego normal y no instalan nada. Los plugins funcionan en Paper, Purpur, Spigot y, los pocos que lo admiten, en Folia. Si tu servidor usa Fabric, Forge o NeoForge, necesitas mods en su lugar. Consulta Cómo instalar mods en Forge, Fabric y NeoForge. Para comparar los dos tipos, lee Los tipos de servidor de Minecraft explicados.

Los plugins tienen acceso total a tu servidor. Instala solo plugins de fuentes en las que confíes y haz antes un backup. Consulta Cómo hacer backups, restaurar y reiniciar tu mundo de Minecraft.

Instala un plugin desde la pestaña Modding

La pestaña Modding busca en varios catálogos de plugins a la vez y pone el archivo en la carpeta correcta por ti.

1. Abre tu servidor en el panel y haz clic en Modding.
2. Haz clic en la pestaña Plugins. Si no la ves, tu tipo de servidor no ejecuta plugins. La pestaña lo explica y nombra los tipos que sí.
3. Escribe el nombre del plugin en Buscar plugins y pulsa Enter. El menú Ordenar por puede ordenar los resultados por Más descargados o Actualizados recientemente.
4. Usa los filtros de la izquierda si los necesitas. Origen puede ser Todos los orígenes, Modrinth, CurseForge, Hangar, SpigotMC o Polymart. Versión de Minecraft empieza con la versión de tu propio servidor.
5. Haz clic en Instalar en la fila que quieras. El panel instala la build más reciente para la versión que muestra el filtro Versión de Minecraft, que empieza con la versión de tu servidor. Para conseguir una build más antigua, cambia ese filtro, o descarga tú el jar y súbelo, como se describe más abajo. Elige solo una versión que tu servidor pueda cargar.
6. Si el plugin necesita otros plugins para funcionar, se abre una ventana que los enumera, y su botón dice Instalar 2 archivos o algo parecido. Haz clic en él para instalar el plugin junto con lo que necesita.
7. Reinicia el servidor para que cargue el plugin. El panel no lo reinicia por ti tras una sola instalación. Consulta Cómo iniciar, detener, reiniciar y forzar la detención de tu servidor.

Los plugins solo se leen cuando arranca el servidor, así que un plugin que has instalado no hace nada hasta el reinicio.

Qué significan las insignias

Un plugin cuyo listado no nombra tu versión de Minecraft simplemente se instala, sin ningún aviso. A menudo funciona igualmente, pero revisa la Console después del reinicio.

Un servidor Paper acepta plugins listados para Paper, Spigot o Bukkit. Un servidor Purpur acepta esos también, además de los plugins listados para Purpur. Un servidor Spigot acepta plugins listados para Spigot o Bukkit, así que un plugin hecho solo para Paper no se instalará en él.

Instala un plugin subiendo el archivo

Usa esto para un plugin que hayas descargado tú, como uno que no esté en los catálogos.

1. Descarga el archivo .jar del plugin desde su página oficial. Hangar, el sitio de plugins del propio Paper, es el lugar que recomienda la documentación de Paper. Modrinth es otro buen sitio.
2. Abre tu servidor y haz clic en Files.
3. Abre la carpeta plugins.
4. Haz clic en Subir y elige el archivo .jar. Para muchos archivos, usa SFTP. Consulta Cómo conectarte a los archivos de tu servidor por SFTP.
5. Reinicia el servidor.

Pon el jar directamente dentro de plugins. La documentación de Paper dice que los plugins en subcarpetas de plugins no se cargan. Algunos plugins se venden en sitios que no permiten descargas automáticas. Esos tienes que descargarlos en tu navegador y subirlos tú.

Comprueba que el plugin se ha cargado

1. Abre la pestaña Console y mira el arranque. Busca el nombre del plugin y las líneas marcadas como errores. El filtro Errores muestra solo esas.
2. Cuando el servidor esté En línea, escribe plugins en la Console y pulsa Enter. Enumera los plugins que conoce el servidor. Consulta Cómo usar la consola y ejecutar comandos.

Si el plugin no aparece o la Console muestra un error que lo nombra, probablemente el plugin está hecho para otra versión de Minecraft o necesita antes otro plugin. Lee la página del propio plugin para ver qué necesita.

Cambia los ajustes de un plugin

La mayoría de los plugins crean una carpeta con su propio nombre dentro de plugins la primera vez que se ejecutan, normalmente con un config.yml. Ábrelo desde Files, edítalo, guarda y reinicia el servidor. La página Ajustes del panel no enumera los archivos de los plugins. Enumera los archivos propios del servidor, como Bukkit Settings, Spigot Settings y Purpur Settings, cuando existen.

Actualiza y quita plugins

1. Abre Modding, luego Plugins y después la vista Instalados.
2. Un plugin con una build más nueva muestra las dos versiones, como 2.9.1 → 2.12.1, y un botón Actualizar. Una barra de arriba ofrece actualizarlos todos a la vez. Actualizar reemplaza solo el archivo del plugin y no toca sus ajustes. El archivo antiguo se elimina cuando el nuevo está en su sitio.
3. Para quitar uno, abre su menú ... y haz clic en Desinstalar. Marca Eliminar también su configuración y sus datos solo si no vas a volver a usar el plugin. Borra la carpeta propia del plugin, que contiene sus ajustes y lo que guardó, como casas o reclamaciones.
4. Reinicia el servidor para que el cambio se aplique.

No tengas nunca dos versiones del mismo plugin en plugins. Puede que el servidor se niegue a cargar ninguna. El panel quita el archivo antiguo por ti cuando actualizas, pero un archivo que subiste a mano te toca quitarlo a ti.

Si el servidor no arranca después de un plugin

1. Abre Files, luego plugins, y borra el plugin más reciente que hayas añadido. Deja su carpeta de ajustes por si quieres recuperar el plugin.
2. Inicia el servidor. Si arranca, el plugin era la causa.
3. Si sigue fallando, restaura el backup que hiciste antes. Consulta Cómo crear, descargar y restaurar backups.

Para una lista de comprobación completa, lee Cómo arreglar un servidor que no arranca. Los plugins y el lag se tratan en Cómo reducir el lag de tu servidor de Minecraft.

Buenos plugins para empezar

Son plugins veteranos y muy usados, cada uno con su propia página en Modrinth o Hangar:

• LuckPerms gestiona rangos y permisos. Consulta Cómo darte op y gestionar permisos.
• EssentialsX añade los comandos del día a día, como casas y warps. Algunos plugins necesitan otro plugin instalado a su lado. El panel los enumera antes de instalar.
• WorldEdit edita rápido grandes partes del mundo, para constructores.

Lee la página de cada plugin para ver qué versiones de Minecraft admite antes de instalarlo.