Los problemas más habituales después de instalar Cuxial Diving, con la causa y la solución de cada uno.

El recurso no arranca

Causa. Falta una dependencia. Cuxial Diving necesita OneSync, ox_lib, oxmysql, cuxial_bridge, sleepless_interact, cuxial_jobs y cuxial_diving_assets.

Solución. Comprueba que las tres carpetas del paquete están en resources con sus nombres originales, activa OneSync y arranca antes las dependencias:

server.cfg

ensure ox_lib
ensure oxmysql
ensure ox_inventory
ensure sleepless_interact
ensure cuxial_bridge
ensure cuxial_jobs
ensure cuxial_diving_assets
ensure cuxial_diving

La consola avisa de ítems que no existen en el inventario

Causa. Al arrancar, el trabajo comprueba todos los ítems que usa: botellas, máscara, globo, botín y mercado. Uno o más no están definidos en tu inventario.

Solución. Añade a tu inventario las entradas de install/items.lua. Si has cambiado el nombre de alguno en tu inventario, usa los mismos nombres en data/loot.lua y data/market.lua.

El NPC no está, o no hay opción para hablar con él

Causa. Una de estas:

• npc.model no es un modelo de ped válido.
• sleepless_interact arrancó después de Cuxial Diving, así que la interacción se registró en otro target.
• Estás más lejos que npc.spawnDistance o npc.distance.

Solución. Usa un modelo válido y arranca sleepless_interact antes de cuxial_bridge y cuxial_diving.

El panel no se abre o se queda vacío

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, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

«El buceo aún se está iniciando, prueba en unos segundos»

Causa. Las tablas no están listas. O el servidor acaba de arrancar, o oxmysql no pudo crearlas.

Solución. Espera unos segundos. Si el mensaje sigue, busca errores de oxmysql en la consola del servidor. El usuario de la base de datos necesita permiso para crear tablas.

«No puedes hacer este trabajo»

Causa. job en shared/config.lua es un nombre de trabajo o una lista, y el trabajo del jugador no está en ella. La comprobación se aplica también a todos los miembros de la tripulación al empezar.

Solución. Añade el trabajo a la lista, o pon job = 'all'.

No se puede elegir una región

Causa. Al menos un miembro de la tripulación está por debajo del minLevel de la región. El panel indica quién.

Solución. Elige una región inferior, o baja minLevel en data/regions.lua.

«Hay un barco en el punto de salida»

Causa. Todos los puntos de salida de la región tienen un vehículo a menos de run.spawnFreeRadius metros. Puede ser el barco de otra tripulación o cualquier vehículo abandonado.

Solución. Despeja la zona, añade más puntos a spawns en data/regions.lua o baja run.spawnFreeRadius.

«No se pudo sacar el barco»

Causa. El servidor no pudo crear el barco a tiempo. OneSync está desactivado, boat.model no es un barco válido o el servidor va cargado.

Solución. Activa OneSync, revisa boat.model y sube boat.spawnTimeoutMs si hace falta.

La tripulación no puede conducir el barco

Causa. Tu sistema de llaves de vehículos bloquea el barco. Cuxial Diving solo reparte llaves a través de cuxial_garages, y solo con boat.keys = true.

Solución. Arranca cuxial_garages antes de cuxial_diving, o exime en tu propio sistema de llaves las matrículas que empiezan por el prefijo de boat.plate.

La botella o la máscara no hacen nada al usarlas

Causa. El script responde con el motivo:

• «No hay ningún trabajo en marcha»: gear.requireRun es true y el jugador no tiene un trabajo en curso.
• «No puedes hacerlo en un vehículo»: el equipo no se puede poner sentado, tampoco en el barco.
• «Ponte primero una botella»: la máscara necesita una botella puesta.
• Sin ningún mensaje: el nombre del ítem en tu inventario no es el que está escrito en data/gear.lua.

Solución. Levántate antes de usar el equipo, usa primero la botella y conserva los nombres de ítem de data/gear.lua. Pon gear.requireRun = false para permitir el equipo fuera de un trabajo.

