FishMating

Welcome to FishMating, a feature-rich and immersive Minecraft plugin crafted for version 1.21.3+ and beyond! Written with care using the latest Bukkit/Paper APIs, this plugin transforms your oceans, rivers, and lakes into living, breathing ecosystems where fish can breed dynamically — just like land animals, but with a unique aquatic twist!

With FishMating, your players can interact with marine life in a whole new way: by simply tossing specific seeds into the water, they’ll attract nearby fish of matching types. Curious salmon, cod, pufferfish, and tropical fish will detect the seeds within a 5-block radius and gracefully swim toward them. Upon reaching the seeds, each fish takes one seed and becomes breeding-ready, shown with charming heart particles . If two breeding-ready fish find each other within 30 seconds, they pair up just like in vanilla Minecraft animal breeding, spawning an adorable baby fish to join the aquatic family!

But that’s just the start! The plugin is deeply customizable thanks to the powerful config.yml:

Fully adjustable settings:

• Change detection radius
• Customize breeding cooldowns and readiness time
• Enable or disable particle effects and control their amount
• Define which seeds attract which fish types
• Fine-tune advanced settings like natural growth, debug logging, and maximum tracked fish limits

Everything is built with performance and stability in mind. FishMating handles edge cases gracefully — from fish dying mid-breeding, seeds despawning, or large-scale aquatic events — all while keeping your server console clean and error-free . Thanks to the breeding-success-rate setting, you can even add a touch of unpredictability to make breeding feel natural and dynamic.

Key features:

• Supports Minecraft 1.21.3+ using the newest Bukkit/Paper APIs
• Attract fish with seeds: salmon with wheat seeds, cod with pumpkin seeds, pufferfish with melon seeds, tropical fish with beetroot seeds
• Heart particles show breeding readiness, creating an immersive visual experience
• Baby fish spawn naturally after successful breeding
• Everything is configurable: detection radius, timeouts, particles, and more!
• Advanced debug logging and tracking controls for large servers
• Clear JavaDocs, structured multi-class design, and clean plugin.yml/config.yml for maintainability

Whether you’re running a survival server, roleplay world, or custom adventure map, FishMating makes your aquatic biomes feel alive, dynamic, and magical . Bring more depth and fun to your oceans, reward players for creative interaction, and watch your underwater world flourish like never before!