Los problemas más habituales tras instalar Cuxial PvP, con la causa y la solución de cada uno.
El recurso no arranca
Causa. Falta una dependencia o arranca después que el script. Cuxial PvP necesita OneSync, ox_lib y cuxial_bridge.
Solución. Activa OneSync e inicia antes las dependencias:
ensure ox_lib
ensure cuxial_bridge
ensure CuxiaPvPEl export falla con «No such export»
Causa. Se cambió el nombre de la carpeta. Los exports se llaman a través del nombre del recurso.
Solución. Mantén la carpeta como CuxiaPvP, o usa el nuevo nombre de carpeta en cada llamada: exports.<carpeta>:toggleUI(true).
Ninguna tecla abre el menú
Causa. La tecla del menú no tiene asignación por defecto, para no chocar con otros recursos.
Solución. Usa /Cuxiall, asigna «Abrir CuxiaPvP» en los ajustes de teclas de FiveM, o abre el menú desde tu propio recurso con exports.CuxiaPvP:toggleUI(true).
El comando se ejecuta pero no aparece el menú
Causa. La interfaz no está cargando. Falta la carpeta web/build o está incompleta, normalmente tras una subida parcial.
Solución. Vuelve a copiar el recurso desde el paquete que descargaste, comprobando que web/build se sube entera, y reinicia el recurso.
Los jugadores empiezan el duelo sin arma
Causa. El arma elegida no existe en tu servidor. Las armas de data/weapons.lua son ejemplos e incluyen armas add-on.
Solución. Deja en data/weapons.lua solo armas que tenga tu servidor y añade sus imágenes a web/build/weapons. Haz lo mismo con ladder y finisher en data/gungame.lua.
Los jugadores caen al vacío al empezar un duelo
Causa. El mapa usa coordenadas de una arena que no está en tu servidor. Los mapas de data/maps.lua son ejemplos.
Solución. Sustituye los puntos de aparición de cada mapa por coordenadas de tus propias arenas, o quita los mapas que no tengas.
Los jugadores siguen muertos entre rondas o después de la partida
Causa. Los eventos de revive.events no son los de tu script de ambulancia, o revive.enabled está en false.
Solución. Pon en revive.events el evento de cliente que revive en tu script de ambulancia y deja revive.enabled = true. Consulta Configuración.
La hora del día no cambia, o se queda congelada después de la partida
Causa. weatherSystem no coincide con el script de hora que usas.
Solución. Pon weatherSystem = 'av' para av_weather o 'cd' para cd_easytime en data/config.lua.
«No hay zonas configuradas para esta modalidad» al crear un Gun Game
Causa. data/gungame_zones.lua no tiene zonas.
Solución. Dibuja una dentro del juego con /pvpzone gungame <nombre>. Consulta Comandos y permisos.
«No se pudo guardar la zona»
Causa. El jugador no tiene el permiso ACE, o la zona tiene menos de tres esquinas.
Solución. Concede el permiso y vuelve a dibujar la zona:
add_ace group.admin cuxialpvp.zones allow«Falta cuxial_bridge o su herramienta de zonas»
Causa. El cuxial_bridge instalado es anterior al que se entrega con el script.
Solución. Actualiza cuxial_bridge a la versión incluida en tu descarga y reinicia el servidor.
Un mapa, un arma o una zona no muestra imagen
Causa. Falta la imagen o su nombre no coincide con el value de la entrada.
Solución. Nombra el archivo exactamente igual que el value, respetando mayúsculas y minúsculas:
| Entrada | Imagen |
|---|---|
| Mapa | web/build/maps/<value>.png |
| Arma de duelo | web/build/weapons/<value>.png |
| Zona de Gun Game | web/build/zones/<value>.webp |
Las armas de la escalera de Gun Game toman su icono de ox_inventory.
Todos muestran el avatar por defecto de Discord
Causa. discord.botToken está vacío o no es válido. Los jugadores sin cuenta de Discord vinculada muestran siempre el avatar por defecto.
Solución. Crea un bot en el portal de desarrolladores de Discord y pega su token en discord.botToken de data/config.lua. El bot no necesita permisos.
Un jugador no puede apostar
Causa. Las apuestas se pagan en efectivo, y cada jugador puede apostar una vez por partida.
Solución. El jugador necesita el importe en efectivo, no en el banco.
«Ya tienes una sala abierta» o «No caben más salas ahora mismo»
Causa. Se alcanzaron los límites de data/config.lua.
Solución. Sube limits.maxLobbiesPerHost o limits.maxLobbies. Consulta Configuración.
La clasificación está vacía tras cada reinicio
Causa. leaderboard.clearOnRestart está en true.
Solución. Ponlo en false en data/config.lua.