Fishing Features
Custom Fish — Create unlimited species with unique skulls, stats, prices, weights, and lore. Each fish is defined in YAML and fully yours to customize. Set display names, rarity tiers, HeadDatabase skull IDs, sell prices, weight ranges, XP rewards, and multi-line lore. You can also attach commands and fireworks to specific catches.
Custom Rods — Configurable fishing rods with luck, XP boosts, double catch odds, sell bonuses, and enhanced bite mechanics. Each rod is its own item with custom stats that players can earn, buy, or be given through commands.
Bait System — Different baits that boost your odds on a timer. Each bait can filter by rarity, set time limits, and follow stacking rules. Players apply bait to their rod and the effect runs until it expires.
Mini Game — Timing based catch challenge that triggers on certain fish. A boss bar appears with a shrinking window and the player has to hit it at the right time. Configurable per rarity or per fish.
Spawn Conditions — Lock fish behind biomes, worlds, weather, time of day, Y-level, WorldGuard regions, or permissions. Combine multiple conditions on a single fish to build out a real ecosystem where location and timing matter.
Tackle Box — Virtual fish storage with a craftable item. Players can stash fish in their tackle box to free up inventory space and access it anytime through the GUI.
Leveling & Progression
Reel Skill — Level up as you catch. XP scales with fish rarity, rod perks, and active boosters. Progression follows a polynomial curve so early levels come quick and later levels take real effort. Max level is 500 by default but fully configurable.
Logbook — Track every species, your biggest catch, total count, and more. Undiscovered fish show as question marks until the player catches one for the first time, which triggers a discovery entry. Paginated GUI with detailed per-fish views.
Boosters — Stack multipliers for sell price, XP, rare chance, and minigame time. Multiple types can run at once. Boosters can be activated server-wide or through the admin panel, and they combine with rod perks and rarity multipliers.
Deliveries — Daily and weekly fishing quests with custom rewards. Players are asked to turn in specific fish and progress tracks automatically as they catch. Rewards can be money, XP, or commands.
Seasons — Rotating seasonal events with bonus fish pools, XP multipliers, and exclusive catches. Seasons cycle automatically on a schedule and can introduce fish that are only available during that period.
Skill Tree — Earn 1 skill point every level and spend them across 4 independent branches: XP Bonus (Mastery), Rare Fish Chance (Luck), Sell Price Bonus (Commerce), and Double Catch Chance (Endurance). Each branch has 5 progressive nodes with a level-gated capstone. Access via the Reel Skill menu or the /fish skills command.
Competitions
Tournaments — 4 competitive modes with placement rewards and eligible fish filters. Fishing Frenzy (most caught), Big Catch (heaviest single fish), Species Hunt (most unique species), and Treasure Haul (highest total value). Live boss bar leaderboard runs during the event. Scores persist across restarts. Can run on automatic rotation or be started manually.
Anti AFK — Built in protection against AFK fishing. Reduces odds or blocks repeated casts from the same spot. Configurable thresholds so you can decide how strict it is.
Leaderboards — 5 stat categories covering online and offline players. Always up to date. Accessible through a paginated in-game GUI.
Announcements — Customizable broadcasts for rare catches. Set per rarity tier or per individual fish. When a player lands something rare the server gets a message about it.
Admin Control Panel
Full in-game GUI to edit, create, and manage the plugin without touching config files.
Create Fish — Step by step fish creation wizard. Set the name, skull, rarity, stats, and conditions all from the GUI.
Edit Fish — Modify any existing fish. Change stats, rarity, skull, and conditions on the fly.
Tournament GUI — Start, stop, and view active tournaments. See live scores and manage rewards.
Booster GUI — Activate and manage server-wide boosters from a single menu.
Settings GUI — Toggle core plugin settings on the fly without needing a reload.
Booster Presets — Save full booster configurations and reuse them anytime.
Treasure Blacklist — Control what vanilla treasure loot can drop alongside custom fish.
Bulk Delete — Select and remove multiple fish definitions at once.
Recipe Login — Configure craftable plugin items directly in-game.
Log Stats — View catch data and debug info.
Skill Admin — Force-unlock or lock any skill node per player. Set, add, or remove skill points from a GUI or command — no config edits needed.
Player Stats — Verbose stat view per player: live skill-effect multipliers, catch history, tournament record, and active boosters — all pulled from the engine, not from cached fields.
Everything is also editable through YAML if you prefer working in config files.
Commands
| Command | Description |
|---|---|
| /fish | Main menu |
| /fish shop | Dock Market |
| /fish codex | Logbook |
| /fish stats | Reel Skill level and XP |
| /fish tournament | Active tournaments |
| /fish bag | Tackle box |
| /fish deliveries | Daily and weekly quests |
| /fish top | Leaderboards |
| /fish sellall | Sell all fish in inventory |
| /fish sellhand | Sell the fish in your hand |
| /fish bait | Check or activate bait |
| /fish skills | Skill tree browser |
| /fish help | Command list |
| Admin Command | Description |
| /fishadmin create | Fish creation wizard |
| /fishadmin edit | Edit fish in-game |
| /fishadmin delete | Delete a fish definition |
| /fishadmin list | List all fish |
| /fishadmin info | View fish details |
| /fishadmin give | Give fish to a player |
| /fishadmin giverod | Give a custom rod to a player |
| /fishadmin givebait | Give bait to a player |
| /fishadmin givexp | Give XP to a player |
| /fishadmin setlevel | Set a player's level |
| /fishadmin resetstats | Reset a player's stats |
| /fishadmin resetall | Reset all player data |
| /fishadmin reload | Reload all configs |
| /fishadmin debug | Debug a player's catch context |
| /fishadmin tournament | Start, stop, or manage tournaments |
| /fishadmin booster | Manage server-wide boosters |
| /fishadmin season | Show current season info |
| /fishadmin schedule | Show tournament schedule |
| /fishadmin placeholders | List all PAPI placeholders |
| /fishadmin skillpoints | Set, add, or remove skill points |
| /fishadmin skillunlock | Force-unlock a skill node |
| /fishadmin skilllock | Force-lock a skill node |
| /fishadmin skillreset | Reset all skill nodes and points |
| /fishadmin skilledit | Open per-player skill manager GUI |
| /fishadmin stats | View verbose live stats for a player |
| /fishadmin help | Admin command list |
Aliases: /rh, /reelheads
Placeholders
Requires PlaceholderAPI. Identifier: reelheads
Placeholders
Requires PlaceholderAPI. Identifier: reelheads
| Placeholder | Returns |
|---|---|
| Player Stats | |
| %reelheads_level% | Fishing level |
| %reelheads_xp_current% | Current XP |
| %reelheads_xp_required% | XP needed for next level |
| %reelheads_xp_progress% | XP progress percentage |
| %reelheads_xp_bar% | Visual XP progress bar |
| %reelheads_total_caught% | Total fish caught |
| %reelheads_unlocked_count% | Unique fish unlocked |
| %reelheads_total_fish% | Total fish types in registry |
| %reelheads_codex_percent% | Logbook completion % |
| %reelheads_top_value_fish% | Most valuable catch name |
| %reelheads_top_value_amount% | Most valuable catch amount |
| %reelheads_total_sold% | Total money earned from selling |
| Tournaments | |
| %reelheads_tournaments_entered% | Tournaments entered |
| %reelheads_tournaments_won% | Tournaments won |
| %reelheads_tournament_top_three% | Top-3 finishes |
| %reelheads_tournament_win_rate% | Win rate % |
| %reelheads_tournament_active% | Active tournament name |
| %reelheads_tournament_active_type% | Active tournament type |
| %reelheads_tournament_active_id% | Active tournament ID |
| %reelheads_tournament_time_left% | Time remaining |
| %reelheads_tournament_time_left_seconds% | Seconds remaining |
| %reelheads_tournament_participants% | Participant count |
| %reelheads_tournament_is_active% | true/false |
| %reelheads_tournament_rank% | Your rank in tournament |
| %reelheads_tournament_score% | Your tournament score |
| %reelheads_tournament_catches% | Your tournament catches |
| %reelheads_tournament_top_1_name% | 1st place name |
| %reelheads_tournament_top_1_score% | 1st place score |
| %reelheads_tournament_next_time% | Time until next tournament |
| %reelheads_tournament_next_name% | Next tournament template |
| Boosters | |
| %reelheads_booster_sell_active% | Sell booster active (true/false) |
| %reelheads_booster_sell_multiplier% | Current sell multiplier |
| %reelheads_booster_sell_time% | Sell booster time remaining |
| %reelheads_booster_xp_active% | XP booster active (true/false) |
| %reelheads_booster_xp_multiplier% | Current XP multiplier |
| %reelheads_booster_xp_time% | XP booster time remaining |
| Seasons | |
| %reelheads_season% | Active season name |
| %reelheads_season_id% | Active season ID |
| %reelheads_season_xp_multiplier% | Season XP multiplier |
| Dynamic (per-fish) | |
| %reelheads_caught_<fish-id>% | Times caught a specific fish |
| %reelheads_has_caught_<fish-id>% | Has caught (true/false) |
| %reelheads_can_catch_<fish-id>% | Can catch (permission check) |
| %reelheads_fish_name_<fish-id>% | Fish display name |
| %reelheads_fish_rarity_<fish-id>% | Fish rarity tier |
| Skill Tree | |
| %reelheads_skill_points% | Available skill points |
| %reelheads_skill_unlocked% | Total nodes unlocked |
| %reelheads_skill_xp_bonus% | Current XP bonus % |
| %reelheads_skill_luck_bonus% | Current luck weight bonus % |
| %reelheads_skill_sell_bonus% | Current sell price bonus % |
| %reelheads_skill_double_catch% | Current double-catch chance % |
| Leaderboards | |
| %reelheads_top_<cat>_<rank>_name% | Leaderboard player name |
| %reelheads_top_<cat>_<rank>_value% | Leaderboard player value |
| %reelheads_rank_<category>% | Your rank in category |
Requirements
- Paper 1.21+
- Java 21
- HeadDatabase (optional) (recommended)
- Vault + economy plugin (required)
- PlaceholderAPI (optional) (recommended)
- WorldGuard (optional)
Storage: YAML, SQLite, or MySQL.
Latest reviews
- SuperSaussage
- Version: v1.0
A refreshing fishing plugin with a ton of amazing features, This plugin allows for so much customization and the ability to do it easily allows me to implement refreshing additions for all my players who enjoy fishing. The simple and yet in-depth configs allowed me to setup tournaments and prize pools for my players, as well as the custom fishing rods my players unlock as they progress in their own fish level system. This plugin and the developer both get a 10/10 from me!
