Los problemas más habituales tras instalar Cuxial Gardener, con la causa y la solución de cada uno.
El recurso no arranca
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:
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure sleepless_interact
ensure cuxial_jobs
ensure cuxial_gardener_assets
ensure cuxial_gardenerLa consola muestra un error al leer un módulo de cuxial_jobs
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.
Una línea roja en la consola dice que el trabajo pide otra versión de la librería
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.
El NPC o su blip no aparecen
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.
El NPC está, pero no hay opción para interactuar
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.
«No puedes hacer este trabajo»
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'.
«Tu perfil de jardinero aún no está listo»
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.
«Hay vehículos en la salida de los camiones»
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.
«No se pudieron sacar los vehículos»
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.
El camión está cerrado o la tripulación no tiene llaves
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.
La escalera es corta y la consola avisa de que no está en este build
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:
sv_enforceGameBuild 2944No se pueden entregar los camiones
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.
No se pueden plantar flores en ningún sitio
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.
El registro de Discord no recibe nada
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:
set cuxial_gardener_webhook "https://discord.com/api/webhooks/..."No se dan los premios en ítems
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.
Los comandos de staff dicen que no tienes permiso
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.
/gardfast no hace nada
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.
El panel no se abre o se queda en blanco
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/.
Los textos salen en otro idioma
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.