Clothing store

1. 01

   Déposez la ressource

   Récupérez le script depuis votre compte Tebex, copiez le dossier avenida_clotheshops/ dans votre dossier resources et ajoutez ensure avenida_clotheshops à votre config serveur, après ensure oxmysql.

2. 02

   Passez le SQL

   Exécutez la section [A] d'INSTALL.sql sur votre base. La section [B] est conditionnelle, l'en-tête du fichier dit quand elle s'applique.

3. 03

   Donnez-vous les permissions

   Ajoutez add_ace group.admin avenida_clotheshops.admin allow et add_ace group.admin avenida_clotheshops.vip allow à votre config serveur. La première ouvre l'éditeur de catalogue, la seconde débloque ce que vous placez derrière la liste VIP.

4. 04

   Tarifez le catalogue depuis le jeu

   Mettez Config.DevMode.Enabled = true, entrez dans un magasin et ouvrez l'éditeur. Fixez les prix, masquez ce que vous ne vendez pas, réservez ce qui appartient à un job. Tout atterrit dans config/clothes_overrides.lua. Recoupez DevMode une fois terminé, il est revérifié côté serveur à chaque sauvegarde.

5. 05

   Contrôlez les intégrations

   Mettez Config.Debug = true, redémarrez, et lisez la console : une ligne par catégorie de bridge nomme la cible retenue. Config.Debug ne pilote que les logs, ce n'est pas l'interrupteur de l'éditeur.

Tarifer une section de trois façons

Chaque magasin déclare ses sections, et chaque section son mode de tarification. Un forfait pour toute une section, un multiplicateur qui rend les drawables suivants plus chers, ou une table quand seules quelques pièces méritent leur propre prix.

-- 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 publics groupés par domaine. Chaque ligne montre la signature d'appel

Client

• GetSkinData

  exports['avenida_clotheshops']:GetSkinData() Copier

  La tenue portée par le joueur, composant par composant, props compris. C'est ce que la boutique écrit à l'achat, donc c'est toujours en phase avec ce que la penderie affiche.

• ApplySkin

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

  Applique une apparence complète à un ped. Poser une tenue vide l'emplacement de décoration, donc cet appel remet ensuite le travail du barbier et du tatoueur au lieu de laisser une peau nue.

• ApplyClothing

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

  Change les vêtements et rien d'autre. Avec temporary à true, la tenue ne vit que le temps de la session, ce qui est le comportement attendu d'un uniforme distribué par un métier.

Server

• GetBagStorage

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

  La capacité qu'accorde un drawable de sac, poids et emplacements, ou nil quand ce drawable ne porte rien. Appelez-la depuis votre ressource d'inventaire pour qu'un sac acheté en boutique contienne vraiment quelque chose.

Exemples copier-coller pour les cas courants. À déposer dans ta ressource, ajuster les valeurs, et c'est en prod.

-- 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

• Un joueur dit avoir perdu des vêtements qu'il possédait
  Regardez `Config.Clothes.RequireOwnership`. Le registre initialise un personnage depuis ce qu'il porte déjà la première fois qu'il le voit, l'activer ne retire donc pas de garde-robe. Ce qu'il refuse, c'est une écriture pour un vêtement sans achat derrière, ce qu'envoie justement un client trafiqué. Si une de vos ressources habille les joueurs avec des pièces jamais achetées, enregistrez ces achats ou passez le drapeau à false.
• L'éditeur de catalogue ne s'ouvre pas
• La même veste apparaît plusieurs fois
• Les cheveux traversent un casque
• Les photos de tenues demandent-elles quelque chose ?
• Quels frameworks sont réellement supportés ?
• Puis-je le faire tourner à côté de avenida_barber et avenida_tattoo ?
• Combien ça coûte quand personne ne fait de shopping ?