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

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

imports/getNearbyPlayers/client.lua

@@ -1,6 +1,6 @@
 ---@param coords vector3 The coords to check from.
----@param maxDistance number The max distance to check.
----@param includePlayer boolean? Whether or not to include the current player.
+---@param maxDistance? number The max distance to check.
+---@param includePlayer? boolean Whether or not to include the current player.
 ---@return { id: number, ped: number, coords: vector3 }[]
 function lib.getNearbyPlayers(coords, maxDistance, includePlayer)
     local players = GetActivePlayers()

imports/getNearbyPlayers/server.lua

@@ -0,0 +1,29 @@
+---@param coords vector3 The coords to check from.
+---@param maxDistance? number The max distance to check.
+---@return { id: number, ped: number, coords: vector3 }[]
+function lib.getNearbyPlayers(coords, maxDistance)
+    local players = GetActivePlayers()
+    local nearby = {}
+    local count = 0
+    maxDistance = maxDistance or 2.0
+
+    for i = 1, #players do
+        local playerId = players[i]
+        local playerPed = GetPlayerPed(playerId)
+        local playerCoords = GetEntityCoords(playerPed)
+        local distance = #(coords - playerCoords)
+
+        if distance < maxDistance then
+            count += 1
+            nearby[count] = {
+                id = playerId,
+                ped = playerPed,
+                coords = playerCoords,
+            }
+        end
+    end
+
+    return nearby
+end
+
+return lib.getNearbyPlayers