❔FAQ / Troubleshooting

• Q: Players can’t trigger fireworks. A: Check if UseCommand or UseItem is set to true. Also confirm your item or command is spelled correctly.

• Q: No explosions or effects are seen. A: Verify the particleDict and particleFx names in Config.Fireworks are valid. Sometimes you need to RequestNamedPtfxAsset 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.