Preview

Hey everyone,

After months of development and live-server testing, it’s finally here: a complete, modular fishing experience for FiveM. This is not “cast a line and wait” — it’s a full ecosystem of fishing methods, each with its own custom-built minigame, props, and progression. Rod fishing, crab hunting, net casting, spearfishing, free diving, boat rentals, quests, leaderboards — all wired into one optimized, framework-agnostic resource.

Everything is server-validated, fully localized, and ships with custom streamed props.

Core Rod Fishing — Three Real Minigames

Forget single-bar fishing. Catching a fish is a three-stage skill challenge, not a coin flip.

• Cast Minigame — a sliding marker on a vertical bar. Land it in the green zone to cast; nail the inner perfect band for a x1.6 rare-bite chance bonus.

• Reflex Minigame — timed circle clicks with a center “perfect” window. Miss too many and the fish escapes.

• Catch Minigame — a hold-bar tug-of-war. Keep the fish inside the zone long enough to land it. Zone width and fish speed scale dynamically with rarity — a Legendary fights back hard.

Bite chance, fish pool, and difficulty all react to your rod tier, bait, the zone you’re in, and even the in-game time of day (some fish are night-only).

Crab Hunting

A completely separate bait-based hunting loop with its own dedicated minigame.

• Place crab bait on the ground — after a short delay a crab approaches and walks toward the bait (with a chance it gets spooked and flees: the teaser).

• Mouse-Tracking Minigame — the crab hops around the screen; hover your cursor over it to fill the catch bar before it escapes.

• 3 crab types (Common, Rare, Legendary) with custom streamed props, weighted spawn rates, level gates, and prices up to 1.400$.

• Multiple active baits per player, dedicated crab-spot zones with orange radius blips.

Net Fishing

Cast a real physics-driven net into rivers and lakes and pull in multiple fish at once.

• Throw the net with a full arc + splash, watch it sink with a native rope system (no player drag).

• Rhythm Tension Minigame — fish flood the net, rope tension rises and falls. Use Q (slack) and E (pull) to hold tension in the green zone.

• Catch 3–6 fish per perfect cast, with bonus rare-drop chances and a tear-risk mechanic.

• Custom empty/full net props that swap on a successful haul, junk drops, and zone whitelisting.

Spearfishing

A fully custom spear system built on WEAPON_SPEAR — because the native weapon can’t fire on its own, every bit of this is hand-built.

• Physical spear projectile with a real rope, in-air travel, underwater drag, gravity, and wave sway.

• Spear sticks into the fish (or stays embedded on a miss) — then reel it back in with G and play a catch animation.

• Realistic fish swim AI: waypoint pathing, depth control, natural roll/pitch, and a flee response when you get too close.

• Custom 3D positioned speargun sound broadcast to nearby players.

• Custom spear ammo prop with muzzle-accurate attach points.

Rarity, Fish Pool & Zones

• 5 rarity tiers — Common → Uncommon → Rare → Epic → Legendary, each with its own catch modifiers and HUD color.

• 20+ fish types with per-fish price, spawn weight, allowed zones, time windows, and bait requirements.

• Multiple fishing zones — Pier, Beach, Open Sea, Deep Waters, Alamo Lake, River — each with its own fish pool and blips.

• Legendary catches like the Golden Fish and Sea Monster, with strict level/time/bait gates.

Illegal Zone — High Risk, High Reward

A remote offshore black-market spot for serious anglers.

• Level 30+ only, accessible exclusively with a Carbon or Legendary rod + Live Bait.

• Black-market exclusive catches: Moray Eel, Black Market Tuna, Endangered Turbot — selling for up to 22.000$ each.

• Custom catch-difficulty overrides and night-only windows for the rarest species.

Progression — XP & Levels

• 50 levels with a tunable XP curve.

• XP scales by fish rarity; higher levels grant an increasing rare-bite chance (up to +25%).

• 4 rod tiers (Bamboo → Professional → Carbon → Legendary) with distinct wait time, rarity boost, catch ease, and durability stats.

• 2 bait types including exclusive Live Bait for the illegal zone.

Free Diving

Dive into designated underwater zones and hunt with your spear.

• Depth-tiered fish pools — shallow, mid, and deep waters spawn different species (the deep holds Swordfish, Tuna, Golden Fish, and a 1-in-a-hundred Sea Monster).

• Oxygen system — equip an Oxygen Mask for 3 minutes of air; run out underwater and you start taking drown damage, with HUD warnings in the final 30 seconds.

• Diving Suit applies a full underwater outfit on use.

• Shark encounters — a rare aggressive predator (Tiger/Hammerhead/Killer Whale) that hunts the player, with health, attack, chase and flee behavior. Kill it for a reward.

• Fully multiplayer-synced fish and props.

Boat Rental

• NPC-driven coastal boat rental with a clean rental UI.

• 3 boats (Dinghy, Tropic, Tug) with per-boat price, level gate, seats, and stats.

• Timed rentals with partial refund on return within the radius.

Vendor NPC — One Hub for Everything

A single fish merchant NPC with a polished multi-tab interface:

• Sell — bulk-sell your entire catch with live totals.

• Shop — buy rods, baits, crab bait, diving equipment, speargun, and nets (all level-gated).

• Quests — daily, weekly, and permanent achievement objectives.

• Stats — personal fishing statistics.

• Leaderboard — server-wide ranking by total sales value (configurable: value / count / level).

Quests & Daily Engagement

• Daily objectives (catch X fish, earn X money, catch rare fish).

• Weekly objectives (legendary catches, net hauls, crab counts).

• Permanent achievements with large cash + XP rewards.

• Auto-resetting timers with cash, XP, and item rewards.

Security & Quality

• Every server event is validated — item possession checks, level gating, balance checks, and zone/rod/bait requirements are all enforced server-side.

• Per-player cooldowns and anti-spam locks across every fishing method.

• Multiplayer-synced entities (fish, crabs, nets, spears) so everyone sees the same world.

• Clean restore on resource stop / player disconnect — no frozen props or stuck entities left behind.

• Fully locale-driven — every user-facing string is translatable.

Custom Props & Assets

Ships with its own streamed .ytyp and props:

• 3 unique crab models (common / rare / legendary)

• Worm bait prop

• Empty + full fishing net props

• Custom spear ammo prop

• Custom speargun sound file

Compatibility & Framework

• ox_lib required

• oxmysql required

• Frameworks: ESX & QBCore (auto-detected)

• Target: ox_target, qb-target (or none)

• Notifications: ox_lib

• Progress bar: ox_lib, qb, progressbar

• 10 languages out of the box: EN, TR, ES, FR, DE, PT, RU, ZH, JA, AR

Everything is wired through a bridge layer, so you can mix and match components without touching the core code.

Optimization

• Idle usage: 0.00 ms

• Active usage stays minimal — entity spawning is capped, throttled, and cleaned up automatically.

Configuration

Everything important lives in the config/ folder — fish, baits, rods, zones, crabs, net, spear, diving, boats, quests, and shop are each in their own clean, fully-commented file. Difficulty curves, prices, level gates, spawn rates, props, sounds, blips, minigame tuning — nothing is hardcoded.

Join our Discord!

Subscribe to our channel!