🧭Module Zones

Le module Eko.Zone permet de gérer les zones interactives côté client. Il offre des méthodes pour récupérer, créer et vérifier la présence du joueur dans des zones configurées.

📦 API

Eko.Zone:Get(id)

Récupère une instance sérialisée d’une zone par son identifiant.

• Paramètres

  • id (integer): Identifiant unique de la zone.

• Retour

  • ZoneInstance: L’instance de la zone.

---

Eko.Zone:CreateLocally(data)

Crée une zone uniquement côté client.

• Paramètres

  • data (table): Données de définition de la zone :

    • id (integer): Identifiant.

    • name (string): Nom de la zone.

    • coords (vector4): Position et heading.

    • size (vector2): Dimensions.

    • data (table): Données associées.

    • action (string): Nom de l’action liée.

• Retour

  • ZoneInstance: L’instance créée.

---

Eko.Zone:GetCurrent()

Retourne la zone dans laquelle se trouve actuellement le joueur.

• Retour

  • ZoneInstance: L’instance, ou nil si aucune zone.

---

Eko.Zone:IsPlayerIn(type)

Vérifie si le joueur est dans une zone d’un type donné.

• Paramètres

  • type (string): Type de zone à vérifier.

• Retour

  • boolean: true si le joueur est présent.

---

Eko.Zone:All()

Retourne toutes les zones chargées.

• Retour

  • table<number, ZoneInstance>: Tableau des zones.

---

🛠️ Exemple d’utilisation

-- Récupérer une zone
local zone = Eko.Zone:Get(2)
if zone then
    print("Zone récupérée:", zone:name())
end

-- Créer une zone locale
local newZone = Eko.Zone:CreateLocally({
    id = 100,
    name = "Garage",
    coords = vector4(200.0, -1000.0, 30.0, 0.0),
    size = vector2(4.0, 4.0),
    data = { type = "garage" },
    action = "garage:open"
})
print("Zone créée localement:", newZone:name())

-- Vérifier la zone actuelle
local current = Eko.Zone:GetCurrent()
if current then
    print("Vous êtes dans la zone:", current:name())
end

-- Vérifier si le joueur est dans une zone de type spécifique
if Eko.Zone:IsPlayerIn("garage") then
    print("Le joueur est dans un garage.")
end

-- Récupérer toutes les zones
local allZones = Eko.Zone:All()
for _, z in pairs(allZones) do
    print("Zone:", z:name())
end

---

⚠️ Notes

• Ces méthodes sont uniquement disponibles côté client.

• Les zones créées localement ne sont pas synchronisées avec les autres joueurs.

• L’action associée (action) peut être utilisée dans vos événements personnalisés.