FishMarket is a dynamic fish trading economy plugin designed to add depth and excitement to your server’s economy. With immersive features like a time-based market calendar, custom merchant NPCs, and fluctuating fish prices, FishMarket turns fishing into a rewarding and competitive activity for all players.



Overview:
FishMarket creates a full-featured fish trading system centered around bucket-caught fish. Players can sell their fish, tropical fish, and axolotls to unique Fish Merchant villagers. The prices aren’t static: they change based on fish rarity and on special calendar events, meaning the value of your catch can rise or fall depending on when and what you sell.




Key Features:

• Sell fish buckets directly to merchants, with configurable min and max prices for every fish type.
  
  
• Prices are influenced by both rarity (for example, blue axolotls are extremely valuable) and the in-game day, with time-based multipliers.
  
  
• A 27-day in-game market cycle with special events, like double price days, rare fish bonuses, and even market crashes that temporarily drop prices.
  
  
• All players have access to a visual calendar GUI to check upcoming events and plan their fishing strategies. Server owners can create custom event templates and market cycles for endless replayability.
  
  
• Special merchant villagers (Fish Merchants) are protected from damage, persist after restarts, and display fun particle effects when trades succeed.
  
  
• Track personal and server-wide fishing statistics, earnings, and milestones. Multiple leaderboards cover everything from total earnings to rare fish sold and averages, with milestone announcements for big achievements.
  
  
• Players get a personal statistics GUI to track their fishing history and daily earnings.
  
  
• Flexible storage options include out-of-the-box YAML (no setup) and optional MySQL support for larger or multi-server setups, with simple data migration between the two.
  
  
• Quality-of-life features like detailed transaction logs, daily earnings summaries, fully customizable plugin messages, and convenient tab completion on all commands.
  
  
  
• 
  
  
• 
  

Commands and Permissions:
FishMarket includes a full suite of easy-to-use commands for players and admins. Players can open the main help menu, check daily earnings, view their stats, open the leaderboard or calendar GUIs, and check their current discounts. Admins can spawn, remove, and list merchants, reload the configuration, migrate storage, and manage the calendar. Permission nodes are clearly defined.

Supported Fish Types:
FishMarket supports all bucket-caught fish, including cod, salmon, pufferfish, and every axolotl variant. All 22 named tropical fish patterns are included, each with unique pricing, so no two tropical fish are valued the same.



Configuration:
Every major aspect of the plugin is highly configurable, from price ranges and day/night multipliers, to merchant settings and particle effects. Market calendar events can be created and customized, with adjustable multipliers, durations, and specific fish bonuses. Storage is simple to switch between YAML and MySQL.

Requirements:
FishMarket requires Minecraft 1.21 or higher, Java 17+, and depends on Vault and Essentials for full functionality.

Getting Started:
Simply install Vault and Essentials, place FishMarket.jar in your plugins folder, and restart your server. Spawn your first merchant with a simple command and let your players dive into a vibrant fish trading market.

Tips for Players:
Keep an eye on the calendar for profitable event days, save rare fish for special occasions, monitor the leaderboard for some friendly competition, and remember that selling in bulk can maximize your profits.

For Server Owners:
FishMarket is optimized for performance, supports async operations, and is designed to fit both small and large server communities. All messages, prices, and market settings can be tweaked to fit your server’s vision.

Support:
If you have any issues or suggestions, please join our discussion on the Spigot forums – we’re happy to help!

FishMarket – making fishing profitable and fun for everyone!