❔FAQ / Troubleshooting

• Q: The script can’t detect ESX/QB. A: Ensure es_extended or qb-core is started before this resource. If auto-detection fails, set Config.Framework to "esx" or "qb".

• Q: Players can’t dig—keeps saying “You do not have a shovel.” A: Check that the shovel item name is correct in your database and script references Config.Upgrades["shovel"].item properly. Also confirm the player actually has that item in inventory.

• Q: Battery or radius upgrades do nothing A: Make sure your client logic references Config.Upgrades["max_battery"] or "radius" levels.

• Q: Scoreboard doesn’t update A: The script calls a scoreboard refresh event when a new item is discovered. Confirm your server logs for errors if the scoreboard fails to refresh. Also, ensure data.json is writeable if it’s storing scoreboard data.

• Q: The metal detector can’t be used in certain areas A: The script might check for surfaces or ground presence. If getSurface() logic or your allowlist doesn’t include the ground type, it might block usage in that area.