🗺️Classe ZoneInstance

Représente une zone interactive côté client. Elle permet de définir des actions et des callbacks lors de l’entrée ou de la sortie de la zone.

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

zone:id(id?)

Paramètres

• id (number, optionnel) : Nouvel identifiant

Retour

• number : Identifiant actuel

zone:name(name?)

Paramètres

• name (string, optionnel) : Nom de la zone

Retour

• string : Nom actuel

zone:coords(coords?)

Paramètres

• coords (vector4, optionnel) : Position et heading

Retour

• vector4 : Coordonnées actuelles

zone:size(size?)

Paramètres

• size (vector2, optionnel) : Dimensions de la zone

Retour

• vector2 : Taille actuelle

zone:onEnter(fn?)

Paramètres

• fn (function, optionnel) : Callback appelé à l’entrée

Retour

• function : Fonction actuelle

zone:onLeave(fn?)

Paramètres

• fn (function, optionnel) : Callback appelé à la sortie

Retour

• function : Fonction actuelle

zone:data(data?)

Paramètres

• data (table, optionnel) : Données associées

Retour

• table : Données actuelles

zone:instance(instance?)

Paramètres

• instance (any, optionnel) : Instance associée

Retour

• any : Instance actuelle

zone:action(action?)

Paramètres

• action (string, optionnel) : Action assignée

Retour

• string : Action actuelle

---

⚙️ Méthodes

zone:delete()

Supprime la zone et libère les ressources

---

zone:refresh()

Actualise les paramètres et redétecte les joueurs

---

zone:create()

Crée la zone dans le jeu

Retour

• any : Référence interne de la zone

---

🛠️ Exemple d’utilisation

-- Créer une zone et configurer ses callbacks
local zone = Eko.Zone:CreateLocally({
    id = 1,
    name = "garage_zone",
    coords = vector4(200.0, -1000.0, 30.0, 0.0),
    size = vector2(3.0, 3.0),
    action = "garage:open",
    data = { garageId = 5 }
})

zone:onEnter(function()
    print("Vous êtes entré dans la zone.")
end)

zone:onLeave(function()
    print("Vous avez quitté la zone.")
end)

-- Mettre à jour le nom
zone:name("zone_garage_principale")

-- Recréer la zone
zone:refresh()
zone:create()

-- Supprimer la zone
zone:delete()

---

⚠️ Notes

• Après delete(), l’instance devient invalide.

• refresh() doit être appelé après modification de certaines propriétés.

• Les callbacks onEnter() et onLeave() sont exécutés automatiquement selon la présence du joueur.