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

El recurso no arranca

Causa. Falta una dependencia o arranca después. Cuxial Gang necesita OneSync, ox_lib, oxmysql y cuxial_bridge.

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

server.cfg

ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_gang

La consola muestra una consulta fallida al arrancar

Causa. El usuario de la base de datos no puede crear o modificar tablas, o la tabla player_vehicles no existe porque el framework no es QBox ni QBCore.

Solución. Da al usuario permiso para crear y modificar tablas y reinicia. La consola imprime la consulta, sus parámetros y el motivo. Si prefieres crear las tablas a mano, usa los archivos de install/.

/crimeadmin no hace nada o no se reconoce

Causa. Al jugador le falta uno de los dos requisitos: el grupo de commands.panel.restricted (group.mod por defecto) o el ACE de admin.ace (mod por defecto).

Solución. Concede los dos en server.cfg y reinicia:

server.cfg

add_ace group.mod mod allow
add_principal identifier.license:xxxxxxxx group.mod

Un panel abre el cursor pero no muestra nada

Causa. La interfaz no carga. La carpeta web/dist falta o está incompleta, normalmente tras una subida parcial.

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

Los marcadores de la sede no aparecen

Causa. Una de estas:

• Los puntos de la organización nunca se colocaron en el panel de staff.
• El rango del miembro no tiene el permiso de ese punto.
• El servicio necesita una mejora que la organización no ha comprado.
• El servicio está apagado en su archivo (Disable = true, o garage.disabled).

Solución. Coloca los puntos en /crimeadmin, revisa el rango en el menú de jefe y compra la mejora.

/crimetablet no existe

Causa. tablet.asItem es true, así que la tablet solo se abre con el ítem.

Solución. Pon tablet.asItem = false, o da a los jugadores el ítem indicado en tablet.item.

Usar el spray, el quitagrafitis o el móvil desechable no hace nada

Causa. El ítem no existe en tu inventario con el nombre definido en data/graffiti.lua o data/drugselling.lua, o el inventario no ejecuta el ítem usable que registra el recurso. En los grafitis, disabled puede estar en true.

Solución. Añade los ítems como se indica en Instalación. Para el spray y el quitagrafitis puedes apuntar el ítem a los exports cuxial_gang.useSpray y cuxial_gang.useRemover.

No aparece ningún comprador al vender droga

Causa. Una de estas:

• El jugador no lleva ningún ítem de la lista drugs de data/drugselling.lua.
• Hay menos policías de servicio que requiredCops.
• No ha pasado el cooldown entre dos usos del móvil desechable.

Solución. Pon en drugs los ítems de droga de tu servidor y ajusta requiredCops.

Las ventas nunca avisan a la policía

Causa. El aviso se envía a través de cuxial_police. Sin él en marcha no se envía ninguno.

Solución. Arranca cuxial_police antes que Cuxial Gang.

Los vehículos de la organización salen sin llaves

Causa. Las llaves se entregan a través de cuxial_garages. Sin él en marcha, Cuxial Gang no da llaves.

Solución. Arranca cuxial_garages antes que Cuxial Gang.

Un vehículo ha desaparecido y el garaje lo muestra como fuera

Causa. El vehículo fue destruido o eliminado mientras estaba fuera.

Solución. Un miembro lo recupera desde el garaje pagando garage.recover.cost. Tras un reinicio del servidor, los vehículos que estaban fuera vuelven gratis con garage.returnOnRestart = true.

El médico clandestino no revive

Causa. El revivir lo hace cuxial_medical. Sin él en marcha el médico no hace nada y la consola lo avisa. Además la organización necesita la mejora, y el jugador el precio en el ítem definido en PriceItem.

Solución. Arranca cuxial_medical antes que Cuxial Gang y revisa la mejora y el dinero.

El vestuario no guarda ni pone conjuntos

Causa. El vestuario lee y aplica la ropa a través de cuxial_appearance. Guardar y borrar necesitan además el permiso del menú de jefe.

Solución. Arranca cuxial_appearance, o pon clothingScript = 'tgiann_clothing' en data/clothing.lua con tgiann-clothing en marcha.

El banco del arsenal o de la favela no existe

Causa. Los dos se apoyan en nextgenfivem_crafting. Sin él en marcha no hay bancos. Con él, el tipo de banco y las recetas se crean al arrancar, pero los bancos los coloca el staff en el editor de ese recurso.

Solución. Arranca nextgenfivem_crafting antes que Cuxial Gang y coloca un banco del tipo indicado en benchType.

El pase de temporada premium no se puede comprar

Causa. seasonPass.customCurrency es true, o la organización no tiene el precio en su saldo limpio.

Solución. Pon seasonPass.customCurrency = false y aporta saldo limpio. El precio se edita en el panel de staff.

/startraid no existe

Causa. Las redadas están desactivadas por defecto.

Solución. Pon enable = true en data/raids.lua y añade tus trabajos de policía a allowedJobs.

No se puede iniciar una redada

Causa. Uno de los límites de data/raids.lua: la hora está fuera de raidTime, el trabajo o la organización están en espera, no hay suficientes jugadores conectados, el grado es demasiado bajo, o adminMode.enable es true y el staff no la ha aprobado.

Solución. Revisa esas opciones. Con el modo admin activado, el staff aprueba con /approveraid <jobname> <gangid>.

Nunca cae ningún airdrop

Causa. enabled es false en data/airdrop.lua, la hora está fuera de SpawnTimeWindow, o no hay sitios utilizables.

Solución. Revisa los sitios en el panel de staff y lanza uno a mano con /startAirDrop para probar. La consola dice por qué ha fallado un lanzamiento.

Los horarios se ejecutan a una hora equivocada

Causa. timeZone no es la zona de tu servidor, o la API de hora no respondió y se está usando el reloj de la máquina. La consola lo indica al arrancar.

Solución. Pon en timeZone tu zona IANA. Para saltarte la API y usar siempre el reloj de la máquina, pon timeApi = ''.

Los registros no llegan a Discord

Causa. La convar está vacía o tiene un nombre distinto del de logs.general o logs.admin.

Solución. Añade las convars a server.cfg antes de que arranque el recurso. Se leen una sola vez, al arrancar:

server.cfg

set cuxial_gang_webhook "https://discord.com/api/webhooks/..."
set cuxial_gang_webhook_admin "https://discord.com/api/webhooks/..."

Con la depuración activada, la consola dice si cada webhook está configurado.

Los alijos no se abren, o cachear a un jugador no hace nada

Causa. El inventario no es ox_inventory. Los alijos y el cacheo se apoyan en él.

Solución. Usa ox_inventory.

La tecla de interacción no hace nada

Causa. El jugador no está en una organización, no hay nadie al alcance, o rope.enabled es false. Un cambio en rope.keybind.key solo se aplica a quien entra por primera vez.

Solución. Revisa la organización y la distancia. Los jugadores cambian la tecla en los ajustes de GTA, en las asignaciones de teclas de FiveM.