Lo que falla con más frecuencia, lo que realmente significa y qué hacer al respecto. La mayoría de los problemas los explica la consola del servidor: en cada inicio, las comprobaciones de arranque muestran cada fallo con una ✗ y su solución, y los comandos de diagnóstico de Comandos y exports van más allá.
Instalación y acceso#
La consola no deja de mostrar "server.cfg is missing required permissions"
Las cinco líneas add_ace no están en server.cfg. Añádelas como se muestra en Instalación — o pégalas en la consola del servidor para aplicarlas al momento. Las skins funcionan sin ellas, pero no se pueden añadir ni quitar armas addon hasta que estén, y los admins ven el mismo aviso al abrir el panel.
Los jugadores se quedan retenidos en la pantalla de conexión con "Please restart the server"
Una sesión nueva no puede usar el pool de shells o el recurso de datos: falta, está incompleto o se reemplazó mientras el servidor estaba en marcha. Dejar entrar a los jugadores les daría una sesión en la que ninguna skin funciona, así que se les retiene. La consola indica el motivo cada 20 segundos.
Reinicia el servidor. Si vuelve a ocurrir, reinstala qs-weaponskin-pool desde la descarga y comprueba que se pueda escribir en qs-weaponskin-data. Settings → Shell pool → Hold players out when stale desactiva esta protección, a costa de esas sesiones rotas.
"Couldn't find resource qs-weaponskin-data" en el primer inicio
Es lo esperado. La carpeta no tiene manifest hasta que el creador escribe uno durante ese primer inicio y luego lo arranca. A partir del segundo inicio se encuentra con normalidad. Si las comprobaciones de arranque siguen informando del recurso de datos tras un segundo reinicio, añade las líneas add_ace.
"You don't have permission" en /weaponskincreator
En ESX, el grupo del jugador debe estar en Config.AdminGroups; en QBCore y Qbox necesita el permiso god o admin o el ace command; en standalone se necesita el ace command. Consulta Obtener acceso de administrador.
No se detecta el framework o el inventario
Se inicia después de Weapon Skin Creator, y la detección solo ve lo que ya está en ejecución. Muévelo por encima de ensure qs-weaponskin-creator. La consola confirma el framework al iniciar con Successfully loaded the framework. — o fíjalo a mano en config/config.lua.
El estudio no se abre con mi inventario
ox_inventory y qs-inventory incluyen adaptadores. Cualquier otro inventario que detecte el script también necesita uno — un archivo pequeño, descrito en Añadir un inventario. Copiar el adaptador standalone con el nombre de tu inventario basta para que funcione, con skins por tipo de arma.
Puse Config.Debug = true y no cambió nada
La salida de depuración es un ajuste: Settings → General → Debug logging. La línea de config/config.lua se reemplaza por él al iniciar.
Skins#
Una skin no se ve en mi arma
Ejecuta weaponskin_debug en F8 con el arma en la mano. Recorre la cadena en el orden en que puede fallar y se detiene en lo que está mal. Después, weaponskin_testskin pinta el arma de magenta directamente: si se vuelve magenta, la parte del juego funciona y el fallo está en la skin o en su entrega; si no, el pool no está cargado en ese cliente.
Los demás jugadores ven el arma original
Están fuera del Show radius (60 m por defecto), o todas las ranuras de esa arma están ocupadas en una multitud y When the pool is full está configurado para mostrar el arma original. weaponskin_slots muestra cómo se usan las ranuras. Ambos ajustes están en Settings → Skins.
Las skins animadas solo muestran un fotograma en otros jugadores
Es el comportamiento correcto. Las animaciones de otros jugadores están limitadas a un radio (25 m) y a un número a la vez (2), para que una multitud de ellas nunca cueste FPS; el resto muestra el primer fotograma. Ambos están en Settings → Animation.
"That skin is still waiting for approval"
La moderación está configurada en Before. Un admin la aprueba en la pestaña Moderation, y se aplica al arma al instante.
"Your skin inventory is full"
Compra una ranura desde el inventario, elimina una skin o aumenta Free slots en Settings → Skin inventory. Las skins pendientes de aprobación también cuentan.
Se rechaza un enlace de imagen
Cada pantalla carga una imagen enlazada directamente desde su host, así que el host debe permitir que otros sitios lean sus imágenes — muchos no lo permiten. Usa un enlace directo de imgur, un adjunto de Discord o Fivemanage. Con Allow any host desactivado, el host también debe estar en Config.Images.AllowedHosts.
La skin se aplica a todas las copias, no al arma que tengo en la mano
Las skins por arma necesitan un inventario que dé un número de serie a las armas — ox_inventory o qs-inventory — y Equipped per no debe estar en Per weapon type.
Tiendas y pintores#
El estudio dice que la tienda está cerrada, sin suministros o que necesita un pintor
La tienda está en Closed; se le acabaron los suministros — pide más en la pestaña Supplies del menú de gestión; o Self service está desactivado en Settings → Shops, así que los clientes necesitan un pintor.
Un pintor no puede invitar a nadie
El pintor debe fichar primero en el menú de gestión, y su rango necesita Paint customers' weapons. El cliente debe estar a menos de 4 m y el banco de trabajo debe estar libre. weaponskin_shop enumera lo que le falta a cada tienda — sin banco de trabajo, nadie que pueda pintar, nadie de servicio.
Los aprendices nunca pueden fichar
El rango Apprentice predeterminado no puede abrir el menú de gestión, que es donde se ficha. Dale a ese rango Open the management menu, o desactiva Clock in to paint en Settings → Shops.
Un pedido de suministros se rechaza o nunca llega
La caja no puede pagarlo — cada pedido se paga por adelantado — o la tienda no tiene punto de Supply delivery. Configúralo en el formulario de la tienda. La caja de suministros aparece ahí cuando llega, y cualquier miembro del personal la recoge.
"The till could not cover your wage"
La nómina se paga de la caja de la tienda. Deposita dinero en la pestaña Finance, baja los salarios de los rangos o desactiva Payroll en Settings → Shops.
No aparece nada en una tienda
El NPC, el banco de trabajo y los avisos solo existen mientras un jugador está dentro del área de la tienda. Comprueba que el área cubre el mostrador — Settings → General → Draw zones dibuja el contorno de cada tienda — y que la tienda tiene una posición de NPC si es una tienda con NPC.
Armas addon y Tebex#
Un arma addon no aparece en el escaneo o no se puede añadir
El pack debe estar en ejecución y declarar su arma en un WEAPONINFO_FILE. Cuando un arma aparece con un estado en lugar de Ready, el estado es el motivo: falta un modelo o una textura, texturas incrustadas en el modelo, ningún material pintable o un modelo demasiado grande para el presupuesto.
"Built — restart to activate"
El arma se construyó, pero no se pudo activar en vivo. Reinicia el servidor sin nadie conectado y se activará al iniciar.
Tebex: "does not know that transaction", "not complete" o "already redeemed"
El id no existe, el pago aún no se ha completado o ya se usó — cada transacción funciona una vez. Si en cambio se rechaza el secreto del servidor, revisa la convar indicada en Settings → Tebex.
Tebex: "That package is not sold on this server"
El nombre del paquete no está en Config.Tebex.Packages y ninguna skin del catálogo lo usa. El nombre debe coincidir exactamente con Tebex, incluidas mayúsculas y espacios. La transacción no se consume, así que el jugador puede volver a canjearla cuando esté asignada.
Claves de error#
Los callbacks y exports devuelven claves en lugar de frases, para que el mismo fallo se lea en el idioma de cada jugador. Las que más verás:
Clave | Significa |
|---|---|
| El jugador no puede pagar desde la cuenta elegida. |
| No hay ninguna ranura de skin libre. |
| A la skin del catálogo no le quedan copias. |
| La skin está pendiente de aprobación. |
| No es admin / el rango de la tienda no tiene ese permiso. |
| No está en la tienda, o no está dentro del área de una tienda. |
| La tienda está cerrada, se quedó sin suministros o necesita un pintor. |
| El pintor no ha fichado / el banco de trabajo está en uso. |
| La caja de la tienda no tiene tanto dinero. |
| Todas las ranuras de esa arma están en uso ahora mismo; la skin vuelve cuando se libere una. |
| El host de la imagen bloquea otros sitios o no está en la lista permitida. |
| Faltan las líneas add_ace en server.cfg. |
| Demasiadas solicitudes de un tipo. Los límites están muy por encima de lo que hace la interfaz, así que esto apunta a un cliente modificado. |
| El servidor no respondió a tiempo — normalmente por una base de datos lenta. |
¿Sigues atascado? Abre un ticket e incluye las comprobaciones de arranque de la consola del servidor, la salida de
weaponskin_debugy el orden deensureen tu server.cfg.