📦Classe InventoryInstance

Représente un inventaire unique côté client ou serveur. Elle permet de consulter et modifier le contenu, les limites de poids et la configuration de l’inventaire.

📂 Propriétés (getters/setters)

Toutes ces méthodes agissent comme getter/setter : si vous passez une valeur, elle est mise à jour ; sinon, elle est retournée.

inventory:id(id?)

Paramètres

• id (number | string, optionnel) : Nouvel identifiant de l’inventaire

Retour

• number | string : Identifiant actuel

inventory:max_weight(max_weight?)

Paramètres

• max_weight (number, optionnel) : Nouveau poids maximum autorisé

Retour

• number : Poids maximum actuel

inventory:content(content?)

Paramètres

• content (ItemInstance[], optionnel) : Nouveau contenu

Retour

• ItemInstance[] : Liste des items contenus

inventory:clothes(clothes?)

Paramètres

• clothes (ItemInstance[], optionnel) : Nouveaux vêtements

Retour

• ItemInstance[] : Vêtements actuellement équipés

inventory:temporary(temporary?)

Paramètres

• temporary (boolean, optionnel) : Définir comme inventaire temporaire

Retour

• boolean : État actuel

inventory:slots(slots?)

Paramètres

• slots (integer, optionnel) : Nombre de slots

Retour

• integer : Nombre de slots actuel

inventory:category(category?)

Paramètres

• category (string, optionnel) : Catégorie de l’inventaire

Retour

• string : Catégorie actuelle

---

📊 Propriétés calculées (getter uniquement)

inventory:weight()

Retour

• number : Poids total actuel

inventory:free_weight()

Retour

• number : Poids restant disponible

---

⚙️ Méthodes

inventory:findItem(fn)

Cherche le premier item correspondant à une condition.

Paramètres

• fn (function): Fonction de filtre qui reçoit item: ItemInstance et retourne true si l’item correspond

Retour

• ItemInstance | nil

---

inventory:findItems(fn)

Renvoie tous les items correspondant à une condition.

Paramètres

• fn (function): Fonction de filtre

Retour

• ItemInstance[]

---

inventory:freeSlots(category)

Renvoie le nombre de slots libres pour une catégorie spécifique.

Paramètres

• category ("other" | "clothes" | "keys") : Type de slots

Retour

• number

---

🛠️ Exemple d’utilisation

-- Récupérer le poids actuel
local weight = inventory:weight()
print("Poids total:", weight)

-- Modifier le poids maximum
inventory:max_weight(100.0)

-- Chercher un item spécifique
local water = inventory:findItem(function(item)
    return item:name() == "water"
end)
if water then
    print("Vous avez de l'eau.")
end

-- Lister tous les vêtements
local clothes = inventory:clothes()
for _, c in ipairs(clothes) do
    print("Vêtement:", c:name())
end

-- Vérifier les slots disponibles
local slots = inventory:freeSlots("other")
print("Slots libres:", slots)

---

⚠️ Notes

• Les modifications sont immédiatement synchronisées avec le serveur si applicable.

• temporary permet de créer des inventaires éphémères.

• Les catégories sont utilisées pour segmenter l’inventaire en sous-types (ex.: vêtements, clés).