> For the complete documentation index, see [llms.txt](https://tierras-altas-rp.gitbook.io/xj-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tierras-altas-rp.gitbook.io/xj-scripts/primeros-pasos/instalacion.md).

# Instalación

Los pasos son los mismos para todos los recursos de XJ Scripts.

## 1. Descargar

Tras el pago, el recurso aparece en tu cuenta de Cfx.re, en [Granted Assets](https://portal.cfx.re/assets/granted-assets). Desde ahí lo descargas o lo importas directamente al servidor.

No descargues el recurso de ningún otro sitio. Si lo encuentras en un foro o en un Discord, es una copia pirata: no la soportamos y suele estar modificada.

## 2. Colocar la carpeta

Descomprime y deja la carpeta dentro de `resources`, en el sitio que uses para tus recursos propios. Por ejemplo:

```
resources/
└── [xj]/
    └── xj_garages_new/
```

**No cambies el nombre de la carpeta.** Otros recursos llaman al nuestro por su nombre, y el escrow también lo comprueba.

## 3. Arrancarlo en el server.cfg

Añade la línea `ensure` **después** de sus dependencias:

```cfg
ensure ox_lib
ensure oxmysql
ensure qb-core

ensure xj_garages_new
```

Si lo pones antes que `oxmysql` o `qb-core`, arrancará y fallará.

## 4. Base de datos

Los recursos que guardan cosas crean sus tablas solos la primera vez que arrancan. No tienes que importar ningún `.sql` a mano salvo que la página del recurso lo diga.

Si el servidor no puede escribir en la base de datos, lo verás en la consola nada más arrancar. Normalmente es la cadena de conexión de `oxmysql` en el `server.cfg`.

## 5. Configurar

Todo lo que se puede tocar está en `config.lua`, comentado en español. Ese archivo queda **fuera del cifrado** del escrow precisamente para que lo edites.

Una regla que ahorra disgustos: **guarda una copia de tu `config.lua` antes de actualizar**. Al subir una versión nueva se sobrescribe.

## 6. Comprobar que va

Mira la consola al arrancar. Si el recurso ha subido bien, no dice nada raro. Luego pruébalo en el juego con un solo jugador antes de abrir el servidor.

Para medir rendimiento, usa `resmon 1` dentro del juego y mira el recurso en la lista. Los números que anunciamos están medidos así, en un servidor real con gente, no en un servidor vacío.