«No se pudo poner el equipo: se ha devuelto»

Causa. El juego del jugador no terminó de poner el equipo dentro de gear.confirmMs, así que el ítem se devolvió.

Solución. Inténtalo de nuevo. Si pasa a menudo, sube gear.confirmMs.

Las piezas no aparecen en el sitio

Causa. Las piezas se colocan cuando un miembro de la tripulación está a menos de site.spawnRadius del centro de una tarea, y tienen que quedar bajo el agua: por debajo de site.surfaceZ y no más de site.maxDepthDelta metros bajo el centro. Un center en tierra, o muy por encima del fondo, no se puede rellenar. Los jugadores ven «No se pudo preparar la zona, se volverá a intentar».

Solución. Pon en center, en data/regions.lua, un punto del fondo del mar, con espacio alrededor para el radius y el amount de la tarea.

La maleta no se puede abrir

Causa. El jugador no lleva en la mano el arma definida en suitcase.weapon, un cuchillo por defecto.

Solución. Lleva el cuchillo en la mano, que se vende en el mercado del trabajo, o pon suitcase.weapon = 'WEAPON_UNARMED' para quitar el requisito.

La cuerda no se puede lanzar

Causa. Una de estas:

• El ancla está levada. El script responde «Echa el ancla primero».
• La caja todavía está subiendo.
• El jugador no está sentado en el barco ni de pie en su cubierta.
• El barco está a más de tow.maxDistance de la caja.

Solución. Acerca el barco a la caja que flota, echa el ancla con H desde un asiento y lanza la cuerda con E.

El globo de elevación muestra otro prop

Causa. El modelo de boxes.liftbagModel no está disponible, así que el script usa boxes.liftbagFallback. cuxial_diving_assets está incompleto o no se reinició después de copiarlo.

Solución. Vuelve a copiar cuxial_diving_assets desde el paquete y reinicia el servidor.

El barco no se puede entregar

Causa. Las tareas obligatorias no están terminadas, el barco está a más de deliver.radius del punto de entrega o el jugador no está sentado en el barco.

Solución. Termina los corales y la basura, navega hasta el blip de entrega y pulsa E desde un asiento.

El mercado muestra ítems sin imagen o con su nombre interno

Causa. Las imágenes se leen de la carpeta de imágenes de ox_inventory, y los nombres de las definiciones de ítems de tu inventario.

Solución. Copia install/images/*.webp a ox_inventory/web/images/ y comprueba que todos los ítems de data/market.lua existen en tu inventario. Las imágenes tienen que ser archivos .webp con el nombre del ítem.

Los comandos de staff responden que el jugador no tiene permiso

Causa. El jugador no está en el grupo definido en restricted, group.admin por defecto.

Solución. Añade al jugador al grupo en server.cfg, o cambia restricted en el bloque commands.

/divingfast no hace nada

Causa. La depuración estaba desactivada cuando arrancó el recurso, o el jugador no tiene un trabajo en curso.

Solución. Pon debug = true o la convar cuxial_diving_debug a 1, reinicia el recurso y empieza un trabajo.

He cambiado una tecla en el config pero los jugadores siguen con la antigua

Causa. El bloque keys solo define valores por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su asignación de tecla.

Solución. Cada jugador la cambia en los ajustes de GTA, en las asignaciones de teclas de FiveM. Los jugadores nuevos reciben el nuevo valor por defecto.

Los registros no llegan a Discord

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

Solución. Añade la convar a server.cfg por encima de la línea ensure. Se lee una vez, al arrancar el recurso:

server.cfg

set cuxial_diving_webhook "https://discord.com/api/webhooks/..."

Los textos aparecen en otro idioma

Causa. El trabajo sigue la convar ox:locale. Los nombres de los ítems salen de tu inventario, no del trabajo.

Solución. Define la convar en server.cfg y reinicia. Se incluyen en y es:

server.cfg

setr ox:locale "es"