FAQ / Troubleshooting
Q: Players canβt trigger fireworks. A: Check if
UseCommand
orUseItem
is set totrue
. Also confirm your item or command is spelled correctly.Q: No explosions or effects are seen. A: Verify the
particleDict
andparticleFx
names inConfig.Fireworks
are valid. Sometimes you need toRequestNamedPtfxAsset
or ensure the assets are loaded in your script.Q: Sound radius feels off. A: Adjust
Config.soundRadius
. Also note that actual GTA engine distance may vary with environment or if players are indoors.Q: Some fireworks spawn at odd angles or clip into the ground. A: You may need to set a spawn offset or adjust your propβs Z coordinate in your spawning code.
Q: How do I add more fireworks? A: Duplicate one of the existing entries in
Config.Fireworks
with a new key (e.g.,'fireworkx'
), set new particle effects, props, or shot settings.
Last updated