Los problemas más habituales tras instalar Cuxial Electrician, con la causa y la solución de cada uno.
El recurso no arranca
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:
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure sleepless_interact
ensure cuxial_jobs
ensure cuxial_electricianLa consola muestra una línea roja que dice que el trabajo pide una versión de la librería y hay otra instalada
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.
El NPC o el blip del trabajo no aparecen
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).
El NPC está, pero no hay opción para interactuar
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.
La opción aparece, pero el panel no se abre
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.
«No puedes hacer este trabajo»
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'.
«Tu perfil de electricista aún no está listo»
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.
«Hay vehículos en la salida de los camiones»
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.
«No se pudo sacar el camión»
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.
Los jugadores no pueden conducir el camión de servicio
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.
La escalera es demasiado corta para llegar a las farolas
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.
No se puede montar la plataforma en un poste
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.
No se pueden reparar los semáforos
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.
No se pueden entregar los camiones
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.
«Otra tripulación ya trabaja en esa región»
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.
Las reparaciones se rechazan por «demasiado lejos» o «demasiado rápido»
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.
No se entregan los ítems de recompensa
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.
No llegan los registros a Discord
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.
/elecfast no hace nada
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.
Los textos salen en otro idioma
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.