❔FAQ / Troubleshooting

Common questions and fixes

• Q: Players can’t fish (says “need a rod”). A: Check the item names in Config.NormalRodItem or Config.PremiumRodItem. Ensure they exist in your framework’s inventory.

• Q: Fishing stops right away or never starts. A: Verify you have a valid zone (currentZone) if FishingAnywhere=false. Also ensure the MaxFishingDistance is high enough for typical movements.

• Q: No fish to sell, but I have fish in inventory. 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.

• Q: Players get stuck with hunger/thirst never decreasing. A: Set PreventHungerThirstLoss=false if you use status scripts that should continue draining needs while fishing.

• Q: The boat anchor doesn’t work. 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.

• Q: The script can’t find ESX or QBCore A: Confirm you start es_extended or qb-core before this script. If “auto” detection fails, explicitly set Config.Framework="ESX" or "QBCore".

• Q: My custom notifications do nothing 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.