Usage
How to fish
- Equip a fishing rod from your inventory.
- Stand near water and face it - the resource checks that water is in front of you.
- Use the rod item to cast your line.
- Wait for a bite, then interact to reel in.
By default, players can only fish inside designated fishing zones. Set AllowFishingOutsideZones = true in configs/zones.lua to allow fishing anywhere near water with reduced loot (common and uncommon only). Toggle zone blips at the Fishery NPC to find them on the map.
Zones
There are two zone types, each requiring a different bait:
| Zone type | Required bait | Notable catches |
|---|---|---|
| Freshwater | fishing_bait_worm | Bullhead, Carp, Catfish, Perch, Rainbow Trout, Northern Pike, Jellyfish |
| Saltwater | fishing_bait_lugworm | Croaker, Flounder, Sardine, Salmon, Tuna, Barracuda, Coral Grouper, Jellyfish |
Zones on the map
Fishing zone blips can be toggled from the Fishery NPC (Selling Station).
Catch rates
Weighted catch probability within a designated zone:
| Rarity | Freshwater | Saltwater |
|---|---|---|
| Common | ~70% | ~76% |
| Uncommon | ~20% | ~20% |
| Rare | ~9% | ~3% |
| Very Rare | ~1% | ~0.9% |
| Treasure (case) | ~0.1% | ~0.1% |
Outside a zone the pool is limited to common and uncommon only.
Fishing rods
Higher-tier rods increase the weight of fish caught (heavier = higher sell price) and last longer before breaking.
| Rod | Rarity | Weight mod | Durability loss/cast | Shop price |
|---|---|---|---|---|
| Basic | Uncommon | ×0.8 | 1% | $100 |
| Sport | Rare | ×1.0 | 0.5% | $200 |
| Professional | Epic | ×1.2 | 0.2% | $550 |
| Aqua | Epic | ×1.5 | 0.15% | $750 |
| Golden | Legendary | ×1.5 | 0.1% | $1,000 |
| Prodigy / Sunset | Epic | ×1.4 / ×1.5 | 0.15% | Tournament/challenge reward |
Trash loot
Alongside fish, you can occasionally reel in trash items such as a fishing boot or a plastic cup. Using a fishing boot from your inventory opens a random loot roll:
| Item | Chance | Amount |
|---|---|---|
| Scrapmetal | 35% | 1–2 |
| Rubber | 20% | 1–3 |
| Gold Coins | 15% | 3–7 |
| Ring | 10% | 2–5 |
Selling
Bring caught fish to a Selling Station and interact with the NPC to sell. Price is calculated from the fish's base value multiplied by its actual weight.
Daily challenges
Three challenges are generated each day. Challenge types:
| Type | Description |
|---|---|
| Catch X amount | Catch a total of X fish |
| Catch X of a species | Catch X fish of a specific species |
| Catch X kg | Catch fish totalling X kg |
Completing a daily challenge pays a cash reward ($250–$1,500 depending on difficulty). Progress and rewards are tracked at the Fishing Profile Board NPC.
Weekly & monthly rewards
The top fishers over a week or month earn prizes delivered to their personal winnings stash:
| Period | Top prize |
|---|---|
| Weekly | Golden fishing rod + $2,000 cash |
| Monthly | Trophy + Golden fishing rod + $5,000 cash |
Configuration
configs/zones.lua
Each zone entry follows this structure:
{
name = "Zone Name",
coords = vector3(x, y, z), -- centre of the zone
radius = 150.0, -- zone radius in metres
bait = "fishing_bait_worm",
loot = FreshwaterLoot, -- or SaltwaterLoot
zone = "Freshwater", -- or "Saltwater"
}configs/loot.lua
Key variables:
| Variable | Description |
|---|---|
FishingLoot | All fish species with weight range, model and base price |
FishingLootTables | Fish assigned to rarity tiers per zone type |
FreshwaterLoot / SaltwaterLoot | Weighted rarity chances per zone type |
Prices | Sell price per rarity tier per zone type |
configs/fishing_rods.lua
Each rod entry:
rod_item_name = {
weight = 1.0, -- catch weight multiplier
consume = 0.005, -- durability lost per cast (1.0 = fully broken)
price = 200, -- shop price (omit for non-purchasable rods)
rarity = "RARE",
model = `pr_fishingrod_03`,
}configs/challenges.lua
| Variable | Description |
|---|---|
DailyChallenges | Number of daily challenges generated (default: 3) |
Challenges | Challenge types with step amounts and cash rewards |
Rewards.weekly / Rewards.monthly | Item + cash reward pool for tournament winners |
configs/stations.lua
| Variable | Description |
|---|---|
SellingStations | List of selling station locations and headings |
FishingProfileNPC | Position and blip settings for the profile board NPC |