> 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/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Police, con su causa y su solución.

Los problemas más habituales después de instalar Cuxial Police, con la causa y la solución de cada uno.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después. Cuxial Police necesita `ox_lib`, `oxmysql`, `cuxial_bridge` y `pma-voice`.

**Solución.** Inicia antes las dependencias:

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

```cfg
ensure ox_lib
ensure oxmysql
ensure pma-voice
ensure cuxial_bridge
ensure cuxial_police
```

{% endcode %}

</details>

<details>

<summary>La tablet dice que no soy policía, o no se abre</summary>

**Causa.** Tu trabajo no está en ninguna facción. Los valores por defecto solo conocen los trabajos de `policeJobs`, `emsJobs` y `addons.fib.jobs`.

**Solución.** Añade los nombres de tus trabajos en la sección `config.jobs` de la pestaña de ajustes (y en `config.fib` para el addon federal). Si todavía nadie puede abrir la tablet, edita `install/defaults/config.lua` antes del primer arranque, o dale a un miembro del staff uno de los trabajos por defecto para hacer el cambio.

</details>

<details>

<summary>He editado install/defaults y no ha cambiado nada</summary>

**Causa.** Esos archivos son valores de fábrica. Tras el primer arranque el servidor lee sus ajustes de la base de datos.

**Solución.** Cambia el valor en la pestaña de ajustes. Para aplicar un cambio de archivo, reinicia el recurso y pulsa el botón de valores de fábrica de esa sección.

</details>

<details>

<summary>No veo la pestaña de ajustes</summary>

**Causa.** La pestaña solo se muestra a jugadores con el permiso `admin` de tu framework.

**Solución.** Da ese permiso a tu cuenta. También necesitas un trabajo de facción para abrir la tablet.

</details>

<details>

<summary>Un cambio en la pestaña de ajustes no se aplica hasta reiniciar</summary>

**Causa.** Algunas secciones solo se leen al arrancar: radio (`config.radio`, `data.radio`, `data.radioaudio`), teclas (`data.keybinds`), `fingerprint.closeKey`, la tecla para dejar de rendirse, y `enabled` y `devices.items` del addon federal.

**Solución.** Reinicia el recurso después de guardar una de esas secciones.

</details>

<details>

<summary>He cambiado una tecla por defecto y los jugadores siguen con la antigua</summary>

**Causa.** FiveM guarda la tecla de cada jugador la primera vez que se registra la asignación. Un valor por defecto nuevo solo llega a quien nunca tuvo esa asignación.

**Solución.** Cada jugador la cambia en los ajustes de asignación de teclas de FiveM.

</details>

<details>

<summary>El menú rápido no se abre</summary>

**Causa.** El jugador no está de servicio, o su trabajo no está en una facción.

**Solución.** Entra de servicio en un punto de estación de tipo `duty` o desde la tablet. Si todavía no hay ninguno, créalo en la sección `config.stations`.

</details>

<details>

<summary>Los puntos de estación, de pago o los lectores de huellas no se pueden usar</summary>

**Causa.** Son zonas de interacción creadas a través de `cuxial_bridge`. No hay ningún recurso de target compatible iniciado, o el punto está limitado a otra facción, a un grado mayor o a miembros de servicio.

**Solución.** Inicia tu recurso de target antes que `cuxial_bridge` y revisa `faction`, `minGrade` y `onDuty` del punto.

</details>

<details>

<summary>Una armería no se abre</summary>

**Causa.** Las armerías son tiendas de `ox_inventory` y solo se registran cuando está iniciado.

**Solución.** Inicia `ox_inventory` antes que Cuxial Police. Las filas sin nombre de item se ignoran.

</details>

<details>

<summary>Usar el item de la tablet o un fármaco no hace nada</summary>

**Causa.** El item no está en el inventario, o se cambió el nombre de la carpeta del recurso. Los items llaman a exports con el nombre `cuxial_police.<item>`.

**Solución.** Copia `install/items.lua` en `ox_inventory/data/items.lua`, mantén el nombre de carpeta `cuxial_police` y reinicia el inventario.

</details>

<details>

<summary>Los items de vigilancia no se pueden usar</summary>

**Causa.** `fib_camera`, `fib_mic` y `fib_gps` no están en `install/items.lua`, o el addon está desactivado. Sus exports solo se registran con `addons.fib.enabled = true`.

