Antes de empezar#
Antes de instalar Restaurant Creator, asegúrate de que tu servidor cumple los requisitos mínimos. El script detecta la mayoría de las integraciones por sí solo, así que la lista es corta.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos para restaurantes, personal, pedidos y finanzas. |
| Obligatorio | Callbacks, zonas, círculos de progreso y menús contextuales. |
OneSync | Obligatorio | Activado en el servidor ( |
Framework | Obligatorio | ESX, QBCore o Qbox — detectado automáticamente. |
Inventario | Obligatorio | qs-inventory, ox_inventory, qb-inventory, tgiann-inventory, codem-inventory u origen_inventory. Los ingredientes, los platos y las neveras están todos en él. |
Target | Opcional | ox_target o qb-target. Sin uno, cada punto se convierte en texto 3D que se usa con E. |
Sonido 3D | Opcional | mx-surround, qs-3dsound o xsound — el chisporroteo de la freidora, que oyen todos los que están cerca. |
Descargar Restaurant Creator#
Después de comprar Restaurant Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Abre Granted Assets
Ve a portal.cfx.re/assets/granted-assets e inicia sesión con la misma cuenta de Cfx.re que usaste al finalizar la compra. Otra cuenta no verá el recurso.
Descarga el paquete
Busca
Restaurant Creatoren la lista, descárgalo y descomprímelo.
Después de descomprimir la descarga, deberías tener las siguientes carpetas:
[restaurant]/
├── qs-restaurant-creator/ -- the script
│ ├── config/ -- what you may edit
│ ├── client/custom/ -- bridges to other resources (open)
│ ├── server/custom/ -- bridges to other resources (open)
│ ├── custom/ -- notifications, text UI, sounds (open)
│ ├── database/ -- database.sql and the example restaurants
│ └── locales/ -- 41 languages
├── qs-restaurant-props/ -- burger, pizza and fryer props (required)
├── uniqx_burgershot/ -- example burger restaurant map (optional)
├── pizzeria-ymap/ -- example pizzeria map (optional)
└── [INSTALLATION]/
├── items/ -- item lists for each inventory
└── PNG/ -- item imagesLa carpeta debe llamarse
qs-restaurant-creator. La ruta de la interfaz y el export de items de ox_inventory (qs-restaurant-creator.consumable) usan ese nombre.
Instalar el recurso#
Mueve toda la carpeta [restaurant] al directorio resources de tu servidor. qs-restaurant-props no es opcional: hace stream de los ingredientes de la parrilla, la masa de pizza, los toppings, el rodillo, el horno y la freidora que generan los minijuegos de cocina.
Después abre server.cfg y asegúrate de que cada dependencia se inicie antes que el script:
ensure oxmysql
ensure ox_lib
# Framework
ensure es_extended # or qb-core / qbx_core
# Inventory and target
ensure qs-inventory # or ox_inventory, qb-inventory...
ensure ox_target # optional
# Restaurant Creator
ensure qs-restaurant-props
ensure uniqx_burgershot # optional example map
ensure pizzeria-ymap # optional example map
ensure qs-restaurant-creatorEl orden de carga importa. El framework, el inventario y el target se detectan cuando el script se inicia, así que todo lo que se inicie después no se ve.
La base de datos#
Importa qs-restaurant-creator/database/database.sql en la base de datos de tu servidor antes del primer inicio, con HeidiSQL o cualquier cliente de MySQL/MariaDB. Crea las tablas y llena la lista de items permitidos con los 23 ingredientes y platos predeterminados y sus precios en la tienda de suministros.
Tablas | Contienen |
|---|---|
| Cada restaurante: zona, puntos, estaciones, blip, propietario, estado de apertura e imagen. |
| El personal, la marca de propietario, y los rangos y permisos de cada restaurante. |
| El saldo de cada restaurante y cada depósito, retiro, venta y gasto. |
| Las recetas que ha creado cada restaurante. |
| Las categorías del menú del quiosco y cada pedido de los clientes. |
| La lista blanca de items de todo el servidor con los precios de la tienda, y las entregas de suministros. |
En las actualizaciones posteriores, el script actualiza por sí solo las tablas existentes (columnas y claves nuevas), así que solo importas database.sql una vez.
Restaurantes de ejemplo (opcional)#
database/restaurants.sql añade dos restaurantes ya preparados que coinciden con los dos mapas de ejemplo: una hamburguesería (MLO de Burgershot, con las recetas Big Mac y Big Mac XL) y una pizzería (con dos pizzas), cada uno con sus categorías del quiosco. Impórtalo después de database.sql e inicia ambos mapas. Créditos a los autores originales de los mapas:
Items e imágenes#
Cada ingrediente y plato debe existir en tu inventario. Pega la lista de tu inventario desde Items del inventario (también en [INSTALLATION]/items), y copia las imágenes de [INSTALLATION]/PNG en la carpeta de imágenes de tu inventario.
Inventario | Las imágenes van en |
|---|---|
qs-inventory |
|
ox_inventory |
|
qb-inventory |
|
Quién puede usar el creador#
El creador (/restcreator) construye y elimina restaurantes y gestiona los items permitidos, así que está restringido. Un jugador accede por cualquiera de estas dos vías:
Automático, sin nada que configurar. Grupos de ESX admin y superadmin; permisos de QBCore y Qbox god y admin, o el ace command.
Cualquier trabajo y grado listado en Config.CreatorJobs en config/main.lua. grade = false deja entrar a todos los grados de ese trabajo.
Config.CreatorJobs = {
{ job = 'police', grade = { 1, 2, 3 } }, -- only these grades
{ job = 'ambulance', grade = false }, -- every grade
}Configurar el recurso#
Los restaurantes, menús, precios, personal y recetas se editan en el juego. Los archivos solo contienen el comportamiento de todo el servidor:
Archivo | Contenido |
|---|---|
| Idioma, formato de precios, trabajos del creador, target, tamaño de la nevera, pantallas de TV, POS y ajustes de la tienda de suministros, nombres de los items de hamburguesa y patatas fritas, colores e iconos del quiosco, depuración. |
| Tiempos de cocción y quemado de la carne, la cámara de la parrilla, los props y la disposición de los ingredientes. |
| Tiempos de horneado y quemado, animación de amasado, masa, salsa, queso y los nueve toppings con sus items. |
| Tiempos de fritura y quemado, items, props de la freidora y sonido. |
| Tiempo de preparación y los tipos de bebida (modelo de lata, etiqueta, item). |
| Animaciones de comer y beber, props y duraciones por item. |
| Logs de Discord, una URL por categoría. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- ar, de, es, fr, pt, zh... (41 languages)
Config.UseTarget = true -- false = 3D text and the E key
Config.Debug = false -- ships as true: turn it off in production
Config.Intl = { -- how prices look in every menu
locales = 'en-US',
options = { style = 'currency', currency = 'USD', minimumFractionDigits = 0 }
}
Config.DefaultStashData = { maxweight = 1000000, slots = 30 } -- each fridge
Config.ShopSettings = {
deliveryTime = 60, -- seconds until a supply crate arrives
paymentSource = 'choice', -- 'business' | 'player' | 'choice'
}Verificar la instalación#
Reinicia el servidor y revisa la consola: ningún error en rojo de qs-restaurant-creator y una línea de versión que indica si estás al día. Después entra y recorre el primer ciclo:
Abre el creador
Escribe
/restcreator. La ventana lista todos los restaurantes. Si importaste los ejemplos, usa Teleport en uno de ellos; si no, pulsa Create new y sigue Construir un restaurante.Hazte propietario
Selecciónate en el campo Owner y guarda. Ve al punto del menú de jefe y ábrelo: deberías ver todas las pestañas.
Haz y cocina un pedido
Pide una hamburguesa en un quiosco, mira cómo aparece en la pantalla de cocina, cocínala en la estación de hamburguesas en Order Mode y entrégala en el terminal POS.
A partir de aquí nada necesita un reinicio. Cada cambio de restaurante, receta, precio, rango y menú se guarda en la base de datos y se sincroniza con todos los jugadores al instante.