NullSect
Systems nominal

Docs / Fishing / Overview

ns-fishing

NullSect Fishing for Qbox (QBCore / ESX / standalone supported through bridges).

Features

  • Catch minigame in the style of Stardew Valley: keep the fish inside the bar until the meter fills. Five fish behaviours (smooth, mixed, dart, sinker, floater), difficulty from the species and the fish's size.
  • Server-authoritative fishing: the server picks the zone from your position, times the bite, rolls species, weight and stars before the minigame, and refuses impossible minigame times.
  • Fishing zones: freshwater, coast and deep sea, each with its own species, level requirement and optional boat rule.
  • 30+ catchables: 23 fish species, 5 zone-bound legendary fish, junk, pearls and treasure chests.
  • Time and weather windows: some species only bite at night, at dawn, in the rain or in a thunderstorm; the journal tells you when.
  • Rod durability and line break (ox_inventory): rods wear out and are repaired at the market; pull too hard against a fish and the line snaps.
  • Rods and baits: 5 rod tiers (bigger fish, larger catch bar, faster reeling) and 6 baits with species affinities.
  • Tackle upgrades per player: reel (bar size), line (slower escape), hook (faster bites, rarer fish, treasure).
  • Levels: 50 levels on a growing XP curve; rods, baits, zones, boats and upgrades unlock by level.
  • Moving market: prices drift every tick, drop when a fish is flooded onto the market, one "hot" species pays extra. Fish value depends on weight, stars and the current price.
  • Daily orders: three orders per day, the same for everyone, each paid once per player.
  • Fish journal: every species, how many you caught and your record weight; first catches give bonus XP.
  • Boat rental at docks: rent price + deposit, refunded on return (minus damage), keys and fuel through bridges.
  • Tournaments: scheduled or admin-started contests (heaviest fish, most fish, biggest haul, optionally one species) with a live board and prizes for the top places; offline winners get theirs on the next login.
  • Random events: fish frenzy in one zone, a migrating shoal, golden hour (more XP) and market rush (one species sells higher), announced to everyone and marked on the map.
  • Achievements and titles: 19 tiered goals with money / XP rewards, titles you can show on your licence, the top lists and the tournament board. Buyers can add their own in data/achievements.lua.
  • Top anglers and records: all-time top lists (level, fish, heaviest, earnings, legends) and the heaviest fish of every species on the server in the journal.
  • In-game location tool (/fishlocations): place markets, boat docks and fishing zones on a sea chart, saved and live at once, no restart. Admin commands for level, xp, upgrades and items.
  • Poaching and police: protected species (sea turtle, dusky grouper, great white shark) bite only in marine reserves while police are on duty, sell only to a hidden black market buyer, and can trigger a dispatch alert (ps-dispatch, cd_dispatch, rcore_dispatch, core_dispatch, your own, or a built-in alert). Police inspect a player's catch, confiscate protected fish and fine them.
  • Fishing crews: invite nearby players (up to 4). Fishing close together bites faster and gives more XP; the crew gets shared goals with a reward for everyone who landed a fish. /fishcrew opens the crew panel.
  • One market panel (sell, prices, tackle shop, upgrades, orders, journal, tournament, top anglers, achievements), a fishing HUD with event and tournament chips, English and Turkish.
  • ox_inventory metadata for weight and stars; qb-core / ESX inventories supported with average values.

Requirements

  • oxmysql
  • Qbox (recommended), QBCore, ESX legacy or standalone
  • An inventory: ox_inventory (recommended) or the framework inventory
  • Optional: ox_lib, ox_target / qb-target, qbx_vehiclekeys / qb-vehiclekeys, ox_fuel / LegacyFuel / cdn-fuel / ps-fuel, ps-dispatch / cd_dispatch / rcore_dispatch / core_dispatch

Quick start

ensure oxmysql
ensure ox_lib
ensure ox_inventory
ensure ns-fishing
add_ace group.admin ns-fishing.admin allow

Register the items (fishinstall in the server console does it for you), then check the example coordinates. See INSTALLATION.md and CONFIGURATION.md.

How to fish

  1. Buy a rod and bait at a fish market (or get them any other way).
  2. Use the rod (or type /fish) while facing water inside a fishing zone.
  3. E casts. When the float dips, press E again quickly.
  4. Hold click or space to keep the green bar on the fish until the meter on the right is full.
  5. G changes bait, X stops fishing. Sell the catch at the market.

Fishing with friends: look at another player and choose Invite to fishing crew (or /fishcrew invite next to them). Police: Inspect catch on a player (or /fishinspect next to them).

Cart

Your cart is empty.