> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/primeros-pasos/updating.md).

# Actualizar un script

Pasa un script de Cuxial a una versión nueva sin perder tu configuración.

Actualizar consiste en sustituir la carpeta del script y llevar tus cambios a la nueva. Esta página indica qué archivos son tuyos y el orden a seguir.

## Qué archivos son tuyos

Estos archivos están abiertos y pensados para editarse. Todo lo demás se sustituye en cada actualización.

| Archivo             | Qué contiene                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `shared/config.lua` | Las opciones del script.                                                                   |
| `data/*.lua`        | Datos editables: listas, ubicaciones, catálogos. No todos los scripts tienen esta carpeta. |
| `locales/*.json`    | Textos de la interfaz y de las notificaciones.                                             |

La carpeta `install/`, cuando existe, contiene SQL y definiciones de items. Se ejecutan o se copian; no se editan ahí.

## Pasos

{% stepper %}
{% step %}

## Lee las novedades

Abre [Novedades](https://docs.cuxial.com/changelog/es/) y lee todas las entradas entre tu versión y la nueva. Fíjate en opciones de configuración nuevas, SQL nuevo y dependencias nuevas.

Tu versión actual es la línea `version` del `fxmanifest.lua` del script.
{% endstep %}

{% step %}

## Haz una copia de seguridad

Copia la carpeta entera del script fuera de `resources`. Si la actualización incluye SQL, haz copia también de la base de datos.

{% hint style="danger" %}
No dejes la copia dentro de `resources`, ni siquiera renombrada. El servidor puede cargarla como una segunda copia del script.
{% endhint %}
{% endstep %}

{% step %}

## Actualiza primero Cuxial Bridge

Si hay una versión más nueva de Cuxial Bridge, actualízalo antes que el script. Consulta [Cuxial Bridge](/scripts/es/primeros-pasos/cuxial-bridge.md#actualizaciones).
{% endstep %}

{% step %}

## Sustituye el script

Borra la carpeta antigua y copia la nueva. No copies la versión nueva encima de la antigua: los archivos eliminados en la versión nueva se quedarían ahí.
{% endstep %}

{% step %}

## Recupera tus cambios

No pegues tus archivos antiguos encima de los nuevos. Una versión nueva puede añadir opciones, y a un `shared/config.lua` antiguo le faltarían.

Abre tu copia junto a los archivos nuevos y traslada tus valores:

* `shared/config.lua` y `data/*.lua`: parte del archivo nuevo y vuelve a aplicar tus cambios.
* `locales/*.json`: parte del archivo nuevo y vuelve a aplicar tus textos. Las claves añadidas en la versión nueva conservan su texto por defecto.

Una herramienta de comparación de archivos lo hace rápido.
{% endstep %}

{% step %}

## Ejecuta el SQL nuevo

Si las novedades mencionan cambios en la base de datos, ejecuta los archivos que indiquen de la carpeta `install/`.
{% endstep %}

{% step %}

## Reinicia el servidor

Reinicia el servidor entero, no solo el recurso. Un reinicio completo es la única forma de asegurar que todos los jugadores reciben los archivos nuevos.
{% endstep %}

{% step %}

## Revisa las consolas

Mira la consola del servidor mientras arranca y abre la consola F8 dentro del juego. Si el script no da errores en ninguna de las dos, la actualización está hecha.
{% endstep %}
{% endstepper %}

## Si algo se rompe

Restaura la carpeta de la copia, restaura la base de datos si ejecutaste SQL y reinicia. Después busca el error en la página de Problemas frecuentes del script o en [Ayuda](https://docs.cuxial.com/help/es/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/es/primeros-pasos/updating.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.