Lo que falla con más frecuencia, lo que significa en realidad y qué hacer al respecto. Para cualquier cosa que no aparezca aquí, define Config.Debug = true: la mayoría de los problemas se identifican solos en la consola.
Instalación y arranque#
"You have renamed the script!" y el servidor se bloquea
La carpeta debe llamarse exactamente qs-outfitbag. La comprobación del nombre se ejecuta al iniciar y detiene el servidor a propósito cuando falla. Devuelve a la carpeta su nombre y vuelve a iniciar.
Usar el ítem no hace nada
Comprueba, en orden:
El nombre del ítem en tu inventario coincide exactamente con
Config.ItemName.El ítem es usable:
useable = trueen qb-core y qs-inventory.Tu framework se inicia antes de
qs-outfitbag. Si no, el script funciona en modo standalone y nunca registra el ítem.Con debug activado, la consola dice qué framework encontró.
La consola dice "No matching dependencies found"
No había nada de la lista de frameworks o targets en ejecución cuando se inició qs-outfitbag. Mueve ensure qs-outfitbag debajo de tu framework y tu target en server.cfg, o fíjalos con Config.Framework y Config.Target — consulta Integraciones.
El texto dice "Translation [xx][KEY] does not exist"
Config.Language apunta a un código sin archivo en locales/, o a tu propio archivo de idioma le falta esa clave. Copia las claves que faltan de locales/en.lua.
Los iconos de la ventana se ven como cuadrados vacíos
La ventana de la bolsa carga sus iconos y su fuente desde cdnjs y Google Fonts. Un jugador cuya conexión bloquea esas direcciones ve cuadrados donde deberían estar los cuatro iconos de aplicar. Todo sigue funcionando; los iconos están en el mismo orden: atuendo completo, parte inferior, parte superior, accesorios y después la papelera.
Bolsas#
La bolsa se abre, pero no hay lista ni botón Save
La bolsa está bloqueada; todas lo están al colocarse. El dueño pulsa el candado y aparecen la lista y Save Outfit. La bolsa bloqueada de otra persona sigue vacía hasta que su dueño la desbloquea. Consulta Uso → Bloqueo y compartir.
La bolsa es invisible o nunca aparece
Config.BagModel es un prop que tu versión del juego no tiene. El modelo por defecto es un prop de DLC y solo existe en una versión del juego que lo incluya: sube sv_enforceGameBuild, o cambia a un prop clásico como prop_cs_heist_bag_02.
No aparece la opción Pick Up Bag
Solo el jugador que colocó la bolsa puede recogerla, y la opción solo se le muestra a él. Con qs-textui y el aviso integrado es la tecla G en lugar de una entrada de menú.
Otros jugadores no ven Use Bag en mi bolsa
La opción llega a los demás jugadores cuando se coloca la bolsa, o un par de segundos después de que entren. Un jugador que está lejos espera hasta 30 segundos a que la bolsa se cargue; si llega más tarde, recoge la bolsa y vuelve a colocarla con él cerca.
Mi bolsa desapareció, y el ítem con ella
Su dueño se desconectó, o se reinició el recurso o el servidor. Las bolsas colocadas no se guardan, y solo recoger una devuelve el ítem. Los atuendos no se tocan: se guardan por jugador y se abren en la siguiente bolsa.
Usar el ítem dos veces rápido solo coloca una bolsa
Hay una pausa de dos segundos entre colocaciones. Espera un momento y vuelve a usarlo.
Atuendos#
Los atuendos no se guardan
Comprueba que existe la tabla outfitbag_outfits. Se crea cuando oxmysql está listo, así que oxmysql debe iniciarse antes y tu usuario de la base de datos necesita permiso para crear tablas. Un error poco frecuente de Duplicate entry significa que el id aleatorio ya estaba ocupado: vuelve a guardar.
El atuendo se reinicia tras reconectar
Por defecto, un atuendo aplicado no se pasa a tu recurso de ropa. Activa Config.PersistOutfitToClothing — después de leer la advertencia en Uso → Atuendos persistentes si la ropa son ítems en tu servidor.
Los jugadores reciben ítems de ropa después de aplicar un atuendo
Config.PersistOutfitToClothing está activado con un inventario que convierte la ropa en ítems. Desactívalo: el inventario vuelve a dar los ítems cada vez que se guarda un atuendo en el recurso de ropa.
El atuendo se ve mal en otro personaje
Los números de drawable pertenecen a un modelo de ped. Un atuendo guardado en un personaje masculino se pone en uno femenino con las piezas más cercanas que tenga, que rara vez coinciden. Guarda un atuendo distinto para cada modelo.
El pelo o la cara no cambiaron
Es el comportamiento correcto. Los atuendos solo llevan ropa y props; la cara, el pelo y las calcomanías nunca se tocan.
Todos mis personajes comparten un armario, o cada uno tiene el suyo
Depende del identificador que proporcione tu framework. En QBCore los atuendos están ligados a la licencia, así que todos los personajes de la cuenta los comparten; en Qbox y en un servidor ESX multipersonaje cada personaje tiene los suyos. La tabla está en Integraciones → Frameworks.
Bolsas de uniforme#
"You are not allowed to use this bag!"
El trabajo del jugador no está en la lista jobs de la bolsa. Los nombres deben coincidir exactamente con el nombre del trabajo en tu framework: police, no Police. Define public = true para abrirla a todo el mundo. Un servidor standalone no tiene trabajos, así que ahí solo se abren las bolsas públicas.
El jugador se arrodilla en el sitio equivocado
Define pedpos en un punto justo delante de la bolsa, con una orientación que mire hacia ella. Sin pedpos, el jugador se arrodilla en la propia posición de la bolsa.
No aparece una bolsa de uniforme
Comprueba que pos está justo por encima del suelo que quieres (la bolsa se deja caer al suelo bajo ese punto) y que Config.BagModel existe en tu versión del juego. Las bolsas de uniforme aparecen un segundo después de que se inicie el recurso.
¿Sigues atascado? Abre un ticket e incluye tu framework, target e inventario, tu
shared/config.luay la salida de la consola conConfig.Debug = true.