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

Reimagined Fishing Framework

Reimagined Fishing Framework 1.0.0

Список изменений