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

# Problemas frecuentes

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

Los problemas más habituales tras instalar Cuxial License, 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 License necesita `ox_lib`, `oxmysql`, `cuxial_bridge` y `screencapture`. La última es la habitual: no forma parte de un servidor por defecto.

**Solución.** Instala `screencapture` como se explica en [Instalación](/scripts/es/nucleo/cuxial-license/installation.md#instala-screencapture) y arranca todo en orden:

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure screencapture
ensure cuxial_license
```

{% endcode %}

</details>

<details>

<summary>La captura no termina nunca, o la consola muestra un error de screencapture</summary>

**Causa.** `screencapture` está corriendo desde el código fuente en vez de una release empaquetada, su carpeta tiene otro nombre, o el artefacto del servidor es demasiado antiguo para él.

**Solución.** Vuelve a descargar la release empaquetada, comprueba que la carpeta se llama `screencapture` y contiene `game/dist`, y actualiza el artefacto del servidor. Si las capturas siguen fallando con tu proveedor de hosting, abre el `fxmanifest.lua` de `screencapture` y lee la nota que acompaña a su línea `protocol`.

</details>

<details>

<summary>Las tarjetas se emiten sin foto</summary>

**Causa.** Una de estas:

* La convar `cuxial:fivemanageToken` está vacía, mal escrita o definida después de que arranque el recurso. Se lee una vez, al arrancar.
* El token no vale para imágenes, así que la subida se rechaza.

**Solución.** Añade la convar por encima de `ensure cuxial_license` y reinicia el servidor:

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

```cfg
set cuxial:fivemanageToken "TU_TOKEN_DE_FIVEMANAGE"
```

{% endcode %}

Las tarjetas emitidas mientras faltaba el token siguen sin foto. Emítelas otra vez.

</details>

<details>

<summary>La foto sale con el escenario detrás del personaje</summary>

**Causa.** El jugador no estaba delante de un fondo verde. O `photo.greenScreenPos` apunta a otro sitio, o la carpeta `stream` del recurso está incompleta y la sala no se cargó.

**Solución.** Recupera el `greenScreenPos` por defecto, o vuelve a copiar el recurso desde el paquete original, y reinicia el servidor.

</details>

<details>

<summary>Usar la tarjeta no hace nada</summary>

**Causa.** Una de estas:

* El objeto no está definido con `client.export = 'cuxial_license.useLicenseCard'`.
* El diseño de tarjeta usa otro nombre de objeto y ese objeto no tiene definición.
* Se cambió el nombre de la carpeta del recurso, así que el export ya no existe.
* El objeto se dio a mano. Solo las tarjetas emitidas por el script llevan los datos necesarios para mostrarse.
* Se borró el diseño de la tarjeta.

**Solución.** Revisa los objetos en [Instalación](/scripts/es/nucleo/cuxial-license/installation.md#registra-los-objetos), mantén el nombre de carpeta `cuxial_license`, y emite la tarjeta desde la oficina, `/jobissue` o el export `IssueLicense`.

</details>

<details>

<summary>«Este documento ha expirado. Necesitas sacar uno nuevo.»</summary>

**Causa.** El objeto no lleva los datos de su titular. Pasa con objetos que añadió otro recurso sin el nombre del titular.

**Solución.** Emite la tarjeta otra vez y tira el objeto antiguo.

</details>

<details>

<summary>/license está denegado</summary>

**Causa.** Al jugador le falta el permiso del framework indicado en `admin.permission`.

**Solución.** Dale ese permiso en tu framework, o cambia `admin.permission` por uno que tenga.

</details>

<details>

<summary>«Tu trabajo no está autorizado para esta acción.»</summary>

**Causa.** El trabajo del jugador no está en `authorizedJobs`, o su grado está por debajo del mínimo. Los valores de ejemplo del archivo piden grado 4.

**Solución.** Añade el trabajo con el grado que quieras en `shared/config.lua`. La clave es el nombre del trabajo, no su etiqueta.

</details>

<details>

<summary>El NPC de la oficina no aparece o no se puede interactuar con él</summary>

**Causa.** Las coordenadas de `zones` no están donde esperas, el modelo de ped no existe, o no hay ningún recurso de target en marcha.

**Solución.** Revisa `coords` y `model`, y arranca un recurso de target compatible con `cuxial_bridge` antes que el bridge. Reinicia el recurso después de cambiar el config.

</details>

<details>

<summary>La tienda dice que no hay licencias disponibles</summary>

**Causa.** La tienda solo lista las tarjetas con **Cobrar dinero** activado y sin **Restringir Tarjeta a Trabajo**.

**Solución.** Edita la tarjeta con `/license` y activa **Cobrar dinero** en el último paso. El importe puede ser 0.

</details>

<details>

<summary>Al jugador nunca le llega la solicitud de foto</summary>

**Causa.** El jugador ya tenía abierto uno de los paneles del script, o pasaron 60 segundos. El agente ve «La sesión de foto expiró».

**Solución.** Pide al jugador que cierre lo que tenga abierto y emite la tarjeta otra vez.

</details>

<details>

<summary>Los jugadores cercanos no ven la tarjeta que enseño</summary>

**Causa.** Están más lejos que `showRadius`, o ya están mirando otra tarjeta.

**Solución.** Acércate o sube `showRadius`.

</details>

<details>

<summary>El selector de hora del día del estudio de fotos no hace nada</summary>

**Causa.** El selector funciona a través de `av_weather`, y no está en marcha.

**Solución.** Arranca `av_weather`. La foto en sí no depende de él.

</details>

<details>

<summary>Las marcas de búsqueda y de peligroso nunca aparecen</summary>

**Causa.** Vienen de `cuxial_police`, y no está en marcha.

**Solución.** Arranca `cuxial_police`. Sin él las tarjetas se muestran sin marcas.

</details>

<details>

<summary>Han desaparecido licencias tras borrar un diseño de tarjeta</summary>

**Causa.** Borrar un diseño elimina todas las licencias emitidas con él.

**Solución.** No se puede deshacer desde el juego. Crea el diseño de nuevo y vuelve a emitir las tarjetas, o restaura una copia de la base de datos.

</details>

<details>

<summary>Errores de base de datos al arrancar el recurso</summary>

**Causa.** El usuario de la base de datos no puede crear tablas.

**Solución.** Ejecuta `sql/install.sql` a mano y reinicia el recurso.

</details>

<details>

<summary>Los paneles no se abren</summary>

**Causa.** La interfaz no carga. La carpeta `web/build` falta o está incompleta, normalmente tras una subida a medias.

**Solución.** Comprueba que dentro del recurso existen `web/build/index.html` y `web/build/assets`. Si no están, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

</details>

<details>

<summary>Los textos salen en otro idioma</summary>

**Causa.** El script sigue la convar `ox:locale`.

**Solución.** Defínela en `server.cfg` y reinicia. Vienen `en` y `es`:

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

```cfg
setr ox:locale "es"
```

{% endcode %}

</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/nucleo/cuxial-license/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.