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

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:

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

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

📡 PlaceholderAPI

🔧 Soft Dependencies

📋 Commands

⚡ 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