Shared

getClosestPlayer

fjsf.getClosestPlayer(coords, radius, includeSelf)

Returns the closest player to given world coordinates. Works on both client and server.

Parameters

• coords vector3 World position to search from.

• radius number | nil Maximum search distance.

• includeSelf boolean | number | nil Client: include local player. Server: player ID to ignore.

Returns

• playerId number | nil Closest player ID.

• playerPed number | nil Player ped handle.

• playerCoords vector3 | nil World position of the player.

• distance number | nil Distance from coords.

Example

local id, ped, coords, dist = fjsf.getClosestPlayer(
    GetEntityCoords(PlayerPedId()),
    10.0,
    false
)

---

getClosestPed

fjsf.getClosestPed(coords, radius)

Returns the closest non-player ped.

Parameters

• coords vector3 World position to search from.

• radius number | nil Maximum search distance.

Returns

• ped number | nil Ped handle.

• coords vector3 | nil Ped world position.

• distance number | nil Distance from coords.

Example

local ped, coords, dist = fjsf.getClosestPed(
    GetEntityCoords(PlayerPedId()),
    15.0
)

---

getNearbyPlayers

fjsf.getNearbyPlayers(coords, radius, includeSelf)

Returns all players within a radius, sorted by distance.

Parameters

• coords vector3 World position to search from.

• radius number Search radius.

• includeSelf boolean | number | nil Client: include local player. Server: player ID to ignore.

Returns

• players table Sorted list of players by distance.

Content item structure:

{
    id = number,
    ped = number,
    coords = vector3,
    distance = number
}

Example

local players = fjsf.getNearbyPlayers(
    GetEntityCoords(PlayerPedId()),
    20.0,
    false
)

---

getClosestObject

fjsf.getClosestObject(coords, radius)

Returns the closest object.

Parameters

• coords vector3 World position to search from.

• radius number | nil Maximum search distance.

Returns

• object number | nil Object handle.

• coords vector3 | nil Object world position.

• distance number | nil Distance from coords.

Example

local object, coords, dist = fjsf.getClosestObject(
    GetEntityCoords(PlayerPedId()),
    10.0
)

---

getClosestVehicle

fjsf.getClosestVehicle(coords, radius, includePlayerVehicle)

Returns the closest vehicle.

Parameters

• coords vector3 World position to search from.

• radius number | nil Maximum search distance.

• includePlayerVehicle boolean | nil Whether to include the player's current vehicle.

Returns

• vehicle number | nil Vehicle handle.

• vehicleCoords vector3 | nil Vehicle world position.

• distance number | nil Distance from coords.

Example

local veh, coords, dist = fjsf.getClosestVehicle(
    GetEntityCoords(PlayerPedId()),
    25.0,
    false
)

---

getNearbyPeds

fjsf.getNearbyPeds(coords, radius)

Returns all nearby non-player peds, sorted by distance.

Parameters

• coords vector3 World position to search from.

• radius number Search radius.

Returns

• peds table Sorted list of peds by distance.

Content item structure:

{
    ped = number,
    coords = vector3,
    distance = number
}

Example

local peds = fjsf.getNearbyPeds(
    GetEntityCoords(PlayerPedId()),
    30.0
)

---

getNearbyVehicles

fjsf.getNearbyVehicles(coords, radius, includePlayerVehicle)

Returns all nearby vehicles, sorted by distance.

Parameters

• coords vector3 World position to search from.

• radius number Search radius.

• includePlayerVehicle boolean | nil Include the player's current vehicle.

Returns

• vehicles table Sorted list of vehicles by distance.

Content item structure:

{
    vehicle = number,
    coords = vector3,
    distance = number
}

Example

local vehicles = fjsf.getNearbyVehicles(
    GetEntityCoords(PlayerPedId()),
    40.0,
    false
)

---

getNearbyObjects

fjsf.getNearbyObjects(coords, radius)

Returns all nearby objects, sorted by distance.

Parameters

• coords vector3 World position to search from.

• radius number Search radius.

Returns

• objects table Sorted list of objects by distance.

Content item structure:

{
    object = number,
    coords = vector3,
    distance = number
}

Example

local objects = fjsf.getNearbyObjects(
    GetEntityCoords(PlayerPedId()),
    15.0
)