Skip to main content
atlasFishing is a complete fishing activity for FiveM, built on atlasBridge. One fisherman ped sells supplies and buys your catch; players cast near water, play a quick minigame, and reel in fish across six rarity tiers. Progression is bait-driven — better bait, better odds. Because it runs on the bridge, it works on ESX, QBox, QB-Core, or standalone with ox / qb / qs inventories — no per-framework glue. The bridge handles framework, inventory, UI, target/interaction, money, and entity cleanup, so the fishing logic stays the same on every stack.

Installation

Place the resource, set the start order, register the inventory items, and run a smoke test. Includes a fast-path speed run.

Configuration

The authoritative guide to every config.lua block — ped, cast, tiers, baits, fish, zones, minigames, selling, shop, boat rental.

Items & Icons

The item keys the script expects and how to register them per inventory.

Minigames

How Tension, Whirlpool, Cast Meter, and Reel Rhythm work and how to tune them.

​
The player loop

1

Interact with the fisherman

Walk up to the fisherman ped and interact (default key E) to open Supplies or Sell.
2

Buy a rod and bait

Purchase a fishing_rod and at least one bait from the supplies shop. Bait sets your catch odds.
3

Cast on water

Use the rod near water (or from a boat). A cast progress bar runs, then a random idle wait before the bite.
4

Play the minigame

One of four NUI minigames opens. Land it to hook the catch.
5

Reel in by rarity tier

The server rolls a catch weighted by tier, bait, and zone. The fish spawns, flops on the ground, and the player picks it up and holds it.
6

Sell the catch

Return to the fisherman and sell. Payouts go to the configured money account.

​
Feature map

Each feature maps to one config block. Use this to jump straight to what you want to tune.

​
Dependencies

atlasFishing declares dependency 'atlasBridge' and will not initialize without it.
  • atlasBridge — hard dependency, started before this resource.
  • A supported framework + inventory detected by the bridge, or standalone mode.
  • OneSync.
  • The committed web/dist NUI build (ships with the resource).
  • Inventory items registered in your inventory (rod, baits, fish).
The resource folder must stay named atlasFishing. shared/guard.lua checks the name on startup; if it is renamed, the script prints a console warning and disables itself until the folder name is restored.

​
Next steps

Install it

Get the resource running, items registered, and a working catch.

Balance the economy

Tune tiers, bait, prices, and payouts for your server.