config

Voici la documentation pour la configuration SHARED_CONFIG :

---

Documentation de la configuration SHARED_CONFIG

La table SHARED_CONFIG contient les paramètres relatifs aux magasins de vêtements, aux skins par défaut et aux fonctions de gestion des apparences dans le jeu.

---

Structure de la configuration

1. shop (Table des paramètres du magasin)

Clé	Type	Description
anim	string	Animation utilisée pour le menu du magasin.
dict	string	Dictionnaire d'animation utilisé pour l'affichage du menu.
moneytype	string	Type de monnaie affichée dans le magasin (ex: "$").
onClose	function	Fonction appelée à la fermeture du menu (affiche "Fermeture du menu").
disableHud	function	Fonction permettant d'afficher ou masquer le HUD selon le paramètre bool.

Exemple d'utilisation :

SHARED_CONFIG.shop.onClose()
SHARED_CONFIG.shop.disableHud(true)

---

2. shop_List (Liste des magasins disponibles)

Chaque magasin est défini sous forme de clé avec les informations suivantes :

Clé	Type	Description
position	vector3[]	Liste des positions des magasins.
items	table	Liste des types d'articles disponibles (voir Gunware Docs).
title	string	Nom du magasin affiché.
zones	string	Type d'interaction utilisée (target, text-ui).
blip	table	Informations sur le blip affiché sur la carte.

Exemple d'un magasin :

SHARED_CONFIG.shop_List["Mask Shop"].blip.name -- "Mask Shop"

Structure du blip :

Clé	Type	Description
sprite	number	Identifiant de l'icône du blip.
color	number	Couleur du blip.
scale	number	Taille du blip sur la carte.
name	string	Nom du blip affiché sur la carte.
shortRange	boolean	Détermine si le blip est visible à proximité.

---

3. default_url (URL par défaut pour les vêtements)

• Définition : Une URL utilisée lorsqu'aucune image n'est trouvée pour un article de vêtement.

Exemple d'accès :

local imageUrl = SHARED_CONFIG.default_url

---

4. DefaultCloth (Vêtements par défaut)

Cette section définit les vêtements par défaut pour les personnages masculins et féminins.

Structure :

SHARED_CONFIG.DefaultCloth['male']['tshirt'] -- { id = 0, color = 0 }
SHARED_CONFIG.DefaultCloth['female']['shoes'] -- { id = 35, color = 0 }

Clé	Type	Description
id	number	Identifiant du vêtement.
color	number	Couleur par défaut associée au vêtement.

---

5. reloadSkin (Fonction pour recharger l'apparence du joueur)

• Déclenche l'événement pour recharger l'apparence du joueur.

Exemple d'utilisation :

SHARED_CONFIG.reloadSkin()

---

6. saveSkin (Fonction pour sauvegarder l'apparence du joueur)

• Récupère l'apparence actuelle du joueur et l'envoie au serveur pour sauvegarde.

Exemple d'utilisation :

SHARED_CONFIG.saveSkin()

---

Exemple d'utilisation complet :

-- Ouvrir un magasin de masques et cacher le HUD
SHARED_CONFIG.shop.disableHud(true)
print("Bienvenue dans le magasin :", SHARED_CONFIG.shop_List["Mask Shop"].title)

-- Charger un skin par défaut
local defaultShoes = SHARED_CONFIG.DefaultCloth['male']['shoes']
print("Chaussures par défaut ID:", defaultShoes.id, "Couleur:", defaultShoes.color)

-- Sauvegarder l'apparence du joueur
SHARED_CONFIG.saveSkin()

---

Remarques :

1. La configuration est centralisée pour faciliter la personnalisation des magasins et des skins.

2. Assurez-vous que les fichiers et événements référencés (ex: illenium-appearance) sont correctement installés sur votre serveur.

3. Vous pouvez ajouter de nouveaux magasins en respectant la structure de shop_List.

---

Gestion des prix aléatoires pour les catégories d'articles

Ce document décrit l'utilisation de la table priceRanges permettant de générer des prix aléatoires pour différentes catégories d'articles dans le jeu.

Définition de la table des prix

La table priceRanges contient les plages de prix pour chaque catégorie d'articles. Chaque catégorie est associée à une plage de valeurs minimales et maximales entre lesquelles un prix aléatoire sera généré.

priceRanges = {
    tshirt = {20, 50},
    torso = {50, 150},
    pants = {30, 100},
    shoes = {40, 120},
    arms = {15, 60},
    helmet = {50, 130},
    glasses = {25, 90},
    mask = {30, 100},
    bproof = {100, 250},
    chain = {80, 200},
    bracelets = {20, 80},
    watches = {60, 180},
    ears = {10, 50},
    decals = {10, 40},
    bags = {50, 150}
}

Génération d'un prix aléatoire

Pour obtenir un prix aléatoire dans une catégorie donnée, vous pouvez utiliser la fonction suivante :

function getRandomPrice(category)
    local range = priceRanges[category]
    if range then
        return math.random(range[1], range[2])
    else
        print("[ERROR] Catégorie inconnue : " .. tostring(category))
        return nil
    end
end

Exemple d'utilisation

local randomTshirtPrice = getRandomPrice('tshirt')
print("Prix aléatoire pour un t-shirt : " .. randomTshirtPrice)

local randomHelmetPrice = getRandomPrice('helmet')
print("Prix aléatoire pour un casque : " .. randomHelmetPrice)

Ajout de nouvelles catégories

Pour ajouter une nouvelle catégorie d'articles avec sa plage de prix, ajoutez simplement une nouvelle ligne dans la table priceRanges :

priceRanges["torso"] = {70, 200}

Gestion des erreurs

• Assurez-vous que la catégorie existe avant d'appeler getRandomPrice.

• Vérifiez que les plages de prix sont correctement définies sous la forme {min, max}.

• Un message d'erreur sera affiché si une catégorie non définie est utilisée.

---

En utilisant cette approche, vous pouvez facilement gérer les prix aléatoires de différentes catégories d'articles dans votre projet.