What is Particle FX? Introduction to the PTFX system in FiveM

Particle Effects, or PTFX for short, is a visual effects system in GTA V and FiveM that creates real-time animations such as smoke, fire, dust, sparks, blood, water, and thousands of other effects.

Why use Particle FX?

When you create a quality FiveM script, such as a weapon system, a vehicle system, a medicine system, or a special event — Particle FX is what makes your script. lively and professional looking

Structure of PTFX in FiveM

The PTFX system consists of 2 main parts:

1. Particle Dictionary (Asset)

Dictionary is a file that combines several effects together. Must always be loaded before use.

-- dictionary names such as "core", "scr_rcpaparazzo1", "exp_air_molotov"
local dictName = "core"

2. Particle Effect Name

Effect names within the dictionary, such as "exp_grd_grenade", "ent_amb_smoke_car"

Types of Particle FX

Type	Description	Native Function
Non-Looped	Shows once and then disappears	START_PARTICLE_FX_NON_LOOPED_*
Looped	Repeat until stopped	START_PARTICLE_FX_LOOPED_*
Networked	sync for all players to see	START_NETWORKED_PARTICLE_FX_*

Interesting numbers

• 2,000+ particle effects in GTA V / FiveM
• 47+ namespaces (dictionary groups)
• 7,358 native functions related to particles and other systems

How to get started?

Basic steps to use Particle FX:

-- 1. Request assets
RequestNamedPtfxAsset("core")

-- 2. Wait until the download is complete.
while not HasNamedPtfxAssetLoaded("core") do
  Citizen.Wait(0)
end

-- 3. Set the assets to be used.
UseParticleFxAssetNextCall("core")

-- 4. Play effect
StartParticleFxNonLoopedAtCoord(
  "exp_grd_grenade",
  x, y, z, -- coordinates
  0.0, 0.0, 0.0, -- rotation
  1.0, -- scale
  false, false, false
)

Summary

PTFX is a very powerful tool in FiveM — in the next article we'll dive into Non-Looped Effects, Looped Effects, and player sync.

Remember: Always request an asset before using it otherwise the effect will not show.