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

# Problemas frecuentes

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

Los problemas más habituales tras instalar Cuxial Gardener, 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 del trabajo. Cuxial Gardener necesita OneSync, `ox_lib`, `oxmysql`, `cuxial_bridge`, `cuxial_jobs`, `sleepless_interact` y `cuxial_gardener_assets`.

**Solución.** Activa OneSync y arranca antes las dependencias:

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure sleepless_interact
ensure cuxial_jobs
ensure cuxial_gardener_assets
ensure cuxial_gardener
```

{% endcode %}

</details>

<details>

<summary>La consola muestra un error al leer un módulo de cuxial_jobs</summary>

**Causa.** `cuxial_jobs` no está arrancado, se ha renombrado o es una copia incompleta. El trabajo carga su código común desde esa carpeta.

**Solución.** Copia de nuevo `cuxial_jobs` desde el paquete, conserva el nombre de la carpeta y arráncalo antes que `cuxial_gardener`.

</details>

<details>

<summary>Una línea roja en la consola dice que el trabajo pide otra versión de la librería</summary>

**Causa.** La carpeta `cuxial_jobs` del servidor es más antigua o más nueva que aquella para la que se hizo este trabajo. Ocurre cuando hay varios trabajos de Cuxial instalados y uno de ellos ha sobrescrito la librería.

**Solución.** Conserva el `cuxial_jobs` más reciente de todos tus paquetes y actualiza los trabajos que pidan uno más antiguo.

</details>

<details>

<summary>El NPC o su blip no aparecen</summary>

**Causa.** El NPC solo existe cerca de su posición, y `npc.coords` puede apuntar a un sitio que no encaja con tu mapa. El blip se oculta con `npc.blip.enabled = false`.

**Solución.** Revisa `npc.coords` y `npc.blip` en `shared/config.lua`. Si la consola avisa de que no se pudo cargar el modelo del NPC, pon un ped válido en `npc.model`.

</details>

<details>

<summary>El NPC está, pero no hay opción para interactuar</summary>

**Causa.** `sleepless_interact` no está en marcha, o ha arrancado después del trabajo.

**Solución.** Arranca `sleepless_interact` antes que `cuxial_gardener` y reinicia el trabajo.

</details>

<details>

<summary>«No puedes hacer este trabajo»</summary>

**Causa.** La opción `job` del config lista trabajos del framework y el jugador, o un miembro de la tripulación, no tiene ninguno de ellos.

**Solución.** Dale al jugador uno de esos trabajos, añade el suyo a la lista, o pon `job = 'all'`.

</details>

<details>

<summary>«Tu perfil de jardinero aún no está listo»</summary>

**Causa.** El perfil no se pudo cargar de la base de datos. O `oxmysql` no tiene conexión, o las tablas no se pudieron crear al arrancar.

**Solución.** Revisa la conexión de `oxmysql` y sus errores en la consola, y reinicia `cuxial_gardener`. Las tablas `cuxial_jobs_players`, `cuxial_jobs_runs`, `cuxial_jobs_run_members` y `cuxial_jobs_audit` deben existir tras el arranque.

</details>

<details>

<summary>«Hay vehículos en la salida de los camiones»</summary>

**Causa.** Hay un vehículo a menos de `run.spawnFreeRadius` metros de todos los puntos de salida de la región.

**Solución.** Despeja la zona. Si pasa a menudo, añade más puntos de salida a `trucks` y `mowers` en `data/regions.lua`, o muévelos a un sitio más tranquilo.

</details>

<details>

<summary>«No se pudieron sacar los vehículos»</summary>

**Causa.** El modelo del camión no está cargado, o el servidor no creó el vehículo a tiempo. Falta `cuxial_gardener_assets`, o se instaló sin reiniciar el servidor.

**Solución.** Arranca `cuxial_gardener_assets` antes que el trabajo y reinicia el servidor. En un servidor cargado, sube `vehicles.spawnTimeoutMs`.

</details>

<details>

<summary>El camión está cerrado o la tripulación no tiene llaves</summary>

**Causa.** Las llaves solo se dan mediante `cuxial_garages`. Sin ese recurso, o con `vehicles.keys = false`, el trabajo no reparte llaves.

**Solución.** Arranca `cuxial_garages` antes que el trabajo y deja `vehicles.keys = true`. Si usas otro sistema de llaves, excluye en ese sistema las matrículas que empiezan por el prefijo de `vehicles.plate`.

</details>

<details>

<summary>La escalera es corta y la consola avisa de que no está en este build</summary>

**Causa.** La escalera alta es un modelo del juego añadido en el game build 2944. Con un build anterior el trabajo usa una más corta.

**Solución.** Pon el game build en 2944 o superior:

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

```cfg
sv_enforceGameBuild 2944
```

{% endcode %}

</details>

<details>

<summary>No se pueden entregar los camiones</summary>

**Causa.** No se cumple alguna de las reglas de entrega. El mensaje en pantalla dice cuál: quedan tareas pendientes, el jugador no va al volante de un camión del trabajo, un camión está fuera de `deliver.radius`, o un camión está destruido.

**Solución.** Lleva todos los camiones al punto de entrega y entrega desde el asiento del conductor. Si un segundo camión destruido no debe bloquear el pago, pon `deliver.requireAll = false`. Si se pierde el camión principal, el dueño reinicia el trabajo con `/gardreset`.

</details>

<details>

<summary>No se pueden plantar flores en ningún sitio</summary>

**Causa.** Las flores van dentro de la zona de flores de la región, lejos del camión del trabajo y con separación entre ellas. Con `plant.allowUnknown = false` solo valen las superficies de `plant.materials`.

**Solución.** Aparta el camión, planta dentro de la zona marcada y deja sitio entre flores. Pon `plant.allowUnknown = true` para aceptar cualquier superficie.

</details>

<details>

<summary>El registro de Discord no recibe nada</summary>

**Causa.** La convar del webhook está vacía, tiene otro nombre o se definió después de arrancar el recurso.

**Solución.** Defínela con `set` por encima de la línea `ensure`, con el nombre de `logs.convar`, y reinicia el trabajo:

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

```cfg
set cuxial_gardener_webhook "https://discord.com/api/webhooks/..."
```

{% endcode %}

</details>

<details>

<summary>No se dan los premios en ítems</summary>

**Causa.** Un ítem de `reward.items` no existe en tu inventario, o el jugador no puede cargarlo. Al arrancar, la consola lista los ítems que no existen.

**Solución.** Usa nombres de ítem que existan en tu inventario. El ítem se omite cuando el jugador no tiene sitio para él.

</details>

<details>

<summary>Los comandos de staff dicen que no tienes permiso</summary>

**Causa.** El jugador no pertenece al grupo de `commands.<id>.restricted`.

**Solución.** Añade al jugador al grupo, `group.admin` por defecto. Consulta [Comandos y permisos](/scripts/es/trabajos/cuxial-gardener/commands.md).

</details>

<details>

<summary>/gardfast no hace nada</summary>

**Causa.** El comando solo funciona con la depuración activa, y la depuración se lee al arrancar el recurso.

**Solución.** Pon `debug = true` en el config, o `setr cuxial_gardener_debug 1` por encima de la línea `ensure`, y reinicia el trabajo. Vuelve a desactivarla en un servidor en producción.

</details>

<details>

<summary>El panel no se abre o se queda en blanco</summary>

**Causa.** Faltan los archivos de la interfaz o están incompletos. La interfaz viene ya compilada dentro de `web/dist`.

**Solución.** Copia de nuevo la carpeta `cuxial_gardener` desde el paquete, conservando tus archivos `shared/config.lua` y `data/`.

</details>

<details>

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

**Causa.** El trabajo sigue el idioma de `ox_lib`.

**Solución.** Pon `setr ox:locale "es"` o `"en"` en `server.cfg`. Los textos están en `locales/es.json` y `locales/en.json` y se pueden editar.

</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/trabajos/cuxial-gardener/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.