> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apex-services.site/llms.txt
> Use this file to discover all available pages before exploring further.

# APEX Fishing

> Level-based fishing with 5 rod tiers, illegal shark zone, and case drops.

A level-based fishing system with legal and illegal zones, 5 fishing rod tiers, level-gated fish groups (trash through legendary), illegal shark fishing on boats with bait items, booster drops, and a sell NPC with blip. Server-rate-limited end-to-end.

## Features

* 5 rod tiers — miss chance and double-fish chance scale per tier
* 10 level-gated fish groups — trash, common (low/mid/high), uncommon (4 tiers), rare, legendary
* Illegal shark zone — requires bait item, min level 25, 8 catches per bait
* Case drops — 0.5% chance per catch, 4 case types (fischen, haustier, normales, weekly)
* Booster items — 10-min and 1-hour boosters that halve reward wait
* Anti-cheat rate limiting — moving averages across last 5 catches, per-zone thresholds
* Sell NPC with proximity-spawned ped and blip

## Requirements

<Card title="Required" icon="circle-check">
  `es_extended`, `ox_lib`
</Card>

## Installation

1. Drop `apex-fishing` into `resources/`
2. Add fishing rod / fish / bait / case items to your inventory
3. `ensure apex-fishing`

## Configuration

```lua config.lua theme={null}
Config.FishingRods           = { 'fishingrod1', 'fishingrod2', 'fishingrod3', 'fishingrod4', 'fishingrod5' }
Config.MissChances           = { [1]=0.20, [2]=0.15, [3]=0.10, [4]=0.05, [5]=0.02 }
Config.DoubleFishChances     = { [1]=0.0,  [2]=0.05, [3]=0.10, [4]=0.15, [5]=0.20 }
Config.CaseDropChance        = 0.005
Config.CatchingCooldownMs    = 15000
Config.IllegalMinLevel       = 25
Config.IllegalCatchesPerBait = 8
```

Ships with 2 zones (pier + illegal dock), 100+ fish items across 10 level groups, and tunable per-zone server rate limits.

## Hooks

See [Hooks reference / Fishing](/hooks/apex-fishing). Key hooks: `Hooks.GetPlayerLevel`, `Hooks.HasFishingBoost`, `Hooks.OnCatch`, `Hooks.OpenFishmarket`, ox\_inventory bridge.

## Resource info

<Note>
  Code accessible: `config.lua`, `hooks.lua`, `locales/*`. Approximately 1600 lines of Lua. English + German.
</Note>