> For the complete documentation index, see [llms.txt](https://docs.realcity.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realcity.dev/script-docs/rc-persecutions/instalacion.md).

# Instalación

## Instalación de rc-persecutions

Este documento proporciona una guía detallada para instalar y configurar correctamente el script `rc-persecutions` en tu servidor de FiveM.

***

### Requisitos

Antes de instalar, asegúrate de tener las siguientes dependencias instaladas y en funcionamiento en tu servidor.

* [**ox\_lib**](https://github.com/overextended/ox_lib)**:** Requerido. Se utiliza para notificaciones, locales (textos) y otras funciones principales.
* [**oxmysql**](https://github.com/overextended/oxmysql)**:** Requerido. Se utiliza para acceder a la base de datos y obtener información de los vehículos.
* [**sleepless\_interact**](https://github.com/Sleepless-Development/sleepless_interact)**:** Opcional. Si se activa en la configuración, proporciona una forma alternativa y más visual para que los jugadores interactúen con el punto de inicio de las persecuciones.
* **Un script de Framework (ESX / QBCore / etc.):** El script está diseñado para funcionar con diferentes frameworks a través de un sistema de "bridge". Deberás configurar cuál utilizas en `config.lua`.

***

### Pasos de Instalación

Sigue estos pasos para instalar el recurso en tu servidor.

#### 1. Descargar y Descomprimir

1. Descarga los archivos del script `rc-persecutions`.
2. Descomprime el archivo `.zip` (si es necesario).
3. Copia la carpeta `rc-persecutions` en el directorio `resources` de tu servidor. La ruta debería verse así: `.../resources/[JerarquiaRP]/rc-persecutions/`.

#### 2. Configurar el Framework y Dependencias

1. Abre el archivo `config.lua`.
2. Localiza la línea `Config.Framework` y establece el nombre de tu framework en minúsculas (por ejemplo, `'esx'`, `'qbcore'`). **Este paso es crucial.**
3. Asegúrate de que las dependencias mencionadas anteriormente (`ox_lib`, `oxmysql`) están correctamente instaladas.

#### 3. Asegurar el Recurso

Añade la siguiente línea a tu archivo `server.cfg` o `resources.cfg`. Es importante que `rc-persecutions` se inicie **después** de todas sus dependencias.

```cfg
ensure rc-persecutions
```

**Orden de inicio recomendado:**

```cfg
ensure oxmysql
ensure ox_lib
ensure es_extended # o tu base de ESX/QB
# ... otros scripts
ensure rc-persecutions
```

#### 4. Configuración Adicional

Revisa la siguiente página para una explicación detallada de todas las opciones disponibles en `config.lua`. Deberás configurar aspectos como:

* El tipo de dinero a utilizar para las apuestas (`RC.MoneyType`).
* La ubicación del lobby de persecuciones (`RC.LobbyLocation`).
* Los límites de apuesta, duración y distancias.

#### 5. Verificación

Inicia tu servidor y comprueba la consola en busca de errores relacionados con `rc-persecutions`. Si no hay errores, dirígete a la ubicación del lobby configurada en el mapa y deberías ver el marcador o la interacción para comenzar una persecución.