> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/es/rnpsmenu/getting-started/updating.md).

# Actualizar

Cambia el jar y conserva tu configuración, textos, baneos e historial.

Reemplaza el jar viejo por el nuevo y reinicia el servidor. Tus archivos se mantienen.

## Qué pasa con tus archivos

* **Las opciones nuevas se añaden** a `config.yml`, `menus.yml`, `flags.yml` y los archivos de idioma, con sus comentarios y en su sitio. Tus valores, comentarios y el orden no cambian. Antes de guardar, el plugin comprueba que el archivo nuevo conserva todos tus valores; si no, no escribe nada.
* **Se guarda una copia del archivo anterior** en `plugins/rnPsMenu/backups/` antes de cambiar nada.
* **Las opciones que cambien de nombre** en una versión futura se mueven solas. `config-version` le dice al plugin qué versión es tu archivo, así que no lo cambies.
* `shop.yml` y `presets.yml` solo reciben las entradas que añades tú (y los tipos de bloque nuevos de ProtectionStones se añaden solos a la tienda): una actualización nunca añade, quita ni cambia tus bloques ni tus plantillas.
* Tus propios archivos de idioma (como `languages/fr.yml`) también reciben los textos nuevos, en inglés, para que los traduzcas.

La consola te dice lo que se hizo, por ejemplo:

```
[rnPsMenu] Added 2 new option(s) to config.yml: teleport.cost, teleport.cost-other-world. Backup of your old file: backups/config-2026-10-22_14-29-30.yml
```

## Lo que nunca se reemplaza

* Tus valores de `config.yml`, tus distribuciones y botones de `menus.yml`, y tus iconos y bloqueos de `flags.yml`.
* Tu tienda (`shop.yml`) y tus plantillas (`presets.yml`).
* Los textos que cambiaste en `languages/`.
* Los baneos de región (`data/bans.yml`), los permisos de operador (`data/operators.yml`) y el historial de cada región (`data/activity/`).

## Copias de seguridad

* El plugin guarda las **10 copias más nuevas** de cada archivo en `backups/` y borra las más viejas.
* Los cambios hechos con `/psmenu editor` también tienen copia, como mucho una cada 10 minutos por archivo.

{% hint style="info" %}
Si un archivo tiene un error (por ejemplo, falta una comilla), el plugin no lo cambia. Te dice en la consola la línea y cómo arreglarla, y usa los valores por defecto para ese archivo hasta que lo arregles y uses `/psmenu reload` (o lo vuelvas a guardar con `auto-reload` activado).
{% endhint %}

## Avisos de actualización

Cuando `update-checker` es `true`, rnPsMenu busca si hay una versión nueva unos segundos después de arrancar el servidor y cada 6 horas. Cuando la hay:

* La consola muestra una línea:

```
[rnPsMenu] A new version of rnPsMenu is available: 1.0.1 (you have 1.0.0). Download: <página de descarga>
```

* Los jugadores con `rnpsmenu.update` (los operadores y todos los que tienen `rnpsmenu.admin`) reciben un mensaje unos segundos después de entrar, con un enlace de descarga para hacer clic.

`/psmenu version` muestra la versión instalada y la última. La búsqueda se hace en segundo plano: sin internet no se muestra nada y nada falla. Para desactivarlo, pon `update-checker: false` en `config.yml` (o cámbialo en `/psmenu editor > Configuración`). El texto del mensaje es `update.available` en los archivos de idioma.