AquaBreeder 1.5 - Big Achievements Update

This update adds a full achievement system to AquaBreeder, including vanilla-style achievement toasts, an achievement overview GUI, permanent discovery progress and one-time rewards.

New Achievement System

• Added a complete AquaBreeder achievement system.

• Achievements are saved permanently in SQLite.

• Players now receive a vanilla-style toast in the top-right corner when unlocking an achievement.

• Added achievement sound feedback.

• Added achievement rewards:

  • Money
  • Aqua Rod XP
  • Player XP

• Achievement reward messages are now grouped into one clean reward line to reduce chat spam.

• Added /ab achievements to open the achievement overview GUI.

• Added /ab achievementreset <player> for admins to reset achievement and discovery data for testing or support.

Achievement GUI

• Added a new achievement overview GUI.

• Players can see:

  • unlocked achievements
  • locked achievements
  • achievement tasks
  • rewards
  • progress for FishDex and collector achievements

• Locked achievements are shown as gray items.

• Unlocked achievements are shown with their real achievement icon.

• Added progress display for FishDex and category collector achievements.

New Achievements

Added multiple new achievements, including:

• First Catch
• FishDex I
• FishDex II
• FishDex III
• Starter Collector
• Medium Collector
• Rare Collector
• Very Rare Collector
• Endgame Collector
• First Very Rare Fish
• First Endgame Fish
• Legendary Catch
• Mythic Catch
• Perfect Catch
• Shiny Catch
• Breeding Begins
• Twin Luck
• Aquarium Starter
• Quest Angler
• Master Angler

Fish Discovery Progress

• Added a new permanent fish discovery system for achievements.
• Fish discoveries are saved independently from the current FishDex storage display.
• Once a fish species is discovered, it stays discovered for achievement progress.
• Selling, moving or removing a fish no longer removes achievement discovery progress.

Achievement Triggers

Achievements can now unlock through different AquaBreeder systems:

• Catching special fish
• Discovering new fish species
• Completing FishDex milestones
• Completing category collections
• Catching shiny, legendary, mythic or perfect fish
• Claiming breeding results
• Getting twins from breeding
• Adding a fish to the aquarium
• Completing quests
• Reaching Aqua Rod level 30

Improvements

• Reduced achievement chat spam by combining reward messages.
• Improved achievement message colors so they stand out from normal fishing messages.
• Added safer aquarium handling for achievement rewards.
• Aquarium fish storage now blocks stacked fish items.
• Aqua Rod XP from aquarium achievements is skipped if multiple Aqua Rods are detected.
• Aqua Rod level 30 achievement now also triggers correctly if the level is reached through achievement reward XP.

Admin / Testing

• Added /ab achievementreset <player>.

• This resets:

  • unlocked achievements
  • permanent fish discovery progress

• Useful for testing achievements again from zero.

Notes

This update focuses heavily on long-term progression and collection goals. Players now have more reasons to fish, breed, collect, complete quests and build up their aquarium over time.

Hotfix Description:

• This small hotfix improves the AquaBreeder update checker.

• AquaBreeder now only shows an update notification when the version found on Modrinth is actually newer than the installed server version.

• Previously, the checker could incorrectly show an older version as available if Modrinth returned that version first. For example, a server already running 1.4 could still receive an update notice for 1.3.

• This has been fixed. Servers running the latest version will no longer receive false update notifications.

AquaBreeder 1.4 - Quest System Update

This update adds the new personal Quest System to AquaBreeder. Players can now open their own quest menu, accept fishing quests, complete them with matching AquaBreeder fish and receive useful rewards for their progression.

New Quest System

• Added the new /ab quest command.
• Added a new Quest GUI with up to 7 personal quest offers.
• Quest offers are generated individually for each player.
• Only one quest can be active at the same time.
• Active quests can be cancelled with Shift + Right Click.
• Completed quest slots enter a cooldown before a new quest appears.
• Completed slots now show the remaining cooldown time in the tooltip.
• Quest slots automatically regenerate after their cooldown has expired.
• Added manual quest rerolling with cooldown.
• Reroll only affects available quests.
• Active quests are not rerolled.
• Completed cooldown slots are not rerolled.
• Added /ab open quest support for console, NPCs and menu plugins.

