> For the complete documentation index, see [llms.txt](https://risk-scripts.gitbook.io/risk-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://risk-scripts.gitbook.io/risk-scripts/scripts/firework-script/faq-troubleshooting.md).

# FAQ / Troubleshooting

* <mark style="color:orange;">**Q:**</mark> *<mark style="color:orange;">Players can’t trigger fireworks.</mark>*\ <mark style="color:red;">**A**</mark>**:** Check if `UseCommand` or `UseItem` is set to `true`. Also confirm your item or command is spelled correctly.<br>
* <mark style="color:orange;">**Q:**</mark> *<mark style="color:orange;">No explosions or effects are seen.</mark>*\ <mark style="color:red;">**A**</mark>**:** 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.<br>
* <mark style="color:orange;">**Q:**</mark> *<mark style="color:orange;">Sound radius feels off.</mark>*\ <mark style="color:red;">**A**</mark>**:** Adjust `Config.soundRadius`. Also note that actual GTA engine distance may vary with environment or if players are indoors.<br>
* <mark style="color:orange;">**Q:**</mark> *<mark style="color:orange;">Some fireworks spawn at odd angles or clip into the ground.</mark>*\ <mark style="color:red;">**A**</mark>**:** You may need to set a spawn offset or adjust your prop’s Z coordinate in your spawning code.<br>
* <mark style="color:orange;">**Q:**</mark> *<mark style="color:orange;">How do I add more fireworks?</mark>*\ <mark style="color:red;">**A**</mark>**:** Duplicate one of the existing entries in `Config.Fireworks` with a new key (e.g., `'fireworkx'`), set new particle effects, props, or shot settings.