Nearby
Helpers de proximité — peds, véhicules et objets dans un rayon, ou le joueur / véhicule le plus proche.
Helpers de proximité — peds, véhicules et objets dans un rayon, ou le joueur / véhicule le plus proche.
lib.nearby trouve les entités autour d'un point — peds, véhicules ou objets dans un rayon, ou le seul
joueur / véhicule le plus proche. Côté client : il parcourt les game pools locaux, donc il ne voit que ce
qui est streamé autour de toi.
local closest = lib.nearby.closestVehicle()
if closest then
SetVehicleDoorOpen(closest.vehicle, 0, false, false)
end| Fonction | Retour | Description |
|---|---|---|
peds(coords, radius) | NearbyPed[] | Tous les peds dans le rayon — { ped, coords, distance }. Exclut le ped local, mélange joueurs et PNJ. |
vehicles(coords, radius) | NearbyVehicle[] | Tous les véhicules dans le rayon — { vehicle, coords, distance }. |
objects(coords, radius) | NearbyObject[] | Tous les objets / props du monde dans le rayon — { object, coords, distance }. |
closestPlayer(coords?, radius?) | ClosestPlayer? | Le joueur actif le plus proche — { serverId, ped, coords, distance }. T'exclut ; coords nil = ped local. |
closestVehicle(coords?, radius?) | ClosestVehicle? | Le véhicule le plus proche — { vehicle, coords, distance } ; coords nil = ped local. |
peds(coords, radius)NearbyPed[]{ ped, coords, distance }. Exclut le ped local, mélange joueurs et PNJ.vehicles(coords, radius)NearbyVehicle[]{ vehicle, coords, distance }.objects(coords, radius)NearbyObject[]{ object, coords, distance }.closestPlayer(coords?, radius?)ClosestPlayer?{ serverId, ped, coords, distance }. T'exclut ; coords nil = ped local.closestVehicle(coords?, radius?)ClosestVehicle?{ vehicle, coords, distance } ; coords nil = ped local.local playerCoords = GetEntityCoords(cache.ped)
local peds = lib.nearby.peds(playerCoords, 10.0)
for i = 1, #peds do
print(peds[i].ped, peds[i].distance)
end
local closest = lib.nearby.closestPlayer(nil, 5.0)
if closest then
print('joueur le plus proche:', closest.serverId, closest.distance)
endpeds mélange joueurs et PNJ — filtre avec IsPedAPlayer(entry.ped) si tu n'en veux qu'un type, et
vehicles inclut ta propre voiture quand tu es dedans. closestPlayer parcourt GetActivePlayers
(les joueurs streamés autour de toi), pas le roster serveur complet. Sur closest*, un radius nil
signifie aucune limite — il renvoie le plus proche même à 2 km. Ces appels sont en O(n) sur le game
pool, alors throttle-les — jamais dans une boucle Wait(0).