Fair Quest Generation

• Quest requirements are generated based on the player's Aqua Rod level.
• Low-level players only receive quests they can realistically complete.
• Higher-level players can receive harder quests with better rewards.
• The generator avoids unrealistic jackpot tasks, even for high-level rods.
• Quest requirements can include:
  • Specific fish species
  • Required rarity
  • Minimum quality percentage

Quest Rewards

• Added multiple quest reward types:
  • Money
  • Aqua Rod XP
  • Better fish
  • Breeding time reduction
• Money rewards now scale logically with rod level, fish category, rarity and quality.
• Money rewards are limited by the configured minimum and maximum values.
• Aqua Rod XP rewards now scale better for higher rod levels and harder quest requirements.
• Better fish rewards create a baby fish reward with improved quality and a chance for improved rarity.
• Breeding time reduction affects the longest active breeding slot.
• Breeding time reduction uses the configured percent and maximum minutes.

Quest Tracking Sidebar

• Added optional quest tracking sidebar.
• The sidebar only appears when:
  • The player has an active quest
  • Quest tracking is enabled
  • The player holds their own Aqua Rod
• The sidebar disappears automatically when the Aqua Rod is no longer held.
• The sidebar can be disabled or enabled in the Quest GUI.
• The sidebar is intentionally compact to avoid taking too much screen space.

Configuration

• Added new quest configuration section:

quests:
  enabled: true
  offered-quests: 7
  completed-slot-reset-minutes: 120
  reroll-cooldown-hours: 6

  rewards:
    money:
      min: 100.0
      max: 5000.0
      rod-level-scaling: true

    rod-xp:
      min: 100
      max: 2500

    breeding-time-reduction:
      percent: 0.15
      max-minutes: 25

• offered-quests is capped at 7 internally.
• completed-slot-reset-minutes controls how long completed quest slots stay on cooldown.
• reroll-cooldown-hours controls how often players can manually reroll available quests.
• Money reward values are only global limits. The actual reward is still calculated by quest difficulty.
• Most quest generation and balancing logic is intentionally handled internally and is not configurable to protect the economy balance.

Admin Commands

• Added /ab questclear

  • Clears a player's quest data.
  • Useful if a player's quest data ever gets stuck or corrupted.

• Added /ab questreset

  • Resets quest timers and cooldowns for a player.
  • Useful for testing or admin support.

Permissions

• Added aquabreeder.gui.quest
  • Allows players to open the quest GUI.
  • Default: true

Technical Improvements

• Quest offers, active quests, tracking settings, reroll cooldowns and completed slot cooldowns are stored safely in SQLite.
• Quest progress is restart-safe.
• Players cannot relog to lose or reset an active quest.
• Quest reroll saving was optimized with batch database saving to reduce small lag spikes.
• Quest GUI colors were improved:
  • Fish names now use category colors.
  • Required rarity now uses rarity colors.
  • Endgame fish are shown in red.
• Old placeholder texts were cleaned up from the Quest GUI.

Important for existing servers:

AquaBreeder 1.4 adds a new quests section to config.yml. Existing config files are not fully overwritten automatically. Missing keys are added automatically, but for the cleanest config with comments, compare your config.yml with the new default file or regenerate it after making a backup.

AquaBreeder 1.3

⚠️ Important Update Notice
Please delete the existing fish.yml in the AquaBreeder plugin folder before updating.
It will be regenerated on the next server start with the new reworked fish pool.

FishDex & Fishing

• Completely reworked the FishDex and fish pool.
• Added 103 fish species: 6 Starter, 28 Medium, 32 Rare, 28 Very Rare and 9 Endgame fish.
• Improved biome and condition coverage for rivers, oceans, beaches, deserts, savannas, jungles, warm/cold/frozen waters, caves and deep areas.
• Higher Aqua Rod levels now unlock more suitable Medium, Rare and Very Rare fish.
• Fishing XP can now be increased by night, rain, thunder and depth.
• Fishing conditions and XP bonuses now use the bobber/hook position instead of the player position.
• Condition XP bonuses are capped at +30%.
• Deep Dark no longer has a separate permanent +30% XP bonus.

