> 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/free-afk-fishing-script/faq-troubleshooting.md).

# FAQ / Troubleshooting

Common questions and fixes

* <mark style="color:yellow;">**Q: Players can’t fish (says “need a rod”).**</mark>\
  **A:** Check the item names in `Config.NormalRodItem` or `Config.PremiumRodItem`. Ensure they exist in your framework’s inventory.<br>
* <mark style="color:yellow;">**Q: Fishing stops right away or never starts.**</mark>\
  **A:** Verify you have a valid zone (`currentZone`) if `FishingAnywhere=false`. Also ensure the `MaxFishingDistance` is high enough for typical movements.<br>
* <mark style="color:yellow;">**Q: No fish to sell, but I have fish in inventory.**</mark>\
  **A:** Confirm each fish item in your script’s `SellItems` is spelled exactly like the item in your server’s database. If a mismatch occurs, it won’t recognize the item.<br>
* <mark style="color:yellow;">**Q: Players get stuck with hunger/thirst never decreasing**</mark>**.**\
  **A:** Set `PreventHungerThirstLoss=false` if you use status scripts that should continue draining needs while fishing.<br>
* <mark style="color:yellow;">**Q: The boat anchor doesn’t work.**</mark>\
  **A:** Double-check `Config.AnchorItem` matches the item name in your database. Also ensure you use a **boat** (class 14) as `GetVehicleClass(veh)` must be 14 for the anchor logic.<br>
* <mark style="color:yellow;">**Q: The script can’t find ESX or QBCore**</mark>\
  **A:** Confirm you start `es_extended` or `qb-core` **before** this script. If “auto” detection fails, explicitly set `Config.Framework="ESX"` or `"QBCore"`.<br>
* <mark style="color:yellow;">**Q: My custom notifications do nothing**</mark>\
  **A:** If `UseCustomNotify` is `true`, ensure `Config.Functions.notify` is defined. If it’s an external event, e.g. `myNotifySystem:DoNotify`, call it inside that function.