Lo que falla con más frecuencia, lo que significa realmente y qué hacer al respecto. La mayoría de estos casos son de configuración, no fallos — y el script incluye comandos de consola que dicen exactamente qué filtro se cerró. Ejecuta el que corresponda antes de abrir un ticket.
Instalación y acceso#
La interfaz es una página en blanco o no se abre
La interfaz viene compilada en web/build/. Si esa carpeta falta o se copió a medias, la página queda en blanco sin ningún error en el juego — vuelve a copiar el recurso completo. Si F6 no hace nada, otro recurso tiene esa tecla: reasígnala en Settings → Key Bindings → FiveM del juego, o cambia Config.Keybind.
"You do not have permission" en /qsdealershipadmin
Ejecuta qs-dealership:checkadmin <id> en la consola del servidor. Nueve de cada diez veces el ace está en server.cfg pero el recurso no se reinició después de añadirlo, o el identificador pertenece a una cuenta distinta de la que se usa en el juego.
El resumen de arranque dice vanilla para algo que tengo
Ese recurso se inicia después de Dealership Creator, y la detección solo ve lo que ya está en ejecución. Mueve su ensure por encima de ensure qs-dealership, o fíjalo a mano en config/shared/config.lua.
Edité defaults.lua y no cambió nada
Es el comportamiento correcto. server/modules/main/defaults.lua solo inicializa los ajustes de un servidor completamente nuevo. Tras el primer arranque, los ajustes viven en la base de datos — cámbialos en las páginas Settings del creador.
El jugador se queda con un cursor y no puede cerrar nada
El recurso se reinició mientras había una ventana abierta y el reinicio se interrumpió. /qsdealership de nuevo la cierra.
Concesionarios y la sala de exposición#
El aviso del mostrador no aparece
Ejecuta qs-dealership:browsecheck <id> — indica el filtro. Las causas habituales: el concesionario no tiene stock (una sala de exposición sin nada que vender se niega a abrirse a propósito — añade un vehículo desde F6 → My dealerships → Stock), está cerrado por su horario de apertura, o el recurso de target se inició después de este. Un mostrador ped o prop en un recurso de target que no puede apuntar a entidades recurre a un marcador. qs-dealership:counters en la consola F8 muestra lo que tu cliente cree sobre cada mostrador.
"You are too far away"
La sala de exposición coloca al cliente junto al coche de exhibición, que puede estar en una sala bajo el mapa. El script acepta a un jugador cerca del mostrador o cerca de cualquier lugar donde el concesionario muestre coches. Si moviste el punto de vista previa mientras alguien estaba dentro, tiene que salir y volver a entrar.
No se puede comprar un coche
O bien no tiene precio (la fila del catálogo dice 0 y la tienda no fijó ninguno), no se vende en esa moneda (la franja de monedas de la fila la tiene desactivada, o una moneda no tiene cifra), la moneda no está activada en Settings → Payments, o el jugador alcanza la reserva — tiene el dinero, pero se quedaría por debajo del mínimo.
Falta un coche en el catálogo o en un concesionario
Pulsa Import from game desde un cliente que tenga todos los addons instalados — lee lo que tu cliente puede generar. Un coche desactivado en el catálogo, en la lista negra o de un tipo con el que el concesionario no trabaja se oculta a propósito en ese concesionario.
Nadie puede subir a los coches de exhibición
Es el comportamiento correcto. Los coches de exhibición son el escaparate: cerrados, congelados y sólidos. Pulsar uno abre la sala de exposición con ese coche.
Concesionarios con dueño y rutas de reposición#
El personal no puede ver o hacer algo en su tienda
Ejecuta qs-dealership:checkstore <id> <dealership>. Muestra cuáles de los nueve permisos tiene ese jugador allí y por qué. Los rangos son por tienda: un rango en un concesionario no dice nada sobre otro.
No hay ninguna ruta de reposición que aceptar
Settings → Restock runs → Enabled está desactivado, así que los pedidos llegan directamente al stock. Es una función, no un fallo.
El pedido fue rechazado, o la ruta nunca aparece
La caja de la tienda no pudo pagar el pedido — cada unidad se paga por adelantado —, o ningún punto de recogida acepta ese tipo de vehículo, o todos los que lo aceptan ya tienen un envío esperando. El estante Supply indica cuál es en el propio coche.
El personal no puede amueblar la explanada
El concesionario no tiene terreno. Un concesionario sin contorno no se puede amueblar en absoluto; un administrador tiene que dibujarlo primero en la pestaña Points del creador. Quien amuebla también necesita el permiso Settings.
Imágenes y música#
Las imágenes de los vehículos no se muestran
Abre la consola F8 en el juego y busca un 404: ahí se imprime la dirección que construyó el script. Comprueba la carpeta, el nombre del archivo (el nombre del modelo, en minúsculas) y la extensión en Settings → Vehicle images. Los vehículos de serie siempre recurren a las capturas de la propia documentación de FiveM.
El estudio fotográfico no hace nada
Necesita screenshot-basic en ejecución, y un proveedor de subida en Settings → Vehicle images: una clave de Fivemanage, una dirección personalizada o la carpeta de este propio servidor. Con this server, reinicia el recurso cuando termine la sesión — los archivos nuevos solo se sirven tras un reinicio.
Se saltan las pistas de YouTube
YouTube solo reproduce un vídeo dentro de otro programa cuando el dueño del vídeo lo permite, y la mayoría de las subidas de discográficas no lo hacen. El reproductor salta los vídeos rechazados y recurre al audio directo. Para la música que tenga que sonar sí o sí, pon los archivos en la carpeta music/ y escribe solo el nombre del archivo.
Claves de error#
Los callbacks y los exports devuelven claves de locale en lugar de frases, así que el mismo fallo se lee en el idioma de cada jugador. Las que más probablemente encontrarás:
Clave | Significado |
|---|---|
| El script no ha terminado de cargar sus ajustes y concesionarios. Vuelve a intentarlo en un momento. |
| El jugador hizo demasiadas peticiones de ese tipo en un minuto. Auméntalo en Settings → Rate limits si ocurre en el juego normal. |
| Al jugador le falta el permiso — en todo el servidor o en esa tienda. |
| El id del concesionario no existe, o se eliminó. |
| Una colocación quedó fuera del terreno del concesionario. |
| La caja de la tienda no puede cubrir una compra de stock o de muebles. |
| Ningún punto de recogida acepta ese tipo de vehículo. |
| El servidor no respondió a tiempo. Normalmente, una base de datos lenta. |
¿Sigues atascado? Abre un ticket e incluye tu resumen de arranque (las líneas
[compat]), la salida del comando de comprobación correspondiente de arriba, y tu framework y su versión. Una captura de la consola F8 ayuda con cualquier cosa relacionada con la interfaz.