Breeding

• Bred baby fish now grant Aqua Rod XP when claimed.
• Breeding XP is based on fish category, rarity, quality and current Aqua Rod level.
• Bred babies receive a +50% XP bonus and are capped at 1500 XP.
• Breeding XP does not grant rod energy and does not trigger Energy Overload.

Fish Storage

• Improved the Fish Storage filter layout.
• Rarity, quality, age and fish category now have separate filter buttons.
• Left click cycles filters, right click resets them.
• Active filters are now easier to recognize through different items and colors.

Updates

• Improved update notifications.
• Admins can now receive an ingame message when a new AquaBreeder version is available.
• The update message now shows the latest version and the Modrinth link.

AquaBreeder 1.2.1

Balancing & Progression Update

• Reworked Aqua Rod XP balancing and level progression.
• Catch XP now scales better with fish category, rarity, quality and Aqua Rod level.
• Improved fish category weighting: higher rod levels now find more Medium/Rare fish, while Starter fish still remain in the pool.
• Starter and Medium fish can now roll better quality and rarity more often with higher rod levels.
• Very Rare and Endgame fish remain special jackpot catches.
• Luck Surge has been rebalanced and now scales more carefully depending on fish category.
• Golden Hook has been reworked into a bonus-catch ability with a 50% chance to grant a second fish.
• Time Flow now reduces one active breeding slot by 5% of its remaining time, with a minimum of 2 minutes and a maximum of 15 minutes.
• Breeding quality has been rebalanced so perfect 100% fish are harder to obtain.
• Fish category now affects breeding quality progression.
• Improved Tempo talents: Reaktionsgefühl now visibly increases the green hit area, and Ruhiger Marker now noticeably slows the moving marker.
• Improved Energy Overload feedback and usefulness.
• Rare catch broadcasts are now stricter and only trigger for truly special catches.
• Sell GUI now has more space.
• Fixed aquarium fish getting stuck in locked slots after aquarium level changes.
• Added sound feedback when a breeding slot is finished.
• Fixed parent fish not refreshing their breeding usage immediately after claiming breeding results.

Important Note

Existing Aqua Rods may still show old XP/progression values in their lore after updating. The updated XP curve is fully reflected after the Aqua Rod reaches a new level or when a new Aqua Rod is created/given.

AquaBreeder 1.1

• Added sound feedback when breeding slots finish.
• Fixed breeding parent fish lore not updating immediately after claiming finished breeding results.
• Fixed aquarium fish getting stuck in locked slots after the aquarium level drops.
• Added one more sell row to the Sell GUI.
• Adjusted talent tree balancing:
  • Tempo talents are now freely selectable.
  • Growth Instinct is cheaper.
  • Breeding Slots and Luck Minigame Bonus now cost more points.

AquaBreeder 1.0.0

First public release of AquaBreeder.

AquaBreeder adds a full fishing progression system with custom fish, Aqua Rod leveling, talents, breeding, FishDex, fish storage, selling and aquariums.

Added

• Custom Aqua Rod fishing system
• Fishing minigame with quality bonus
• Rod XP, levels and talent points
• Talent tree with passive bonuses and active abilities
• Custom fish with rarity, quality, value and baby/adult stages
• Breeding system with multiple slots
• FishDex to view discovered fish
• Personal fish storage
• Sell GUI for safe fish selling
• Aquarium system with optional passive income
• PlaceholderAPI support
• Jobs Reborn support
• NPC and DeluxeMenus friendly commands
• English and German language support

Notes

Fishing is mainly used to collect starter fish and progression material.
Breeding is the main long-term path to high-value, rare and high-quality fish.

This is the first release, so balancing for fish values, rarity chances, breeding times and aquarium income may still be adjusted.