Files
community_bridge/lib/markers/client/markers.lua
T

147 lines
5.3 KiB
Lua
Raw Normal View History

2025-05-09 19:06:50 -05:00
---@diagnostic disable: duplicate-set-field
Marker = {}
local Created = setmetatable({}, { __mode = "k" }) --what is mode?
2025-05-12 00:58:25 -05:00
local Ids = Ids or Require("lib/utility/shared/ids.lua")
local point = Point or Require("lib/points/client/points.lua")
2025-05-09 19:06:50 -05:00
local loopRunning = false
local Drawing = {}
2025-05-05 11:22:38 -03:00
--- This will validate the marker data.
--- @param data table{position: vector3, offset: vector3, rotation: vector3, size: vector3, color: vector3, alpha: number, bobUpAndDown: boolean, marker: number, interaction: function}
--- @return boolean
local function validateMarkerData(data)
if not data.position or not data.position.x or not data.position.y or not data.position.z then
print("Invalid marker position. Must be a vector3 with x, y, and z coordinates.")
return false
end
if data.offset and (not data.offset.x or not data.offset.y or not data.offset.z) then
print("Invalid marker offset. Must be a vector3 with x, y, and z coordinates.")
return false
end
if data.rotation and (not data.rotation.x or not data.rotation.y or not data.rotation.z) then
print("Invalid marker rotation. Must be a vector3 with x, y, and z coordinates.")
return false
end
return true
end
--- This will create a marker.
--- @param data table{position: vector3, offset: vector3, rotation: vector3, size: vector3, color: vector3, alpha: number, bobUpAndDown: boolean, marker: number, interaction: function}
2025-05-09 19:06:50 -05:00
--- @return string|nil
function Marker.Create(data)
2025-05-12 00:58:25 -05:00
local _id = data.id or Ids.CreateUniqueId(Created)
2025-05-09 19:06:50 -05:00
if not validateMarkerData(data) then return end
local basePosition = data.position or vector3(0.0, 0.0, 0.0)
local baseOffset = data.offset or vector3(0.0, 0.0, 0.0)
local data = {
2025-05-05 11:22:38 -03:00
id = _id,
2025-05-09 19:06:50 -05:00
position = vector3(basePosition.x + baseOffset.x, basePosition.y + baseOffset.y, basePosition.z + baseOffset.z),
marker = data.marker or 1,
rotation = data.rotation or vector3(0, 0, 0),
size = data.size or vector3(1.0, 1.0, 1.0),
color = data.color or vector3(0, 255, 0),
alpha = data.alpha or 255,
bobUpAndDown = data.bobUpAndDown,
-- interaction = data.interaction or false, -- Uncomment if you re-implement interaction logic
rotate = data.rotate,
textureDict = data.textureDict,
textureName = data.textureName,
drawOnEnts = data.drawOnEnts,
2025-05-05 11:22:38 -03:00
}
2025-05-09 19:06:50 -05:00
Created[_id] = data
point.Register(
_id, data.position, data.drawDistance or 50.0, data,
function(_)
if not Created[_id] then return point.Remove(_id) end
Drawing[_id] = Created[_id]
2025-05-12 02:44:27 -05:00
Marker.Run()
2025-05-09 19:06:50 -05:00
end,
function(markerData)
Drawing[_id] = nil
2025-05-12 00:58:25 -05:00
end, nil
2025-05-09 19:06:50 -05:00
)
2025-05-05 11:22:38 -03:00
return _id
end
2025-05-09 19:06:50 -05:00
--- This will remove a marker.
--- @param id string
--- @return boolean
function Marker.Remove(id)
if not Created[id] then return false end
point.Remove(id)
Drawing[id] = nil
Created[id] = nil
return true
2025-02-05 17:42:50 -06:00
end
2025-05-09 19:06:50 -05:00
--- This will remove all markers.
--- @param id string
function Marker.RemoveAll()
for id, _ in pairs(Created) do
point.Remove(id)
Created[id] = nil
end
end
2025-05-05 11:22:38 -03:00
2025-05-09 19:06:50 -05:00
-- This will loop through all marker(points) in range and draw them.
-- @param data table{marker: number, position: vector3, rotation: vector3, size: vector3, color: vector3, alpha: number, bobUpAndDown: boolean, faceCamera: boolean, rotate: boolean, textureDict: string, textureName: string, drawOnEnts: boolean}
-- @return nil
2025-05-12 02:44:27 -05:00
function Marker.Run()
2025-05-09 19:06:50 -05:00
if loopRunning then return end
loopRunning = true
CreateThread(function()
while loopRunning do
2025-05-12 02:44:27 -05:00
if not next(Created) then
loopRunning = false
return
end
2025-05-09 19:06:50 -05:00
for drawingId, drawingData in pairs(Drawing) do
if not Created[drawingId] then
Drawing[drawingId] = nil
2025-05-05 11:22:38 -03:00
goto continue
end
2025-05-09 19:06:50 -05:00
DrawMarker(
2025-05-12 02:44:27 -05:00
drawingData.marker,
drawingData.position.x, drawingData.position.y, drawingData.position.z,
2025-05-09 19:06:50 -05:00
0.0, 0.0, 0.0,
2025-05-12 02:44:27 -05:00
drawingData.rotation.x, drawingData.rotation.y, drawingData.rotation.z,
drawingData.size.x, drawingData.size.y, drawingData.size.z,
drawingData.color.x, drawingData.color.y, drawingData.color.z, drawingData.alpha,
drawingData.bobUpAndDown, drawingData.faceCamera, false,
drawingData.rotate, drawingData.textureDict, drawingData.textureName, drawingData.drawOnEnts
2025-05-09 19:06:50 -05:00
)
::continue::
2025-05-05 11:22:38 -03:00
end
2025-05-09 19:06:50 -05:00
Wait(3)
2025-05-05 11:22:38 -03:00
end
2025-05-09 19:06:50 -05:00
end)
2025-05-05 11:22:38 -03:00
end
2025-05-09 19:06:50 -05:00
RegisterNetEvent("community_bridge:Client:Marker", function(data)
Marker.Create(data)
end)
2025-05-12 00:58:25 -05:00
RegisterNetEvent("community_bridge:Client:MarkerBulk", function(datas)
if not datas then return end
for _, data in pairs(datas) do
Marker.Create(data)
end
end)
2025-05-09 19:06:50 -05:00
RegisterNetEvent("community_bridge:Client:MarkerRemove", function(id)
Marker.Remove(id)
end)
2025-05-12 00:58:25 -05:00
RegisterNetEvent("community_bridge:Client:MarkerRemoveBulk", function(ids)
if not ids then return end
for _, id in pairs(ids) do
Marker.Remove(id)
end
end)
2025-02-06 12:26:30 -06:00
exports("Marker", Marker)
2025-02-05 17:42:50 -06:00
2025-05-05 11:22:38 -03:00
2025-02-06 12:26:30 -06:00
return Marker