ВЕРСИИ (1)

# 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](https://pluginagentmc.com/)*