Loading content...
Nearby
Proximity helpers — peds, vehicles and objects within a radius, or the closest player / vehicle.
Proximity helpers — peds, vehicles and objects within a radius, or the closest player / vehicle.
lib.nearby finds entities around a point — peds, vehicles or objects within a radius, or the single
closest player / vehicle. Client-side: it walks the local game pools, so it only sees what's streamed
in around you.
local closest = lib.nearby.closestVehicle()
if closest then
SetVehicleDoorOpen(closest.vehicle, 0, false, false)
end| Function | Returns | Description |
|---|---|---|
peds(coords, radius) | NearbyPed[] | Every ped in range — { ped, coords, distance }. Excludes the local ped, mixes players and NPCs. |
vehicles(coords, radius) | NearbyVehicle[] | Every vehicle in range — { vehicle, coords, distance }. |
objects(coords, radius) | NearbyObject[] | Every world object / prop in range — { object, coords, distance }. |
closestPlayer(coords?, radius?) | ClosestPlayer? | Nearest active player — { serverId, ped, coords, distance }. Excludes you; coords nil = local ped. |
closestVehicle(coords?, radius?) | ClosestVehicle? | Nearest vehicle — { vehicle, coords, distance }; coords nil = local ped. |
peds(coords, radius)NearbyPed[]{ ped, coords, distance }. Excludes the local ped, mixes players and NPCs.vehicles(coords, radius)NearbyVehicle[]{ vehicle, coords, distance }.objects(coords, radius)NearbyObject[]{ object, coords, distance }.closestPlayer(coords?, radius?)ClosestPlayer?{ serverId, ped, coords, distance }. Excludes you; coords nil = local ped.closestVehicle(coords?, radius?)ClosestVehicle?{ vehicle, coords, distance }; coords nil = local ped.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('nearest player:', closest.serverId, closest.distance)
endpeds mixes players and NPCs — filter with IsPedAPlayer(entry.ped) if you only want one kind, and
vehicles includes your own car when you're in it. closestPlayer walks GetActivePlayers (the
players streamed in around you), not the full server roster. On closest*, a nil radius means no
limit — it returns the nearest match even 2 km away. These calls are O(n) over the game pool, so
throttle them — never inside a Wait(0) loop.