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

131 lines
5.3 KiB
Lua
Raw Normal View History

2025-05-12 00:58:25 -05:00
Particles = {}
2025-04-08 16:47:27 -05:00
Particle = {}
2025-05-12 00:58:25 -05:00
---@diagnostic disable: duplicate-set-field
Ids = Ids or Require("lib/utility/shared/ids.lua")
2025-04-19 13:26:20 -05:00
---Loads a ptfx asset into memory.
---@param dict string
---@return boolean
function LoadPtfxAsset(dict)
2025-04-08 16:47:27 -05:00
local failed = 100
2025-02-10 01:01:32 -06:00
while not HasNamedPtfxAssetLoaded(dict) and failed >= 0 do
2025-04-19 13:26:20 -05:00
RequestNamedPtfxAsset(dict)
2025-02-10 01:01:32 -06:00
failed = failed - 1
2025-04-19 13:26:20 -05:00
Wait(100)
2025-02-10 01:01:32 -06:00
end
2025-04-19 13:26:20 -05:00
assert(failed > 0, "Failed to load dict asset: " .. dict)
return HasNamedPtfxAssetLoaded(dict)
2025-04-08 16:47:27 -05:00
end
2025-02-10 01:01:32 -06:00
2025-04-08 16:47:27 -05:00
--- Create a particle effect at the specified position and rotation.
--- @param dict string
--- @param ptfx string
--- @param pos vector3
--- @param rot vector3
--- @param scale number
--- @param color vector3
--- @param looped boolean
--- @param removeAfter number|nil
2025-04-08 16:47:27 -05:00
--- @return number|nil ptfxHandle -- The handle of the particle effect, or nil if it failed to create.
function Particle.Play(dict, ptfx, pos, rot, scale, color, looped, removeAfter)
2025-04-19 13:26:20 -05:00
LoadPtfxAsset(dict)
2025-04-20 18:54:27 -05:00
UseParticleFxAssetNextCall(dict)
SetParticleFxNonLoopedColour(color.x, color.y, color.z)
local particle = nil
removeAfter = removeAfter or 5000
2025-04-20 18:54:27 -05:00
if looped then
particle = StartParticleFxLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
local strParticle = tostring(particle)
Particles[strParticle] = particle
Wait(10)
if particle == 0 or not DoesParticleFxLoopedExist(particle) then
particle = StartParticleFxNonLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
if not particle and particle == 0 then
print(string.format("[Particle] Failed to start particle fx: %s from dict: %s", ptfx, dict))
return nil
2025-04-19 13:26:20 -05:00
end
local strParticle = tostring(particle)
Particles[strParticle] = particle
CreateThread(function()
while Particles[strParticle] do
Wait(removeAfter)
if not Particles[strParticle] then break end
RemoveParticleFx(particle, false)
particle = StartParticleFxNonLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
Particles[strParticle] = particle
end
end)
return strParticle
else
if not removeAfter or removeAfter <= 0 then return particle end
CreateThread(function()
while Particles[strParticle] do
Wait(removeAfter)
if not Particles[strParticle] then break end
StopParticleFxLooped(particle, false)
UseParticleFxAssetNextCall(dict)
LoadPtfxAsset(dict)
particle = StartParticleFxLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
Particles[strParticle] = particle
end
end)
return strParticle
end
else
particle = StartParticleFxLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
Wait(10)
if not DoesParticleFxLoopedExist(particle) then
particle = StartParticleFxNonLoopedAtCoord(ptfx, pos.x, pos.y, pos.z, rot.x, rot.y, rot.z, scale, false, false, false, false)
end
Wait(removeAfter)
Particle.Stop(particle)
2025-04-20 18:54:27 -05:00
end
return particle
end
2025-05-12 00:58:25 -05:00
function Particle.Stop(particle)
2025-04-20 18:54:27 -05:00
if not particle then return end
StopParticleFxLooped(particle, false)
RemoveParticleFx(particle, false)
RemoveNamedPtfxAsset(particle)
Particles[tostring(particle)] = nil
2025-04-19 13:26:20 -05:00
end
function Particle.CreateOnEntity(dict, ptfx, entity, offset, rot, scale, color, looped, loopLength)
LoadPtfxAsset(dict)
2025-02-10 01:01:32 -06:00
UseParticleFxAssetNextCall(dict)
2025-04-19 13:26:20 -05:00
SetParticleFxNonLoopedColour(color.x, color.y, color.z)
local particle = nil
2025-02-10 01:01:32 -06:00
if looped then
2025-04-19 13:26:20 -05:00
particle = StartNetworkedParticleFxLoopedOnEntity(ptfx, entity, offset.x, offset.y, offset.z, rot.x, rot.y, rot.z, scale, false, false, false)
2025-02-10 01:01:32 -06:00
if loopLength then
Wait(loopLength)
2025-04-19 13:26:20 -05:00
RemoveParticleFxFromEntity(entity)
2025-02-10 01:01:32 -06:00
end
else
2025-04-19 13:26:20 -05:00
particle = StartNetworkedParticleFxLoopedOnEntity(ptfx, entity, offset.x, offset.y, offset.z, rot.x, rot.y, rot.z, scale, false, false, false)
2025-02-10 01:01:32 -06:00
end
2025-04-19 13:26:20 -05:00
RemoveNamedPtfxAsset(ptfx)
return particle
2025-02-10 01:01:32 -06:00
end
2025-04-19 13:26:20 -05:00
function Particle.CreateOnEntityBone(dict, ptfx, entity, bone, offset, rot, scale, color, looped, loopLength)
LoadPtfxAsset(dict)
UseParticleFxAssetNextCall(dict)
SetParticleFxNonLoopedColour(color.x, color.y, color.z)
local particle = nil
if looped then
particle = StartNetworkedParticleFxLoopedOnEntityBone(ptfx, entity, offset.x, offset.y, offset.z, rot.x, rot.y, rot.z, bone, scale, false, false, false)
if loopLength then
Wait(loopLength)
RemoveParticleFxFromEntity(entity)
end
else
particle = StartNetworkedParticleFxNonLoopedOnEntityBone(ptfx, entity, offset.x, offset.y, offset.z, rot.x, rot.y, rot.z, bone, scale, false, false, false)
end
RemoveNamedPtfxAsset(ptfx)
return particle
end
2025-04-08 16:47:27 -05:00
return Particle