🧑‍🦱Module Player (Client)

Le module Eko.Player permet d’accéder et d’interagir avec les entités joueur côté client. Il expose différentes méthodes pour récupérer des informations sur le joueur local, trouver les joueurs à prox

📦 API

Eko.Player:Get(id)

Récupère une instance sérialisée d’un joueur par son ID.

• Paramètres

  • id (number): L’ID serveur du joueur.

• Retour

  • Player: Un objet sérialisé représentant le joueur.

---

Eko.Player:GetLocal()

Retourne l’objet Player correspondant au joueur local.

• Retour

  • Player: L’instance sérialisée du joueur local.

---

Eko.Player:GetClosest(radius)

Retourne le ped le plus proche du joueur local dans un rayon donné.

• Paramètres

  • radius (number): Rayon de recherche en unités GTA (mètres).

• Retour

  • ped: Handle du ped le plus proche.

---

Eko.Player:GetPlayersInRadius(radius)

Retourne tous les joueurs dans un rayon donné autour du joueur local.

• Paramètres

  • radius (number): Rayon de recherche.

• Retour

  • table: Un tableau contenant des objets avec les propriétés :

    • player (Player): L’instance joueur.

    • ped: Handle du ped.

    • distance (number): Distance au joueur local.

---

Eko.Player:OnLoad(callback)

Permet d’exécuter une fonction une fois que le module Player est chargé.

• Paramètres

  • callback (function): Fonction appelée lors du chargement.

• Exemple

  Eko.Player:OnLoad(function()
      print("Le module Player est prêt.")
  end)

---

Eko.Player:OnReady(callback)

Alias de OnLoad. Se déclenche lorsque Core.Player est chargé.

• Paramètres

  • callback (function): Fonction de rappel.

---

🛠️ Exemple d’utilisation

local player = Eko.Player:GetLocal()

print("Mon ID joueur:", player.id)

Eko.Player:OnReady(function()
    print("Le module Player est initialisé.")
end)

local nearbyPed = Eko.Player:GetClosest(5.0)
if nearbyPed then
    print("Un ped est proche de vous.")
end

local playersInRange = Eko.Player:GetPlayersInRadius(10.0)
for _, data in pairs(playersInRange) do
    print(("Joueur %s à %.2f mètres"):format(data.player.id, data.distance))
end

---

⚠️ Notes

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

• SerializeClass transforme les instances internes en objets utilisables dans vos scripts.

• Si vous développez côté serveur, utilisez le module serveur correspondant.