🫂Module Player (Serveur)

Le module Eko.Player permet d’accéder et d’interagir avec les entités joueur côté serveur. Il expose différentes méthodes pour récupérer des instances joueurs, détecter les joueurs proches et faire de

📦 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:GetNearest(source, distance)

Retourne le joueur le plus proche d’un joueur donné.

• Paramètres

  • source (number): L’ID serveur du joueur de référence.

  • distance (number): Distance maximale de recherche.

• Retour

  • Player: L’instance sérialisée du joueur le plus proche, ou nil si aucun joueur n’est trouvé.

---

Eko.Player:GetInRange(source, range)

Retourne tous les joueurs dans un rayon donné autour d’un joueur.

• Paramètres

  • source (number): L’ID serveur du joueur de référence.

  • range (number): Rayon de recherche.

• Retour

  • table: Un tableau contenant des instances Player.

---

Eko.Player:GetFromPed(pedId)

Récupère un joueur à partir de l’identifiant ped.

• Paramètres

  • pedId (number): Handle du ped.

• Retour

  • Player: L’instance sérialisée correspondant à ce ped.

---

🛠️ Exemple d’utilisation

-- Récupérer un joueur par son ID
local player = Eko.Player:Get(1)
if player then
    print("Joueur trouvé:", player.id)
end

-- Trouver le joueur le plus proche
local nearest = Eko.Player:GetNearest(1, 10.0)
if nearest then
    print("Joueur proche:", nearest.id)
end

-- Liste des joueurs dans un rayon
local nearbyPlayers = Eko.Player:GetInRange(1, 15.0)
for _, p in pairs(nearbyPlayers) do
    print("Joueur dans la zone:", p.id)
end

-- Récupérer un joueur à partir d’un ped
local fromPed = Eko.Player:GetFromPed(128)
if fromPed then
    print("Le ped appartient au joueur:", fromPed.id)
end

---

⚠️ Notes

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

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

• Si vous développez côté client, utilisez le module client Eko.Player correspondant.