> 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/policia-y-medico/cuxial-police/installation.md).

# Instalación

Instala Cuxial Police paso a paso: dependencias, items, convars, orden de arranque y primera puesta en marcha.

Cuxial Police no necesita importar SQL. Crea sus tablas, añade las columnas que necesita e instala sus ajustes por defecto en el primer arranque.

{% stepper %}
{% step %}

## Comprueba las dependencias

Estos recursos tienen que estar instalados y funcionando antes de añadir Cuxial Police:

* `ox_lib`
* `oxmysql`
* `cuxial_bridge`, con tu framework en marcha
* `pma-voice`

Las integraciones opcionales están en la [Introducción](/scripts/es/policia-y-medico/cuxial-police.md#requisitos). Cada una se detecta cuando está iniciada; no hay que configurar nada para activarlas.

{% hint style="warning" %}
La base de datos tiene que ser MySQL 5.7 o superior, o MariaDB 10.2 o superior. La búsqueda de ciudadanos usa una columna generada.
{% endhint %}
{% endstep %}

{% step %}

## Copia el recurso

Coloca la carpeta `cuxial_police` dentro de tu directorio `resources`. No cambies el nombre de la carpeta: los items llaman a exports con ese nombre.
{% endstep %}

{% step %}

## Añade los items

Abre `install/items.lua` y copia su contenido en `ox_inventory/data/items.lua`. Contiene:

* `cuxial_mdt`, la tablet que abre el MDT.
* `prescription` y `death_certificate`, las copias en papel que entrega el EMS.
* Los fármacos y vacunas de la farmacia.

La imagen del item de la tablet es `install/cuxial_mdt.png`; cópiala a `ox_inventory/web/images/`.

Si usas el addon de agencia federal, añade también sus tres items de vigilancia:

{% code title="ox\_inventory/data/items.lua" %}

```lua
['fib_camera'] = {
    label = 'Cámara oculta',
    weight = 400,
    stack = true,
    close = true,
    consume = 0,
    client = { export = 'cuxial_police.fib_camera' },
},

['fib_mic'] = {
    label = 'Micrófono oculto',
    weight = 150,
    stack = true,
    close = true,
    consume = 0,
    client = { export = 'cuxial_police.fib_mic' },
},

['fib_gps'] = {
    label = 'Rastreador GPS',
    weight = 200,
    stack = true,
    close = true,
    consume = 0,
    client = { export = 'cuxial_police.fib_gps' },
},
```

{% endcode %}

{% hint style="info" %}
El detector de dispositivos no es un item propio. Por defecto es el arma `WEAPON_DIGISCANNER`, que tiene que existir en la lista de armas de tu inventario.
{% endhint %}

{% hint style="warning" %}
Los dos últimos items de `install/items.lua` (`caja_rutina` y `pastilla_rutina`) llaman a exports de `cuxial_diseases`. No los copies si no usas ese recurso.
{% endhint %}
{% endstep %}

{% step %}

## Configura las convars

Las dos son opcionales.

{% code title="server.cfg" %}

```cfg
# Idioma de la tablet y de los mensajes
setr ox:locale "es"

# Token de subida para fotos de ficha, de vehículo y pruebas fotográficas
set cuxial:fivemanageToken "tu_token"
```

{% endcode %}

{% hint style="info" %}
Las fotos se capturan con `screencapture` y se suben a la dirección indicada en `photo.uploadUrl`. Las fichas policiales, las fotos de vehículos y las pruebas fotográficas requieren el token y `screencapture`; todo lo demás funciona sin ellos.
{% endhint %}
{% endstep %}

{% step %}

## Inicia el recurso

Inicia Cuxial Police después de sus dependencias, de tu framework y de tu inventario:

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
# aquí tu framework
ensure ox_inventory
ensure pma-voice
ensure cuxial_bridge
# integraciones opcionales
ensure cuxial_medical
ensure cuxial_gang
ensure cuxial_police
```

{% endcode %}

En el primer arranque la consola muestra la creación del esquema y la instalación de los ajustes con sus valores por defecto.

{% hint style="danger" %}
El script añade las columnas `police_image`, `wanted`, `dangerous` y `search_text` a tu tabla de personajes, y `wanted`, `description` y `police_image` a tu tabla de vehículos. Haz una copia de la base de datos antes del primer arranque.
{% endhint %}
{% endstep %}

{% step %}

## Indica tus trabajos

Los valores por defecto esperan un trabajo `police`, un trabajo `ambulance` y un trabajo `fib` para el addon federal. Si los tuyos se llaman de otra forma:

1. Edita `policeJobs`, `emsJobs` y `addons.fib.jobs` en `install/defaults/config.lua` **antes del primer arranque**, o
2. arranca con los valores por defecto, ponte uno de esos trabajos, abre la tablet y cámbialos en la pestaña de ajustes: sección `config.jobs` para policía y EMS, sección `config.fib` para el addon federal.

Tras el primer arranque los valores viven en la base de datos. Editar `install/defaults/` ya no cambia una instalación en marcha; consulta [Configuración](/scripts/es/policia-y-medico/cuxial-police/configuration.md).
{% endstep %}

{% step %}

## Comprueba que funciona

1. Entra con un trabajo de policía y permiso de staff.
2. Usa el item `cuxial_mdt`. La tablet se abre con el tema de policía.
3. Abre la pestaña de ajustes, ve a la sección de estaciones (`config.stations`) y crea un punto de tipo `duty`. Entra de servicio en él.
4. Pulsa <kbd>F7</kbd>. Se abre el menú rápido.
5. Escribe `/entorno prueba`. El aviso aparece en la barra de avisos (<kbd>I</kbd> la muestra y la oculta).
   {% endstep %}
   {% endstepper %}

Siguiente: descubre qué tiene cada facción en la [Guía de funciones](/scripts/es/policia-y-medico/cuxial-police/features.md).


---

# 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/policia-y-medico/cuxial-police/installation.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.