Comandos yexports

Comandos#

Shops Creator mantiene sus comandos al mínimo: las tiendas se construyen en el creador, y los jugadores llegan a cada tienda caminando hasta ella. Los comandos de abajo son todos los que hay.

No hay ningún comando de jugador para abrir una tienda o su menú de jefe: ambos se abren en la propia tienda, con E o tu target. El punto del menú de jefe se coloca desde el creador, en el panel Ownership de la tienda.

Exports del servidor#

Para mover el stock de una tienda desde otro recurso — un trabajo de reparto que repone el 24/7, un atraco que vacía el Ammu-Nation, un script de cultivo que llena un mercado. Cada export funciona en los dos tipos de tienda: en una tienda cambia el stock del ítem; en una tienda de venta cambia cuántas unidades más va a comprar la tienda (su cantidad máxima).

shopId es el id de la tienda en la tabla qs_shops — las 29 tiendas predefinidas van de 1 a 29. Pásalo como número (1), no como string ('1'). Un stock de -1 significa ilimitado.

local ok, err = exports['qs-shops-creator']:AddItemStock(shopId, 'water', 10)
if not ok then
    print('Restock failed:', err)
end

local ok, err = exports['qs-shops-creator']:RemoveItemStock(shopId, 'water', 5)

local ok, err = exports['qs-shops-creator']:SetItemStock(shopId, 'water', 100)
exports['qs-shops-creator']:SetItemStock(shopId, 'bread', -1) -- unlimited

local qty = exports['qs-shops-creator']:GetItemStock(shopId, 'water')
if qty == nil then
    print('That shop does not sell water')
elseif qty == -1 or qty > 0 then
    print('In stock')
end

Qué significan los errores#

AddItemStock, RemoveItemStock y SetItemStock devuelven true si tienen éxito, o false y una de estas claves:

Un ejemplo completo#

Un trabajo de reparto que repone una tienda cuando el conductor entrega la caja, y se niega cuando la tienda ya está llena:

-- server.lua of your delivery resource
local SHOP_ID = 1          -- 24/7 Supermarket
local MAX_STOCK = 200

RegisterNetEvent('delivery:dropOff', function(item, amount)
    local src = source
    local current = exports['qs-shops-creator']:GetItemStock(SHOP_ID, item)

    if current == nil then
        return print(('Shop %s does not sell %s'):format(SHOP_ID, item))
    end
    if current == -1 or current >= MAX_STOCK then
        return TriggerClientEvent('ox_lib:notify', src, { type = 'error', description = 'The shop is full' })
    end

    local toAdd = math.min(amount, MAX_STOCK - current)
    local ok, err = exports['qs-shops-creator']:AddItemStock(SHOP_ID, item, toAdd)
    if ok then
        TriggerClientEvent('ox_lib:notify', src, { type = 'success', description = ('Delivered %s x%d'):format(item, toAdd) })
    else
        print('AddItemStock failed:', err)
    end
end)

Funciones personalizables#

En lugar de exports, los hooks del lado del cliente que un dueño de servidor suele querer cambiar son funciones normales en custom/client.lua, fuera del código cifrado:

En el servidor, Notification(source, msg, type) en custom/server.lua envía cada mensaje a la función de cliente de arriba.