?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings

Reimagined Fishing Framework

A low-cost premium fishing profession & community progression framework. Global goals, custom fish, rod upgrades, collection log, leaderboards, and more.

4downloads
0followers
4downloads
0followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Tags

Creators

Details

Licensed ARR
Published 15 hours ago
Updated 3 weeks ago

Reimagined Fishing Framework

A custom fishing framework plugin for Paper/Purpur 1.21+

fishing earning

🌊 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