Antes de empezar#
Antes de instalar Shops Creator, asegúrate de que tu servidor cumpla los requisitos mínimos. Tres cosas son obligatorias; todo lo demás es opcional y se detecta por sí solo al iniciar el servidor.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos para tiendas, dueños, empleados, finanzas e historial. |
| Obligatorio | Callbacks, zonas, barras de progreso y utilidades compartidas. |
OneSync | Obligatorio | Declarado como dependencia en el manifest. Actívalo en la configuración de tu servidor o en txAdmin. |
Framework | Obligatorio |
|
Inventario | Recomendado |
|
Target | Opcional |
|
Sociedades | Opcional |
|
Bandas | Opcional | Bandas nativas en QBCore y Qbox; |
| Opcional | Barras de progreso, ocultación del HUD y texto 3D de Quasar. Sin ellos, se usan |
| Opcional | Adjunta una captura de pantalla a los logs de Discord, junto con un token de Fivemanage. |
Descargar Shops Creator#
Después de comprar Shops Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Shops Creator.
Tras extraer la descarga, deberías tener la siguiente carpeta:
qs-shops-creator/
├── config/ -- main.lua: everything you may edit
├── custom/ -- framework bridges (esx, qb) and notifications (editable)
├── client/custom/ -- target bridge (editable)
├── server/custom/ -- inventory and society bridges (editable)
├── database/ -- database.sql, with 29 ready-made shops
├── locales/ -- 41 languages
├── server/webhooks.lua -- Discord webhook URLs
└── web/ -- the interface, already builtMantén el nombre de la carpeta
qs-shops-creator. Cada export de Comandos y exports se llama a través de ese nombre, así que una copia renombrada rompe cualquier script que se comunique con él.
Instalar el recurso#
Mueve la carpeta qs-shops-creator al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-shops-creator/Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia (y todo lo que deba detectar) se inicie antes que Shops Creator:
ensure oxmysql
ensure ox_lib
# Framework (one of them)
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Inventory, target, societies
ensure qs-inventory
# ensure ox_inventory
ensure ox_target
ensure esx_society
ensure qs-shops-creatorEl orden de carga importa. El framework y el inventario se detectan comprobando qué recursos están ya iniciados, así que un inventario que se inicia después de Shops Creator no se encuentra y la tienda funciona en modo standalone.
La base de datos#
Shops Creator incluye su esquema como archivo SQL. Importa database/database.sql en la base de datos de tu servidor antes del primer inicio, con HeidiSQL, phpMyAdmin o cualquier cliente de MariaDB/MySQL.
Tablas | Contienen |
|---|---|
| Cada tienda: su zona, ped, blip, ítems, categorías, ítems vendibles, reglas de acceso, propiedad, métodos de pago, horario de apertura y saldo. |
| El dueño de cada tienda y su personal con sus permisos. |
| El saldo y las cifras de cada tienda, y cada depósito, retiro, venta y gasto. |
| Descuentos y ofertas de importe fijo, con sus objetivos y fechas. |
| Cada compra en una tienda y cada ítem vendido a una tienda de compraventa. |
| Plantillas de tienda guardadas, privadas o públicas. |
El mismo archivo también coloca 29 tiendas por todo el mapa, cada una con su zona, un tendero y un blip, así que empiezas desde las ubicaciones originales en lugar de un mapa vacío:
Tienda | Ubicaciones |
|---|---|
24/7 Supermarket | 8 |
Ammu-Nation | 11 |
LTD Gasoline | 5 |
Rob's Liquor | 5 |
El SQL usa
CREATE TABLE IF NOT EXISTS,ADD COLUMN IF NOT EXISTSyINSERT IGNORE, así que importarlo de nuevo tras una actualización añade lo nuevo sin tocar tus tiendas. Una tienda predefinida que eliminaste solo vuelve si importas el archivo otra vez.
Dar acceso al creador#
El creador es donde se construyen las tiendas, así que está restringido. Escribe /shopcreator en el juego; cualquiera sin acceso ve You do not have permission to do this. Cualquiera de estas vías da acceso a alguien:
Automático, sin nada que configurar. En ESX, los jugadores del grupo admin o superadmin. En QBCore y Qbox, los jugadores con el permiso god o admin, o con el ace command (el grupo admin de txAdmin).
Da el creador a un trabajo sin hacer administrador a nadie: un departamento de urbanismo, una oficina de negocios. Cada entrada es un trabajo y, opcionalmente, los rangos que pueden usarlo:
-- config/main.lua
Config.CreatorJobs = {
{ job = 'police', grade = { 1, 2, 3 } }, -- only these grades
{ job = 'ambulance', grade = false }, -- every grade
}La lista incluida es un ejemplo: sustitúyela por los trabajos de tu propio servidor, o déjala vacía para reservar el creador solo a los administradores.
Configurar el recurso#
Las tiendas se construyen en el juego, nunca en archivos. config/main.lua contiene la configuración general del servidor, y cada ajuste está etiquetado como [EDIT], [ADV], [CORE] o [AUTO] para que veas de un vistazo qué es seguro cambiar.
Ajuste | Qué controla |
|---|---|
| El idioma: cualquiera de los 41 códigos de |
| El comando del creador, |
| Trabajos y rangos que pueden usar el creador, además de los administradores. |
| Métodos de pago que acepta una tienda hasta que el creador elige los suyos. |
| Todos los métodos de pago que el creador puede ofrecer: |
| Cómo se muestran los precios: formato regional, código de moneda y decimales. Solo visual. |
| Target o tecla, y el tamaño de la zona de interacción. |
| Las categorías e iconos sugeridos en el creador. |
| Teclas y velocidades de cámara usadas al dibujar zonas y colocar puntos. |
| Salida detallada en la consola. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- ar, de, en, es, fr, it, pt, ru, tr, zh ...
Config.ShopCreatorCommand = 'shopcreator' -- typed in chat as /shopcreator
Config.UseTarget = false -- true = ox_target / qb-target
Config.Intl = {
locales = 'en-US',
options = { style = 'currency', currency = 'USD', minimumFractionDigits = 0 },
}
Config.Debug = false -- ships as true: turn it off on a live serverVerificar la instalación#
Al terminar la instalación, reinicia tu servidor y lee la consola. Deberías ver que se carga el framework:
[INFO] Successfully loaded the framework. esxSi en cambio la consola repite Using standalone inventory, this is not recommended for production servers, tu inventario no se detectó: mueve su ensure por encima de ensure qs-shops-creator.
Luego entra a tu servidor y recorre el primer ciclo:
Abre el creador
Escribe
/shopcreator. Se abre la lista de tiendas, con las 29 predefinidas ya incluidas. Elige un 24/7 Supermarket para editarlo.Abastécela
Añade una categoría, luego algunos ítems con precio y stock, y guarda. Uso cubre cada panel.
Compra algo
Acércate al tendero de esa tienda y pulsa
E(o usa tu target). Añade un ítem al carrito, elige cómo pagar y confirma: el ítem llega a tu inventario y el stock baja para todos.
A partir de aquí nada necesita reinicio. Tiendas, ítems, precios, dueños, empleados y promociones se crean y editan en el juego, y cada cambio llega a todos los jugadores al instante.