FindSafe - MXC Products Docs

Finds the nearest safe, optionally filtered by distance and model. Only enabled safes are searched.

Argument	Data Type	Needed	Default	Description
`coords`	vector3	❌	`nil`	The coordinates to search from, if `nil` the distance is ignored and a matching safe is returned
`distance`	number	❌	`nil`	The maximum distance from `coords`, if `nil` there is no limit
`model`	string	❌	`nil`	Only match safes of this model, if `nil` every model is matched

Returns

Type	Description
string \| nil	The id of the nearest matching safe, or `nil` if none was found

Example

local safeId = exports["mxc_safe"]:FindSafe(GetEntityCoords(GetPlayerPed(source)), 3.0, "mxc_safe_prop_base_01")

if safeId then
    print("Found the safe", safeId)
end