Base de conocimientos

¿Cómo actualizo un plugin sin perder su configuración?

¿Cómo actualizo un plugin sin perder su configuración?

Actualizar un plugin normalmente es muy sencillo. En la mayoría de los casos, solo necesitas reemplazar el archivo .jar del plugin por la nueva versión.

La configuración del plugin se guarda en una carpeta separada, por lo que puedes actualizar el archivo del plugin sin eliminar tus ajustes, permisos o configuraciones personalizadas.

???? Importante:

Para conservar tu configuración, reemplaza únicamente el archivo .jar del plugin y no elimines su carpeta de configuración.

¿Cómo están organizados los archivos de un plugin?

Normalmente, un plugin tiene su archivo .jar dentro de plugins/ y una carpeta independiente donde guarda su configuración y datos.

Por ejemplo:

plugins/
├── MiPlugin.jar
└── MiPlugin/
    ├── config.yml
    ├── messages.yml
    └── data.yml

El archivo:

MiPlugin.jar

contiene el plugin, mientras que la carpeta:

plugins/MiPlugin/

normalmente contiene su configuración y otros datos.

Por eso, para actualizarlo, normalmente solo debes sustituir el .jar.


Paso 1: Descarga la nueva versión

Descarga la versión más reciente del plugin desde su página oficial o desde una fuente de confianza.

Antes de actualizar, comprueba que la nueva versión sea compatible con:

  • Tu versión de Minecraft.
  • El software de tu servidor, como Paper, Spigot o Purpur.
  • Las dependencias que utiliza el plugin.
⚠️ No actualices a ciegas:

Una versión más reciente del plugin no siempre es compatible con todas las versiones de Minecraft. Revisa siempre los requisitos de la nueva versión.

Paso 2: Detén el servidor

Antes de reemplazar el plugin, detén completamente tu servidor desde la Console de EterHosting.

Espera hasta que el servidor aparezca como:

Offline

No recomendamos reemplazar plugins mientras el servidor está funcionando.


Paso 3: Realiza una copia de seguridad de la configuración

Aunque normalmente la configuración se conserva al actualizar un plugin, recomendamos realizar una copia de seguridad antes de hacerlo.

Desde el administrador de archivos de EterHosting, localiza la carpeta del plugin:

plugins/MiPlugin/

Puedes descargar una copia de esta carpeta o comprimirla como .zip para poder restaurarla en caso de que la nueva versión modifique el formato de configuración.

✅ Recomendación:

Especialmente antes de una actualización importante, guarda una copia de plugins/MiPlugin/.

Paso 4: Abre la carpeta plugins

En el panel de EterHosting, abre el administrador de archivos y entra en:

plugins/

Localiza el archivo .jar correspondiente al plugin que quieres actualizar.

Por ejemplo:

plugins/
├── MiPlugin.jar
└── MiPlugin/

Paso 5: Reemplaza únicamente el archivo .jar

Elimina o reemplaza el archivo .jar antiguo por el nuevo.

Por ejemplo, si tienes:

MiPlugin-1.0.jar

y has descargado:

MiPlugin-1.1.jar

sustituye el archivo antiguo por el nuevo.

No elimines la carpeta:

plugins/MiPlugin/

Esa carpeta contiene normalmente la configuración y los datos del plugin.


Ejemplo de estructura correcta

Antes de actualizar:

plugins/
├── MiPlugin-1.0.jar
└── MiPlugin/
    ├── config.yml
    └── messages.yml

Después de actualizar:

plugins/
├── MiPlugin-1.1.jar
└── MiPlugin/
    ├── config.yml
    └── messages.yml

La carpeta de configuración permanece intacta.


Paso 6: Inicia el servidor

Una vez reemplazado el archivo .jar, inicia nuevamente el servidor desde el panel de EterHosting.

Durante el arranque, revisa la Console.

El plugin puede detectar automáticamente que estás utilizando una configuración de una versión anterior y realizar las modificaciones necesarias.


Paso 7: Comprueba la consola

Después de actualizar el plugin, revisa los mensajes que aparecen durante el arranque.

Busca especialmente:

Enabling plugin

Successfully enabled

Migrating configuration

Updating configuration

Error

Warning

Failed to load

Si aparece un error relacionado con la configuración, revisa el mensaje antes de realizar cualquier otro cambio.


¿Se perderá mi configuración?

Normalmente no.

Mientras reemplaces únicamente el archivo .jar y conserves la carpeta del plugin, tus archivos de configuración deberían permanecer intactos.

Por ejemplo:

plugins/MiPlugin/config.yml

seguirá existiendo después de actualizar:

plugins/MiPlugin.jar

¿Qué ocurre si cambia el formato de configuración?

Algunas actualizaciones importantes pueden modificar la estructura de los archivos de configuración.

Los plugins correctamente desarrollados suelen detectar estos cambios y migrar automáticamente la configuración a un formato nuevo.

La consola puede mostrar mensajes indicando que la configuración ha sido actualizada o migrada.

⚠️ Si algo cambia después de actualizar:

No elimines inmediatamente la configuración antigua.

