❔FAQ / Troubleshooting
Q: Players can’t trigger fireworks. A: Check if
UseCommandorUseItemis set totrue. Also confirm your item or command is spelled correctly.Q: No explosions or effects are seen. A: Verify the
particleDictandparticleFxnames inConfig.Fireworksare valid. Sometimes you need toRequestNamedPtfxAssetor 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.Fireworkswith a new key (e.g.,'fireworkx'), set new particle effects, props, or shot settings.
Last updated