Clothing store

1. 01

   Coloque o resource

   Baixe o script pela sua conta Tebex, copie a pasta avenida_clotheshops/ para o seu diretório de resources e adicione ensure avenida_clotheshops na config do servidor, depois de ensure oxmysql.

2. 02

   Rode o SQL

   Rode a seção [A] do INSTALL.sql no seu banco. A seção [B] é condicional, o cabeçalho do arquivo diz quando você precisa dela.

3. 03

   Dê as permissões de admin

   Adicione add_ace group.admin avenida_clotheshops.admin allow e add_ace group.admin avenida_clotheshops.vip allow na config do servidor. A primeira abre o editor de catálogo, a segunda libera o que você colocar atrás da lista VIP.

4. 04

   Defina os preços do catálogo de dentro do jogo

   Coloque Config.DevMode.Enabled = true, entre numa loja e abra o editor. Defina preços, esconda o que você não vende, reserve o que pertence a um emprego. Tudo cai em config/clothes_overrides.lua. Desligue o DevMode quando terminar, ele é checado de novo no servidor a cada save.

5. 05

   Verifique as integrações

   Coloque Config.Debug = true, reinicie e leia o console: uma linha por categoria de bridge nomeia o alvo escolhido. Config.Debug só controla os logs, não é a flag do editor.

Precificar uma seção de três jeitos

Cada loja declara as próprias seções, e cada seção declara o próprio modo de preço. Uma taxa fixa para a seção inteira, um multiplicador que encarece os drawables seguintes, ou uma tabela quando só algumas peças merecem preço próprio.

-- config/clothes_shops.lua
categories = {
    tops = {
        enabled = true,
        price   = { mode = 'fixed', base = 300 },
    },
    pants = {
        enabled = true,
        -- price = base + index * mult
        price   = { mode = 'multiplier', base = 100, mult = 2 },
    },
    mask = {
        enabled = true,
        price   = { mode = 'table', map = { [12] = 900, [45] = 1500 } },
        -- only these drawables are offered
        whitelist = { 12, 45, 51 },
    },
}

Exports públicos agrupados por domínio. Cada linha mostra a assinatura da chamada e o que ela faz, não como faz.

Client

• GetSkinData

  exports['avenida_clotheshops']:GetSkinData() Copiar

  A roupa que o jogador usa, componente por componente, props incluídos. É o que a loja escreve na compra, então bate sempre com o que o guarda-roupa mostra.

• ApplySkin

  exports['avenida_clotheshops']:ApplySkin(data, ped) Copiar

  Aplica uma aparência completa num ped. Vestir uma roupa esvazia o slot de decoração, então essa chamada recoloca depois o trabalho da barbearia e da tatuagem em vez de deixar a pele nua.

• ApplyClothing

  exports['avenida_clotheshops']:ApplyClothing(data, ped, temporary) Copiar

  Troca a roupa e mais nada. Com temporary em true a roupa só vale durante a sessão, e é assim que um uniforme entregue por um emprego tem que funcionar.

Server

• GetBagStorage

  exports['avenida_clotheshops']:GetBagStorage(sex, drawable) --> { weight, slots } | nil Copiar

  A capacidade que um drawable de mochila dá, peso e slots, ou nil quando esse drawable não carrega nada. Chame esse export do seu resource de inventário para que uma mochila comprada na loja guarde alguma coisa de verdade.

Exemplos de copiar e colar para os casos mais comuns. Você cola na sua resource, ajusta os valores e já está em produção.

-- config/clothes_shops.lua
Config.Clothes.Shops[22] = {
    name       = 'Ponsonbys - Rockford Hills',
    payment    = 'bank',
    currency   = '$',
    tax        = 0.20,        -- +20% on the cart
    discount   = 0.00,
    outfitMode = true,
    blip = { sprite = 73, color = 4, scale = 0.7, coords = vec3(-708.2, -152.2, 37.4) },
    categories = {
        tops  = { enabled = true, price = { mode = 'fixed', base = 900 } },
        shoes = { enabled = true, price = { mode = 'fixed', base = 450 } },
    },
}

-- config/clothes_overrides.lua, or write it from the in-game editor
Overrides['tops'] = {
    [56] = { job = 'police', label = 'LSPD jacket' },
    [12] = { hidden = true },
    [31] = { restricted = true },   -- ACE permission
}

-- config/clothes.lua
Config.Clothes.RequireOwnership = false

-- how far from a store the server still accepts a purchase
Config.Clothes.PurchaseRange = 30.0

-- saved outfits per character, enforced server side
Config.Clothes.MaxOutfits = 30
Config.Clothes.MaxOutfitsRestricted = 50

local hairbase = exports['avenida_clotheshops']:GetHairbase()
local tattoos  = exports['avenida_clotheshops']:GetTattoos()

-- your own clothing work here

if hairbase then
    AddPedDecorationFromHashes(PlayerPedId(), hairbase.c, hairbase.t)
end
for _, dec in ipairs(tattoos) do
    AddPedDecorationFromHashes(PlayerPedId(), dec.c, dec.t)
end

• Um jogador diz que perdeu roupas que tinha
  Confira o `Config.Clothes.RequireOwnership`. O registro inicializa um personagem com o que ele já está vestindo na primeira vez que o vê, então ligar isso não tira o guarda-roupa de ninguém. O que ele recusa é uma escrita para uma peça sem compra por trás, que é justamente o que um client adulterado manda. Se um resource seu vestir jogadores com peças que eles nunca compraram, registre essas compras ou coloque a flag em false.
• O editor de catálogo não abre
• A mesma jaqueta aparece várias vezes
• O cabelo atravessa um capacete
• As fotos de outfit precisam de alguma coisa?
• Quais frameworks ele realmente suporta?
• Posso rodar junto com avenida_barber e avenida_tattoo?
• Quanto custa quando ninguém está comprando?