Primero revisa la documentación y el changelog del plugin para saber si la nueva versión requiere cambios en config.yml.

¿Qué hago si la configuración deja de funcionar?

Si después de actualizar el plugin algo no funciona correctamente, puedes restaurar la copia de seguridad que realizaste antes de la actualización.

  1. Detén el servidor.
  2. Realiza una copia de la configuración actual.
  3. Restaura la copia anterior.
  4. Inicia nuevamente el servidor.
  5. Revisa la consola.

También recomendamos consultar el changelog de la nueva versión del plugin para comprobar si se realizaron cambios en la configuración.


¿Necesito actualizar las dependencias?

A veces.

Algunos plugins dependen de otros plugins o componentes.

Después de actualizar, revisa la consola por mensajes como:

Missing dependency

Outdated dependency

Dependency version required

Could not load dependency

Si aparece un aviso de este tipo, comprueba qué dependencia necesita la nueva versión del plugin y actualízala si es necesario.


¿Debo eliminar la carpeta del plugin antes de actualizar?

No.

Si quieres conservar la configuración, no elimines:

plugins/MiPlugin/

Solo reemplaza el archivo .jar.


¿Debo utilizar /reload?

No recomendamos utilizar:

/reload

para actualizar plugins.

Es preferible detener completamente el servidor, reemplazar el .jar y realizar un inicio limpio.


¿Puedo actualizar varios plugins a la vez?

Sí, pero debes tener cuidado.

Si actualizas muchos plugins simultáneamente y aparece un problema, puede ser más difícil identificar cuál actualización lo provocó.

Para servidores importantes, recomendamos actualizar los plugins de forma controlada y revisar la consola después de cada actualización.


Ejemplo completo

Supongamos que tienes:

plugins/
├── ExamplePlugin-2.0.jar
└── ExamplePlugin/
    ├── config.yml
    └── messages.yml

Descargas la versión:

ExamplePlugin-2.1.jar

El proceso recomendado es:

  1. Detén el servidor.
  2. Haz una copia de plugins/ExamplePlugin/.
  3. Elimina o reemplaza ExamplePlugin-2.0.jar.
  4. Sube ExamplePlugin-2.1.jar.
  5. Conserva la carpeta ExamplePlugin/.
  6. Inicia el servidor.
  7. Revisa la consola.
  8. Comprueba que el plugin funcione correctamente.

El resultado debería ser:

plugins/
├── ExamplePlugin-2.1.jar
└── ExamplePlugin/
    ├── config.yml
    └── messages.yml

Preguntas frecuentes

¿Perderé mi configuración al actualizar?

No normalmente. Si reemplazas únicamente el .jar y mantienes la carpeta de configuración, tus ajustes se conservarán.

¿Tengo que borrar el plugin antiguo?

Debes reemplazar el antiguo .jar, pero no necesitas borrar la carpeta de configuración.

¿Tengo que borrar la carpeta plugins/MiPlugin?

No. Esa carpeta normalmente contiene la configuración y otros datos del plugin.

¿Qué pasa si la nueva versión cambia la configuración?

El plugin puede migrarla automáticamente. Revisa siempre la consola y el changelog de la nueva versión.

¿Necesito hacer un backup?

No es obligatorio, pero es muy recomendable. Una copia de la carpeta de configuración te permitirá restaurarla si algo sale mal.

¿Tengo que actualizar las dependencias?

Algunas actualizaciones pueden requerir versiones nuevas de sus dependencias. Si la consola muestra un aviso, actualiza la dependencia correspondiente.

¿Puedo actualizar el plugin mientras el servidor está encendido?

Recomendamos detener el servidor antes de reemplazar cualquier plugin y después realizar un inicio limpio.

¿Debo utilizar /reload?

No. Recomendamos un reinicio completo del servidor.


Proceso recomendado

Para actualizar un plugin sin perder su configuración:

1. Descarga una versión compatible del plugin.

2. Detén completamente el servidor.

3. Realiza una copia de seguridad de plugins/NombreDelPlugin/.

4. Abre la carpeta plugins/.

5. Reemplaza únicamente el archivo .jar.

6. No elimines la carpeta de configuración.

7. Inicia nuevamente el servidor.

8. Revisa la Console.

9. Comprueba que el plugin funcione correctamente.

10. Si aparece algún problema, restaura el backup y revisa el changelog del plugin.

Resumen

Actualizar un plugin no debería borrar tu configuración.

La clave es reemplazar únicamente el archivo .jar y conservar la carpeta de configuración:

plugins/NombreDelPlugin/

Antes de actualizar, recomendamos hacer un backup de esa carpeta.

Después de instalar el nuevo .jar, inicia el servidor y revisa la consola. Si el plugin necesita migrar su configuración, normalmente lo hará automáticamente.

Si la nueva versión requiere una dependencia actualizada o modifica el formato de configuración, sigue las indicaciones mostradas en la consola y en el changelog del plugin.

Panel de EterHosting

Puedes administrar tus plugins, archivos, configuraciones y consola desde el panel de EterHosting:

panel.eterhosting.net

¿Le ha resultado útil esta respuesta?

Volver a la documentación