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

# Problemas frecuentes

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

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

**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_electrician
```

{% endcode %}

</details>

<details>

<summary>La consola muestra una línea roja que dice que el trabajo pide una versión de la librería y hay otra instalada</summary>

**Causa.** `cuxial_jobs` y `cuxial_electrician` vienen de paquetes distintos y sus versiones no coinciden.

**Solución.** Vuelve a copiar las dos carpetas desde el mismo paquete, el más reciente. Si tienes varios trabajos de Cuxial, actualízalos todos a la vez.

</details>

<details>

<summary>El NPC o el blip del trabajo no aparecen</summary>

**Causa.** El NPC solo existe a menos de `npc.spawnDistance` de `npc.coords`, el blip está desactivado o el modelo de `npc.model` no es válido.

**Solución.** Revisa `npc.coords` y `npc.model` en `shared/config.lua`, y pon `npc.blip.enabled = true`. Un modelo que no se puede cargar se avisa en la consola del cliente (F8).

</details>

<details>

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

**Causa.** Se ha forzado `cuxial_bridge` a un recurso de interacción que no está en marcha. El trabajo está hecho para `sleepless_interact`.

**Solución.** Quita la convar `cuxial_bridge:target` de `server.cfg`, o ponla a `sleepless_interact`, y reinicia el servidor.

</details>

<details>

<summary>La opción aparece, pero el panel no se abre</summary>

**Causa.** La interfaz no carga. Falta la carpeta `web/dist` o está incompleta, normalmente por una subida parcial.

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

</details>

<details>

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

**Causa.** `job` en `shared/config.lua` lista trabajos y el jugador no tiene ninguno de ellos. La misma comprobación se aplica a los invitados y a todos los miembros al iniciar el trabajo.

**Solución.** Da al jugador uno de esos trabajos, o pon `job = 'all'`.

</details>

<details>

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

**Causa.** El perfil del jugador todavía no se ha cargado de la base de datos: el personaje acaba de entrar, o las tablas no se pudieron crear.

**Solución.** Espera unos segundos y vuelve a intentarlo. Si sigue igual, busca errores de `oxmysql` en la consola del servidor y revisa la conexión con la base de datos.

</details>

<details>

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

**Causa.** Hay un vehículo a menos de `run.spawnFreeRadius` de los puntos de salida de la región y no quedan puntos libres suficientes para la tripulación.

**Solución.** Aparta el vehículo. Si pasa a menudo, añade más puntos a `spawns` en `data/regions.lua` o elige un lugar más tranquilo.

</details>

<details>

<summary>«No se pudo sacar el camión»</summary>

**Causa.** El servidor no pudo crear el vehículo dentro de `trucks.spawnTimeoutMs`. El modelo de `data/trucks.lua` no existe, o el servidor estaba ocupado.

**Solución.** Revisa los nombres de modelo en `data/trucks.lua` y vuelve a intentarlo. Sube `trucks.spawnTimeoutMs` si el servidor tarda en crear vehículos.

</details>

<details>

<summary>Los jugadores no pueden conducir el camión de servicio</summary>

**Causa.** El script solo reparte llaves mediante `cuxial_garages`. Sin ese recurso, o con `trucks.keys = false`, es tu recurso de cierre de vehículos el que decide quién puede conducir.

**Solución.** Arranca `cuxial_garages` y deja `trucks.keys = true`, o permite los camiones del trabajo en tu recurso de llaves. Sus matrículas empiezan por el prefijo de `trucks.plate`.

</details>

<details>

<summary>La escalera es demasiado corta para llegar a las farolas</summary>

**Causa.** El servidor usa un build del juego anterior al 2944, que no tiene el modelo de escalera larga. El script recurre a una más corta.

**Solución.** Pon `sv_enforceGameBuild` a 2944 o superior en `server.cfg`. Como alternativa, pon `rigs.lampRig = 'lift'` para usar la plataforma en las farolas.

</details>

<details>

<summary>No se puede montar la plataforma en un poste</summary>

**Causa.** Tiene que haber un camión del trabajo aparcado a la distancia correcta del poste (de 5 a 9 metros por defecto), la tripulación ya tiene una plataforma montada, o hay otra plataforma o escalera a menos de `rigs.spacing`.

**Solución.** Sigue la indicación que aparece al conducir: dice si hay que retroceder o acercarse. Desmonta la plataforma anterior antes de montar otra.

</details>

<details>

<summary>No se pueden reparar los semáforos</summary>

**Causa.** Los semáforos de un cruce están bloqueados hasta que se arregla el transformador de ese cruce.

**Solución.** Repara primero el transformador del cruce. Una notificación confirma que los semáforos quedan desbloqueados.

</details>

<details>

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

**Causa.** No se cumple alguna condición de la entrega: quedan reparaciones, el jugador no conduce un camión del trabajo, hay un camión fuera de `deliver.radius` o destruido, o falta devolver una escalera.

**Solución.** Lee la notificación, que indica la condición. Pon `deliver.requireAll = false` si un camión secundario destruido no debe bloquear el pago.

</details>

<details>

<summary>«Otra tripulación ya trabaja en esa región»</summary>

**Causa.** `run.exclusiveRegions = true` permite una tripulación por región a la vez.

**Solución.** Elige otra región, o pon `run.exclusiveRegions = false`.

</details>

<details>

<summary>Las reparaciones se rechazan por «demasiado lejos» o «demasiado rápido»</summary>

**Causa.** El servidor comprueba la distancia al punto y el tiempo mínimo de cada minijuego. Con mucha latencia, una reparación válida puede quedar justo fuera de los límites.

**Solución.** Sube un poco `repair.maxDistance`, `repair.highDistance` o `repair.marginMs` en `shared/config.lua`.

</details>

<details>

<summary>No se entregan los ítems de recompensa</summary>

**Causa.** El ítem de `reward.items` no existe en tu inventario, el jugador no puede cargarlo o no salió la probabilidad de `chance`.

**Solución.** Revisa el nombre del ítem. Un ítem que no existe se avisa en la consola del servidor al arrancar el recurso.

</details>

<details>

<summary>No llegan los registros a Discord</summary>

**Causa.** La convar está vacía, tiene un nombre distinto al de `logs.convar` o se definió después de arrancar el recurso.

**Solución.** Añade `set cuxial_electrician_webhook "..."` a `server.cfg` por encima de la línea `ensure`, y reinicia el servidor.

</details>

<details>

<summary>/elecfast no hace nada</summary>

**Causa.** El comando solo funciona con el debug activo al arrancar el recurso, y solo mientras estás en un trabajo en curso.

**Solución.** Pon `debug = true` o `setr cuxial_electrician_debug "1"`, reinicia el recurso e inicia un trabajo.

</details>

<details>

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

**Causa.** El idioma sale de la convar `ox:locale` de `ox_lib`.

**Solución.** Pon `setr ox:locale "es"` (o `"en"`) en `server.cfg` y reinicia el servidor.

</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-electrician/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.