Reimagined Fishing Framework — v1.0.0

Initial Release

---

🚀 What's included in this release

Global Goals System

• Server-wide community progression chain with 5 configurable stages
• Progress persists permanently across restarts
• Stage completion rewards: broadcast, title, sounds, fireworks, console commands
• Live /goals GUI with progress bars and estimated completion
• Admin commands: reload, reset, force-complete
• Vault economy integration — tracks server-wide money earned automatically
• Developer API with GoalCompleteEvent

Custom Fishing Profession

• Fully custom fishing loop — no vanilla fishing rewards
• Cast into water only — ground and lava blocked automatically
• Random bite timer (10–20s) with unpredictable jitter so players can't predict timing
• Right-click reaction window to reel in — not AFK fishable
• Miss the window — fish escapes, cast again

15 Unique Fish

• 6 rarities: Common → Uncommon → Rare → Epic → Legendary → Mythic
• Weighted probability system
• Fully configurable in fish.yml — add unlimited custom fish

Rod Upgrade System

• 4 upgradeable stats: Luck, Speed, Focus, Quantity
• Rod visually upgrades as you level it:
  • Plain rod → Upgraded → Advanced → Expert → Master
  • Glowing enchantment effect on upgraded rods
• All costs configurable in fishing.yml

Shard Currency

• Secondary currency earned from every catch
• Spent on rod upgrades
• /shards command + %fishing_shards% placeholder

XP & Level System

• Configurable XP formula
• No level cap
• Milestone rewards at configurable levels

Collection Log

• Track every unique fish discovered
• Milestone rewards at 25%, 50%, 75%, 100% completion
• Paginated GUI

Statistics

• Total fish, XP, shards, money earned, sessions, time fishing, highest value fish, rarest fish

Leaderboards

• Top 10 per category: Fish Caught, XP, Shards, Money Earned
• Cached every 60s — never queries DB from PlaceholderAPI

Sell System

• Sell All from inventory
• Auto-Sell toggle — fish sold instantly on catch

Database

• SQLite (default, zero setup) and MySQL support
• Fully async — zero main thread blocking

PlaceholderAPI

• %fishing_level% %fishing_xp% %fishing_shards%
• %fishing_total_fish% %fishing_collection% %fishing_rank%

---

⚙️ How to get started

1. Install

Drop ReimaginedFishing-1.0.0.jar into your /plugins/ folder. Also install Vault and an economy plugin (EssentialsX recommended). Restart your server.

2. Config files are auto-generated

No manual setup required. All files generate on first run:

• config.yml — database settings
• goals.yml — your progression chain
• fishing.yml — all fishing settings
• fish.yml — fish definitions

3. Set your goals

Open goals.yml and set realistic targets for your player count. Default Stage 1 target is $10,000,000 server-wide. For a 10-player server, consider lowering this to $500,000 for the first week.

4. Players start earning money

Any economy source works — jobs, shops, quests, manual /eco give. The plugin tracks Vault balance deltas automatically.

5. Stage 1 completes → Fishing unlocks

Server-wide broadcast fires. Every online player sees the title screen. Players can now cast a fishing rod into water and start fishing.

6. Players fish → Stage 2 fills up

Every fish caught contributes to the Stage 2 goal (500,000 fish server-wide).

---

🔧 Admin quick reference

/goals              — Open goals GUI (or text summary from console)
/goals skip         — Force-complete the current active stage (for testing)
/goals reset all confirm  — Wipe all progress and start over
/goals reload       — Reload goals.yml without restarting

/fishing admin giveshards <amount>  — Give yourself shards for testing
/fishing admin givexp <amount>      — Give yourself fishing XP
/fishing admin setlevel <level>     — Set your fishing level

---

⚠️ Known limitations in this release

• Stages 3–5 (Spawners, Mob Tokens, Bosses, KOTH) are config placeholders — they show in the GUI but won't fill up until those systems are built in future updates
• Lava fishing coming in v2.0
• Biome-based fish pools coming in a future update

---

🗺️ What's coming next

• v2.0 — Lava fishing, Fire Rod upgrade, Creeper Eggs
• v2.1 — Biome-based fish pools
• v3.0 — Spawner system integration

---

Built by PluginMC