Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría son de configuración, no fallos: el script le dice al jugador exactamente qué regla lo dejó fuera, y con Config.Debug = true la consola cuenta el resto. Lee el mensaje y búscalo abajo.
Instalación y acceso#
La consola repite "Using standalone inventory"
Tu inventario no se detectó. Se inicia después de Shops Creator, o se renombró su carpeta. Mueve su ensure por encima de ensure qs-shops-creator en server.cfg, o añade el nuevo nombre de la carpeta a la tabla inventories en config/main.lua. En modo standalone, la lista de ítems del creador está vacía.
El recurso se detiene con un error sobre el framework
No había ningún framework compatible en ejecución cuando se inició. Shops Creator necesita es_extended, qb-core o qbx_core iniciado antes que él. Una carpeta de framework renombrada va en la tabla frameworks en config/main.lua.
"You do not have permission to do this." en /shopcreator
No eres administrador del framework ni estás en Config.CreatorJobs. En ESX el grupo debe ser admin o superadmin; en QBCore y Qbox, el permiso god o admin, o el ace command. Para un trabajo, comprueba que los números de rango de Config.CreatorJobs coinciden con los rangos de tu framework — grade = false los permite todos. Reinicia el recurso después de editar la config.
Errores sobre tablas o columnas que faltan
database/database.sql no se importó, o se importó antes de que una actualización añadiera nuevas columnas. Impórtalo de nuevo: solo crea lo que falta y nunca sobrescribe tus tiendas.
La interfaz no se abre, o se abre en blanco
La interfaz viene lista para usar en web/. Si esa carpeta falta o está copiada a medias, vuelve a descargar el recurso desde el CFX Portal y copia de nuevo la carpeta entera — no copies archivos sueltos sobre una versión antigua.
El jugador se queda atascado con el cursor
El recurso se reinició mientras había un menú abierto. Abrir y cerrar cualquier tienda devuelve el control; reconectarse siempre lo hace.
Abrir una tienda#
No aparece ningún aviso en la tienda
El aviso está sobre el tendero, no en toda la zona. Acércate a la posición del ped — dentro de su distancia de interacción — en lugar de a la puerta de la tienda. Si el tendero está desactivado en el panel Shop, no hay ningún punto de interacción. Con Config.UseTarget = true, comprueba que ox_target o qb-target se inicie antes que Shops Creator.
"CLOSED" u "Opens in 2h 15m"
La tienda tiene horario de apertura y está fuera de él. El horario sigue el reloj del juego o la hora UTC real, según se configure en el panel Opening Hours. El tendero se va mientras la tienda está cerrada y vuelve al abrir.
"You do not have access to this shop. Reason: …"
El motivo nombra la regla: Required job, Required grades, Required gang, Required gang grades, o You need these items in your inventory. Se configuran en el panel Access Control. Los ítems requeridos deben estar en el inventario del jugador — no en un stash ni en un vehículo.
Se abre una ventana "Buy Shop" en lugar de la tienda
Es el comportamiento correcto. La tienda tiene la propiedad activada y nadie la ha comprado todavía, así que la primera interacción la ofrece en venta. Desactiva la propiedad en el panel Ownership si la tienda solo debe venderles a los jugadores.
Faltan algunas categorías o ítems para algunos jugadores
Las categorías se pueden limitar a trabajos, rangos o ítems, exigiendo todas o cualquiera de esas condiciones. Un jugador que no las cumple no ve la categoría ni sus ítems. Revisa los ajustes de acceso de la categoría en el Category Manager.
Comprar y vender#
"Your cart is empty or invalid."
Todos los ítems del carrito fueron rechazados: sin stock, más de lo que queda en stock o la tienda ya no los vende. El stock es compartido y en tiempo real — otro jugador puede haber comprado las últimas unidades mientras el carrito estaba abierto.
"You do not have enough inventory space for these items."
El inventario del jugador está lleno o pesa demasiado. No se cobró nada: el dinero solo se retiene cuando se entregan todos los ítems, y cualquier ítem ya entregado se retira.
Se rechaza el método de pago
La tienda solo acepta los métodos marcados para ella en el creador — Config.DefaultMoneyType si no se marcó ninguno. Las tiendas de venta siempre pagan con el primer método de la tienda.
"This shop does not have enough money to afford your items."
La tienda de venta tiene dueño, y su saldo no alcanza para lo que te pagaría. El dueño tiene que depositar dinero desde la sección Finance del menú de jefe.
"Sale failed. The funding society does not have enough money."
La tienda de venta está financiada por una o más sociedades de trabajo, y la cuenta de la sociedad indicada no alcanza para cubrir su parte. Recarga la cuenta de ese trabajo o cambia los porcentajes en el panel Access Control.
Una tienda de venta dejó de comprar un ítem
Ese ítem tiene una cantidad máxima, y la tienda ya la compró entera. Súbela en el creador, ponla en ilimitada o repón el stock desde otro script con SetItemStock.
Tiendas con dueño y el menú de jefe#
"Your permission to access the boss menu is denied."
Solo el dueño y los empleados con Access Boss Menu pueden abrirlo. El dueño contrata y asigna permisos desde la sección Employees. Una tienda sin dueño no tiene menú de jefe.
No encuentro el menú de jefe
Se abre en un punto aparte, colocado en el panel Ownership del creador — normalmente un mostrador o una oficina dentro de la tienda — y no en el tendero. El aviso dice Press [E] to access the boss menu.
Un empleado no ve Employees ni Finance
Es el comportamiento correcto. Los empleados tienen cuatro permisos — Manage Inventory, Access Boss Menu, Manage Promotions y Manage Shop Settings. Contratar, despedir y el dinero de la tienda quedan en manos del dueño.
No aparece nadie al contratar
Solo se puede contratar a jugadores que estén a menos de 10 metros de ti y que no sean ya empleados. Llévalos a la tienda.
No se puede depositar un ítem en el stock
La tienda tiene restricciones en el panel Ownership: una lista blanca de ítems que puede almacenar, una lista negra que no, o un máximo por ítem o en total. Los ítems fuera de esas reglas no aparecen en la lista de depósito.
"Invalid resell price" al vender la tienda
El porcentaje de reventa de la tienda es 0, así que venderla no pagaría nada. Define un porcentaje de reventa en el panel Ownership.
Exports de stock#
Un export devuelve item_not_found
La tienda no incluye ese ítem. Los exports cambian el stock de productos que ya existen — añade primero el producto en el creador.
Un export devuelve shop_not_found
El id es incorrecto, o se pasó como string. Pasa el número de la tabla qs_shops: 1, no '1'.
RemoveItemStock devuelve unlimited_quantity
El ítem tiene stock ilimitado (-1). Usa SetItemStock para darle primero un número real.
¿Sigues atascado? Activa
Config.Debug, reproduce el problema y abre un ticket con la salida de la consola del servidor, una captura de la consola F8, y tu framework e inventario con sus versiones.