⚓ UltimateFishing
An immersive, feature-rich fishing experience for Paper 1.21.8

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Overview

UltimateFishing transforms vanilla fishing into a full progression system. Reel in 50+ unique fish
across 6 rarity grades, master the tension-based Dredge mini-game, invest skill points, and unlock titles as you level
up to 200.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Features

Mini-Game

• BossBar tension gauge — reel in and release to keep the fish on the line
  
• 6 fishing rod tiers, each affecting game difficulty and catch bonuses
  
• Configurable safe tension range, timing, and tick rate
  

50+ Fish Species

• Common — Crucian Carp, Grass Carp, Sardine, Anchovy and more
  
• Uncommon — Bass, Trout, Eel, Piranha, Herring and more
  
• Rare — Tuna, Swordfish, Squid, Stingray and more
  
• Epic — Shark, Marlin, Bluefin Tuna, Zebra Shark and more
  
• Legendary — Whale, Orca, Whale Shark, Giant Squid and more
  
• Mythic — Otodus Megalodon
  

Level & Progression System (Lv 1–200)

• Catch fish to earn XP and level up
  
• 6 investable skill trees: Sell Price, XP Bonus, Fish Chance, Bait Speed, Reel Speed, Length Bonus
  
• 20 milestone titles unlocked every 10 levels — fully customizable colors with hex support
  
• Player profile GUI showing level, XP, stats, and skill breakdown
  

️ Universal Titles System

• Powered by UniversalTitles — a shared title layer for multi-plugin servers
  
• Chat prefix shows active title with custom color
  
• 54-slot GUI with category filters and multi-page navigation
  
• Support for &#RRGGBB hex color codes in title names
  

Biome-Based Fishing

• Fish species determined by hook location biome — not player location
  
• Full coverage: rivers, oceans, jungles, caves, Nether, End and all vanilla biomes
  
• Custom zone support via wood-hoe selection tool and /fish biome create
  

Economy Integration

• Vault-compatible sell GUI — drag and drop fish, see live total price before selling
  
• Fish price = base price + (length × price-per-cm)
  
• Legendary catch broadcasts (toggleable per player)
  
• Time-limited XP and sell price multiplier events via /fish event
  

Additional Features

• Personal fishing records with leaderboard paging
  
• Resource pack ready — full CustomModelData support (1.21.4+ string format)
  
• LuckPerms integration with permission fallback
  
• Per-fish time restrictions (ANY / DAY / NIGHT)
  

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Command	Permission	Description
/fish profile	ultimatefishing.use	Open your fishing profile
/fish skill	ultimatefishing.use	Open skill point panel
/fish sell	ultimatefishing.sell	Open fish sell GUI
/fish records	ultimatefishing.records	View personal catch records
/ut title	universaltitles.use	Open title selection GUI
/fish reload	ultimatefishing.admin	Reload all configs
/fish event ...	ultimatefishing.admin	Manage XP/sell multiplier events
/fish biome create	ultimatefishing.admin	Create custom fishing zone

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ Requirements

• Paper 1.21.x
  
• Java 17+
  
• Vault + economy plugin (e.g. EssentialsX)
  
• UniversalTitles (bundled / companion plugin) --- Need! otherwise cant use Title
  
• LuckPerms (optional, recommended)
  
• TAB
  

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Resource Pack
A companion resource pack with custom 3D fish models and fishing rod textures is available. Uses
1.21.4+ item definition format (pack_format 64).