Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. Los mensajes citados son los que ven los jugadores en el juego, en inglés.
Instalación y acceso#
/restcreator dice que no tengo permiso
Solo entran los administradores del framework (ESX admin/superadmin; QBCore y Qbox god/admin o el ace command) y los trabajos de Config.CreatorJobs. Revisa tu grupo o añade tu trabajo y grado a la lista. Consulta Quién puede usar el creador.
La consola muestra errores de base de datos por tablas que faltan
database/database.sql no se ha importado, o se importó en una base de datos distinta de la de tu mysql_connection_string. Impórtalo y reinicia.
Las estaciones de cocina están vacías o los props son invisibles
qs-restaurant-props no está iniciado. Carga los panes, las carnes, la masa, los toppings, el rodillo, el horno y la freidora. Añade ensure qs-restaurant-props antes del script y reinicia.
La consola advierte que el inventario es standalone
No había ningún inventario compatible en ejecución cuando se inició el script. Inicia tu inventario antes de qs-restaurant-creator, o añade el nombre de su carpeta a la lista inventories si lo renombraste (Recursos renombrados).
"xsound, mx-surround or qs-3dsound is not started"
La freidora intentó reproducir su chisporroteo sin ningún recurso de sonido 3D en ejecución. Instala uno de los tres o ignóralo — freír sigue funcionando, en silencio.
Los objetos no tienen imagen en el inventario
Copia las imágenes de [INSTALLATION]/PNG en la carpeta de imágenes de tu inventario. Los nombres de archivo deben coincidir con los nombres de los objetos.
El creador#
"The point you selected is not in the shop area"
Cada punto debe estar dentro de la zona del restaurante, incluida su altura. Vuelve a dibujar Zone Points para que cubra el lugar, subiendo la altura con Z / X para pisos superiores y mostradores.
Un punto de zona "already belongs to another zone"
Dos restaurantes no pueden superponerse. Dibuja este para que termine antes del contorno del vecino, o edita el vecino.
La zona nunca se pone verde
Necesita al menos cuatro puntos y un perímetro mínimo (Config.MinPointLength). Reparte los puntos alrededor de todo el edificio.
"Please fill all the fields" al guardar
Falta algo obligatorio — está marcado como "… is required" en el formulario. Un restaurante necesita un nombre, un color, la zona, una ubicación de entrega y al menos un kiosco; con el blip activado, también su nombre y posición; y cada sistema de cocina activado necesita sus estaciones colocadas.
Pedidos y cocina#
El kiosco está vacío o falta un plato
Una receta solo está a la venta cuando tiene un precio superior a $0, una categoría y su sistema de cocina activado en la pestaña Recipes del menú de jefe. Crea primero una categoría en Kiosk Menu y luego asígnala.
"This restaurant is currently closed."
El restaurante está configurado como Closed. Ábrelo desde el menú de jefe — acciones rápidas del Dashboard o Settings.
Un jugador no puede usar las estaciones, las neveras ni el POS
No es trabajador de ese restaurante. El personal del restaurante es independiente de los trabajos del framework — contrátalo en la pestaña Workers del menú de jefe (o con HireWorker).
"Missing Ingredients" en la parrilla o la mesa de pizzas
El cocinero no lleva lo que la receta necesita; el panel muestra lo requerido frente a lo disponible. Cómpralos en la Supply Shop o guárdalos en una nevera. Para un servidor sin ingredientes, pon Config.BurgerRequireItems o Config.PizzaRequireItems en false.
"All cooking slots are occupied!"
Todos los puntos de cocción de pizza están horneando. Recoge las pizzas terminadas o añade más puntos de cocción en el creador.
La entrega falla en el POS
Customer too far — el cliente debe estar a 5 m como máximo (
Config.PosTerminalSettings.deliveryRadius).Customer not found — se desconectó.
Needs fries, a drink or a dish — el trabajador que entrega debe llevar esos objetos; solo las hamburguesas y las pizzas se crean al entregar.
Una TV muestra los pedidos de otro restaurante
GTA dibuja todas las TV del mismo modelo desde una única pantalla compartida, así que cuando dos restaurantes están cerca, cada tipo de TV muestra el restaurante más cercano al jugador. Mantén separados los restaurantes con pantallas, o asigna a uno de ellos otro modelo y render target en Config.DisplaySettings.types.
Menú de jefe, personal y suministros#
"You do not have permission to access this category"
Al rango del trabajador le falta el permiso de esa pestaña. El propietario — o un rango con Edit Ranks — lo añade en la pestaña Ranks. Los trabajadores sin rango solo ven el Dashboard.
El nuevo propietario no puede abrir el menú de jefe
El propietario se define en el campo Owner del creador, no por el trabajo del framework. Comprueba que el campo se guardó y que el restaurante tiene una Boss Menu Location.
"No shop items available"
No hay ningún objeto a la venta. Un administrador abre /restcreator → Allowed Items, permite el objeto, activa Shop y le pone un precio superior a 0.
"Business funds" no aparece como forma de pago
Con paymentSource = 'choice', el saldo solo se ofrece al propietario y a los rangos con Withdraw Money. Con 'player' nunca se ofrece.
La caja de suministros nunca aparece
Llega deliveryTime segundos después del pedido (60 por defecto) a la Delivery Location del restaurante. Se avisa a los jugadores a menos de 100 m cuando aterriza. Si sigue sin aparecer, revisa la ubicación en el creador.
"Your inventory is full!" al reclamar
Todo el pedido va al jugador que lo reclama. Haz espacio o pide a alguien con espacio que lo reclame — la caja se queda hasta que alguien la reclame.
Comer no llena el hambre ni la sed, o la llena dos veces
No se llena nada — comprueba que
hunger/thirstsean mayores que 0 enconfig/consumable.lua(para ese objeto o su plantillafood/drink). En ESX,esx_statusdebe estar en ejecución.El valor cambia pero el HUD no — tu HUD o script de estado usa su propio sistema. Adapta
framework:addNeedsencustom/esx/server.luaocustom/qb/server.lua(Hambre y sed).Se llena dos veces — todavía tienes tu propio handler de
restaurant:finishConsumeOutputde antes de la 1.0.30. Quítalo; ahora lo hace el script.
¿Sigues atascado? Abre un ticket con tu framework e inventario, las líneas rojas de la consola del servidor y la salida de la consola F8 del momento en que ocurrió. Si configuras
Config.Debug = truemientras lo reproduces, ambas mostrarán más detalle.