Real fishing with skill, progression and fish you actually see in your hands.

Cast, strike and reel in 26 species across the whole map. Fill your Fishdex, chase server records, level up from Weekend Angler to Pak Long of the Sea, and sell your catch at the fish market. Every fish you land shows up as an animated 3D fish, held up proudly or flopping on the ground for the big ones, and everyone nearby sees it.

---

🎣 Skill-based fishing

• Cast meter: let go in the green zone for a perfect cast, which means faster bites and better fish.

• Watch the float: nibbles are fake-outs, so strike only when it goes under.

• Reel minigame: keep the fish inside your green bar. Heavier fish fight harder and shake the camera.

• Line snaps: hook something too strong for your rod and it breaks free. Upgrade to land it.

🐟 26 species, 6 rarities

• Common, Uncommon, Rare, Epic, Legendary and Mythic.

• Golden fish: any catch can come out golden, worth 5× the cash and 2× the XP.

• Every fish has a weight, a length and a 1–5 star size rating.

• Some fish only bite at night, some only in the rain, and every species has a favourite bait.

🗺️ Spots worth travelling to

• Any water works, but named spots give better odds and their own species: Del Perro Pier, Mirror Park Lake, Alamo Sea, Lago Zancudo, Paleto Cove and the Open Ocean.

• Spots unlock as you level up.

• A secret spot: find a message in a bottle to unlock the hidden Lighthouse Grotto.

📈 Progression

• 15 angler levels, each with its own title.

• Fishdex: track every species with your catch count and personal best. Complete a rarity tier for a cash reward.

• Server records: beat the biggest catch of a species and the whole server hears about it.

• Legendary and Mythic catches are announced to everyone.

🏪 Fish market

• A market NPC with a map blip (Del Perro Pier by default) where you sell your catch, buy rods and bait, and upgrade your keepnet.

• Daily bounty: one wanted fish each day sells for 3× at the market.

• 3 rods (Bamboo, Carbon, Tidecaller), each better at landing rarer fish.

• 4 baits (Worms, Shrimp, Spinner Lure, Squid).

• Keepnet upgrades from 15 up to 60 fish.

🎁 Junk & treasure

Soggy boots and rusty cans, plus lost wallets with cash inside and the rare sunken treasure.

✨ Animated fish props (pj-fishprop included)

• 24 custom fish models with swim and flop animations.

• Smaller fish are held up at chest height. Big ones flop on the ground beside you.

• Catch camera: the camera swings round to show off your fish while the catch card is up.

• Other players nearby see your catch too.

🖥️ Clean, modern UI

• A glass-style HUD with an angler menu (/fishing or F6): keepnet, Fishdex, spots, shop and stats.

• Catch reveal card with rarity colours, badges (New Species, Personal Best, Server Record, Golden) and confetti for the big ones.

• The game stays visible: no full-screen menus blocking your view.

🔒 Secure by design

• The server decides every catch. The client only knows how hard the fish pulls, not what it is.

• Every catch is checked on the server: one-time catch codes, a minimum reel time, and checks that the player is at the spot and near the market.

• Progress is saved to the database per character.

---

⚙️ Requirements

• oxmysql

• QBCore + qb-inventory 2.x + qb-target out of the box.

• Other frameworks: all framework, inventory, notify and target code is in open, documented bridge files (not escrowed). Rewrite a few short functions to run it on ESX, ox_inventory, ox_target or a custom setup.

📦 What's included

• pj-fishing: the fishing script.

• pj-fishprop: animated fish models and animations.

• Item definitions and item images for rods and bait.

• Full install guide.

🛠️ Easy to configure

Open config.lua files for species, prices, rarities, spots, rods, bait, levels, keepnet sizes, the market location, the payout account and the command and key. The database table is created automatically.