📡Module Events (Shared)

Le module Eko.Events fournit une interface unifiée pour enregistrer, écouter et déclencher des événements entre le client, le serveur et des ressources externes. Ces événements sont utilisés pour la s

📦 API

Eko.Events.Handle(name, callback)

Ajoute un gestionnaire d’événement supplémentaire (multicast).

• Paramètres

  • name (string): Nom de l’événement.

  • callback (function): Fonction appelée lors du déclenchement. Signature :

    function(source, ...)
      -- source = ID joueur (ou nil)
      -- ... = données de l’événement
    end

---

Eko.Events.Register(name, callback)

Crée un gestionnaire d’événement Si l’événement existe déjà, il sera recu par tous les gestionnaires.

• Paramètres

  • name (string): Nom de l’événement.

  • callback (function): Fonction exécutée.

---

Eko.Events.Trigger(name, ...)

Déclenche un événement local (côté client ou serveur).

• Paramètres

  • name (string): Nom de l’événement.

  • ...: Données transmises.

---

Eko.Events.TriggerClient(name, target, ...)

Déclenche un événement sur un client spécifique.

• Paramètres

  • name (string): Nom de l’événement.

  • target (integer): ID du joueur cible.

  • ...: Données transmises.

---

Eko.Events.TriggerClientLatent(name, target, ...)

Déclenche un événement latent sur un client spécifique (pour gros volumes de données).

• Paramètres

  • name (string): Nom de l’événement.

  • target (integer): ID du joueur cible.

  • ...: Données transmises.

---

Eko.Events.TriggerServer(name, ...)

Déclenche un événement côté serveur (appelé depuis le client).

• Paramètres

  • name (string): Nom de l’événement.

  • ...: Données transmises.

---

Eko.Events.TriggerServerLatent(name, ...)

Déclenche un événement latent côté serveur.

• Paramètres

  • name (string): Nom de l’événement.

  • ...: Données transmises.

---

Eko.Events:TriggerExternal(name, ...)

Déclenche un événement cross-resource (interne FiveM).

• Paramètres

  • name (string): Nom de l’événement.

  • ...: Données transmises.

---

🛠️ Exemple d’utilisation

-- Enregistrer un événement unique
Eko.Events.Handle("vehicle:lock", function(source, vehicleId)
    print("Le joueur", source, "a verrouillé le véhicule", vehicleId)
end)

-- Enregistrer plusieurs callbacks sur un même événement
Eko.Events.Register("player:joined", function(source)
    print("Bienvenue au joueur", source)
end)

-- Déclencher un événement local (Client -> Client ou Serveur -> Serveur)
Eko.Events.Trigger("hud:update", { health = 80 })

-- Déclencher Server -> Client
Eko.Events.TriggerClient("notification", 2, "Message privé reçu.")

-- Déclencher Client -> Serveur
Eko.Events.TriggerServer("inventory:save")

-- Déclencher un événement latent Client -> Serveur
Eko.Events.TriggerClientLatent("data:sync", 3, bigData)

-- Déclencher un événement latent Serveur -> Client
Eko.Events.TriggerServerLatent("data:sync", bigData)

-- Déclencher cross-resource (Client -> Client ou Serveur -> Serveur)
Eko.Events.TriggerExternal("other_resource:event", "param")

---

⚠️ Notes

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

• Les événements latents sont recommandés pour les transferts volumineux.

• Les callbacks reçoivent toujours source en premier argument côté serveur.