**Solución.** Añade los tres items de la página de [Instalación](/scripts/es/policia-y-medico/cuxial-police/installation.md) y activa el addon. Cambiar los nombres de item en `devices.items` necesita reinicio.

</details>

<details>

<summary>Las fotos no se suben</summary>

**Causa.** No está puesto el token de subida, `screencapture` no está iniciado, o la dirección de subida no es correcta.

**Solución.** Inicia `screencapture`, pon el token y reinicia el recurso:

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

```cfg
set cuxial:fivemanageToken "tu_token"
```

{% endcode %}

Revisa `photo.uploadUrl` en la sección `config.photo`.

</details>

<details>

<summary>Nadie oye la radio</summary>

**Causa.** `pma-voice` no está iniciado, `radio.enabled` está en `false`, o los jugadores están en frecuencias distintas.

**Solución.** Inicia `pma-voice` antes que Cuxial Police y revisa la sección `config.radio`. Las secciones de radio necesitan reinicio tras un cambio.

</details>

<details>

<summary>Los avisos de disparos no llegan nunca</summary>

**Causa.** Cuxial Police no detecta los disparos. Espera el evento `cuxial:gunshot` de tu recurso de armas.

**Solución.** Lanza el evento como se indica en [Exports y eventos](/scripts/es/policia-y-medico/cuxial-police/developers.md#avisos-de-disparos). Comprueba también que el arma no esté en `data.gunshotwhitelist` y que `dispatch.enabled` sea `true`.

</details>

<details>

<summary>/paymultas o /payfacturas no hacen nada</summary>

**Causa.** Los comandos de pago vienen desactivados. Las multas y las facturas se pagan en los puntos de pago.

**Solución.** Pon `payment.commands = true` en la sección `config.payment` de la pestaña de ajustes, y mantén `payment.enabled = true`.

</details>

<details>

<summary>Las multas se pagan pero la cuenta de la facción no recibe nada</summary>

**Causa.** El ingreso se hace con `cuxial_banking`. Sin él se cobra al ciudadano y no se abona en ninguna cuenta.

**Solución.** Inicia `cuxial_banking` y revisa los nombres de cuenta en la sección `config.revenue`.

</details>

<details>

<summary>Las acciones del menú rápido de EMS no hacen nada</summary>

**Causa.** Examinar, RCP, curar y las acciones de camilla llaman a `cuxial_medical`.

**Solución.** Instala e inicia `cuxial_medical`.

</details>

<details>

<summary>Los fármacos nunca se bloquean por una condición médica</summary>

**Causa.** Esa comprobación usa un hook de inventario que solo ofrece `ox_inventory`. Con cualquier otro inventario la consola lo avisa al arrancar.

**Solución.** Usa `ox_inventory`.

</details>

<details>

<summary>La pestaña de organizaciones del addon federal está vacía</summary>

**Causa.** Las organizaciones salen del recurso indicado en `addons.fib.gangResource`. No está iniciado, o el nombre no es correcto.

**Solución.** Inicia ese recurso antes que Cuxial Police y revisa el nombre en la sección `config.fib`.

</details>

<details>

<summary>Cambiar un rango desde la gestión de personal falla en QBCore</summary>

**Causa.** El cambio de rango añade un trabajo al jugador sin sustituir los demás, lo que requiere multitrabajo en el framework. `cuxial_bridge` lo avisa en la consola.

**Solución.** Usa QBox, o un QBCore con multitrabajo.

</details>

<details>

<summary>La consola muestra errores de esquema al arrancar</summary>

**Causa.** La base de datos es demasiado antigua para las columnas generadas, o el usuario de la base de datos no puede modificar las tablas de personajes y vehículos.

**Solución.** Usa MySQL 5.7 o superior, o MariaDB 10.2 o superior, y da al usuario permiso para crear y modificar tablas. Las líneas que empiezan por `[cuxial_police][mysql]` indican la tabla y la columna que han fallado.

</details>

<details>

<summary>La tablet se queda en blanco o la interfaz no carga</summary>

**Causa.** Faltan archivos de la interfaz o están incompletos.

**Solución.** Vuelve a copiar el recurso desde el paquete que descargaste, sustituyendo la carpeta entera, y reinícialo.

</details>


---

# 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/troubleshooting.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.