feat(imports): server-side entity iterators (#458)

Co-authored-by: Linden <65407488+thelindat@users.noreply.github.com>

imports/getNearbyPeds/shared.lua

@@ -0,0 +1,30 @@
+---@param coords vector3 The coords to check from.
+---@param maxDistance? number The max distance to check.
+---@return { ped: number, coords: vector3 }[]
+function lib.getNearbyPeds(coords, maxDistance)
+    local peds = GetGamePool('CPed')
+    local nearby = {}
+    local count = 0
+    maxDistance = maxDistance or 2.0
+
+    for i = 1, #peds do
+        local ped = peds[i]
+
+        if not IsPedAPlayer(ped) then
+            local pedCoords = GetEntityCoords(ped)
+            local distance = #(coords - pedCoords)
+
+            if distance < maxDistance then
+                count += 1
+                nearby[count] = {
+                    ped = ped,
+                    coords = pedCoords,
+                }
+            end
+        end
+    end
+
+    return nearby
+end
+
+return lib.getNearbyPeds