Reimagined Fishing Framework

A custom fishing framework plugin for Paper/Purpur 1.21+

🌊 What is this plugin?

Reimagined Fishing Framework transforms your server's fishing into a complete profession system that ties it into a server-wide community progression chain that keeps players engaged for months, not days.

The entire server works together to hit shared milestones. Each milestone permanently unlocks the next layer of gameplay. Nothing is handed out — the community earns it together.

Server launches with everything locked
        ↓
Everyone earns money together → $10,000,000 → Fishing Unlocks
        ↓
Everyone fishes together → 500,000 fish → Spawners Unlock
        ↓
And so on...

---

✅ Verified Working

Tested and verified on Paper 26.1.2 / Minecraft 26.1.2 with Java 25. Compatible with Paper & Purpur 1.21+.

---

🎯 Global Goals System

The backbone of everything. The whole server works toward shared milestones.

• Ordered, config-driven stages — define as many stages as you want in goals.yml
• Progress persists permanently — survives restarts, never auto-resets
• Stage completion rewards:
  • Server-wide broadcast
  • Title & subtitle shown to every online player
  • Sounds & fireworks
  • Custom console commands
• Live GUI — progress bars, percentages, estimated completion time
• Admin commands — reload, reset, force-complete stages
• API — other plugins can hook into goal completion events
• Vault integration — tracks server-wide money earned automatically

---

🎣 Custom Fishing Profession

Fishing feels like a real profession, not a vanilla afterthought.

How it works

1. Pick up a fishing rod and cast it into water (ground and lava are blocked)
2. Wait for a random bite timer (10–20 seconds, reduced by Speed upgrades)
3. When the fish bites — ActionBar + BossBar alert + sound
4. Right-click to reel in within the reaction window
5. Miss the window — fish escapes, cast again

No AFK fishing. You must actively react to every bite.

Fish Rarities

Rarity	Color	Example Fish
Common	⬜ White	Carp, Bluegill, Catfish, Bass
Uncommon	🟩 Green	Perch, Trout, Crappie
Rare	🟦 Blue	Striped Bass, Rainbow Trout, Pike
Epic	🟪 Purple	Blue Marlin, Swordfish
Legendary	🟨 Gold	Golden Koi, Silver Dragon Fish
Mythic	💜 Pink	Ancient Leviathan

15 unique fish with configurable weights, values, XP and shard rewards. Add unlimited custom fish via fish.yml — no code required.

Virtual Rod System

• Rod upgrades stored in the database — no item duplication exploits
• Physical rod in hand updates visually as you upgrade:
  • No upgrades: plain Fishing Rod
  • 1–9 levels: glowing Upgraded Rod
  • 10–19 levels: glowing Advanced Rod
  • 20–29 levels: glowing Expert Rod
  • 30–35 levels: glowing Master Rod

---

⚙️ Rod Upgrade System

Spend Shards (fishing currency) to upgrade your rod stats:

Stat	Effect	Max Level
Luck	Improves rare fish chances	10
Speed	Reduces bite timer	10
Focus	Increases reaction window	10
Quantity	Chance for bonus fish per catch	5

All costs and formulas configurable in fishing.yml.

---

💎 Shard System

Secondary fishing currency earned from every catch.

• Spent on rod stat upgrades
• Bonus shards from level milestones and collection rewards
• /shards command shows balance
• %fishing_shards% PlaceholderAPI support

---

📈 XP & Level System

Every catch grants XP toward your Fishing Level.

• Configurable XP formula (base × level ^ exponent)
• No level cap
• Milestone rewards at configured levels (shards, messages, commands)
• Default milestones: Level 5, 10, 20, 50

---

📖 Collection Log

Track every unique fish you discover.

• Discovered fish show as real items with lore
• Undiscovered fish show as ???
• Paginated GUI supports unlimited fish
• Milestone rewards at 25%, 50%, 75%, 100% completion
• %fishing_collection% PlaceholderAPI support

---

📊 Statistics

Tracked per player, stored in database:

• Total fish caught
• Total XP earned
• Total shards earned
• Money earned from fishing
• Fishing sessions
• Time spent fishing
• Highest value fish
• Rarest fish caught

---

🏆 Leaderboards

Top 10 per category:

• Fish Caught
• XP
• Shards
• Money Earned

Performance note: Leaderboard cache rebuilds every 60 seconds (configurable). PlaceholderAPI never queries the database directly — reads from cache only. Safe for large servers.

---

💰 Sell System

• Sell All — sells every fish in your inventory at once
• Auto-Sell — fish sold instantly on catch, never go to inventory
• Both paths deposit via Vault and update money stats

---

🗃️ Database Support

Type	Support
SQLite	✅ Default, zero setup
MySQL	✅ Configure in config.yml

All database operations are fully asynchronous — zero main thread blocking. Schema auto-created on first run. No manual SQL required.

---

📡 PlaceholderAPI

Placeholder	Returns
%fishing_level%	Current rod level
%fishing_xp%	Current XP toward next level
%fishing_shards%	Shard balance
%fishing_total_fish%	Lifetime fish caught
%fishing_collection%	Collection completion %
%fishing_rank%	Leaderboard rank (cached)

---

🔧 Soft Dependencies

Plugin	Purpose
Vault	Economy integration (required for money goal & selling)
PlaceholderAPI	Placeholders (optional)
LuckPerms	Permission management (optional)

---

📋 Commands

Command	Permission	Description
/goals	communityprogression.goals	Open goals GUI
/goals reload	communityprogression.admin	Reload goals.yml
/goals reset <id|all> confirm	communityprogression.admin	Reset stage progress
/goals skip	communityprogression.admin	Force-complete active stage
/fishing	communityprogression.fishing	Open fishing menu
/fishing stats	communityprogression.fishing	View statistics
/fishing collection	communityprogression.fishing	View collection log
/fishing top	communityprogression.fishing	View leaderboards
/fishing admin givexp <amount>	communityprogression.fishing.admin	Give fishing XP
/fishing admin giveshards <amount>	communityprogression.fishing.admin	Give shards
/fishing admin setlevel <level>	communityprogression.fishing.admin	Set fishing level
/shards	communityprogression.fishing	View shard balance

---

⚡ Installation

1. Download the jar
2. Drop it into your /plugins/ folder
3. Install Vault + an economy plugin (EssentialsX recommended)
4. Restart your server
5. All config files generate automatically — no manual setup required

Requirements:

• Paper or Purpur 1.21+
• Java 21+
• Vault (for economy features)

---

⚙️ Configuration

Three main config files, all fully documented with inline comments:

• config.yml — database settings, economy tracking mode
• goals.yml — define your progression chain (add/remove/reorder stages freely)
• fishing.yml — all fishing settings, bite timers, rod costs, XP formula, messages
• fish.yml — define unlimited custom fish with any rarity, value, and weight

---

🛠️ Developer API

// Feed progress to any goal type from your own plugin
CommunityProgressionAPI.addProgress("fish_caught", 1);

// Check if a stage is complete
CommunityProgressionAPI.isStageComplete("stage_1_money");

// Get the currently active stage
CommunityProgressionAPI.getActiveStage();

// Listen to goal completions
@EventHandler
public void onGoalComplete(GoalCompleteEvent event) {
    GoalStage stage = event.stage();
}

---

💬 Support

• Website: pluginagentmc.com
• Issues: Contact via website or leave a comment on this page

---

🗺️ Roadmap

• Lava Fishing system (creeper eggs, fire rod)
• Biome-based fish pools
• Spawner system integration
• Goals PlaceholderAPI expansion

---

Built with ❤️ by PluginMC