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 and progress.
• 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

• 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 and 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.

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 and minimum quality.

Quest Rewards

• Added money rewards.
• Added Aqua Rod XP rewards.
• Added better fish rewards.
• Added breeding time reduction rewards.
• Money rewards 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 rarity and quality.
• Breeding time reduction affects the longest active breeding slot.

Quest Tracking Sidebar

• Added optional quest tracking sidebar.
• The sidebar only appears when the player has an active quest, quest tracking is enabled and 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


Quest Configuration

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 to protect the economy balance.

Admin Commands

• Added /ab questclear <player> to clear a player's quest data.
• Added /ab questreset <player> to reset quest timers and cooldowns for a player.

Permissions

• Added aquabreeder.gui.quest
• 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.

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 <player> 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 and minimum quality.

Quest Rewards

• Added money rewards.
• Added Aqua Rod XP rewards.
• Added better fish rewards.
• Added breeding time reduction rewards.
• Money rewards 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.

Quest Tracking Sidebar

• Added optional quest tracking sidebar.
• The sidebar only appears when the player has an active quest, quest tracking is enabled and 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.

Quest Configuration

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 to protect the economy balance.

Admin Commands

• Added /ab questclear <player> to clear a player's quest data.
• Added /ab questreset <player> to reset quest timers and cooldowns for a player.

Permissions

• Added aquabreeder.gui.quest
• 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.

⚠ Important Update Notice

Please delete the existing fish.yml in the AquaBreeder plugin folder before updating.
But beware, maybe your existed Fish's in your Storage cannot be sell.
So, first have them sell their existing fish before deleting the `fish.yml` file, and then restart the server using v1.3. Thank you


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.

Fixes & Improvements

• Breeding sound feedback
  Finished breeding slots now play a subtle Ender Eye sound so players notice them more easily.
  
• Breeding parent display fix
  Parent fish now correctly update their breeding usage lore after claiming finished breeding results.
  
• Aquarium slot soft-lock fix
  Fish can no longer get stuck in slots that become locked again after the aquarium level drops.
  
• Sell GUI improvement
  Added one more sell row, increasing sell slots from 21 to 28.
  
• Talent tree balancing
  Tempo talents are now freely selectable.
  Growth Instinct is cheaper, while Breeding Slots
  and Luck Minigame Bonus now require more investment.

# AquaBreeder 1.0.0

Small maintenance update after the first public release.

## Added

- Added bStats metrics integration
- Added anonymous usage statistics support
- Helps track server versions, plugin usage and general adoption

## Notes

bStats does not collect personal player data.
It only provides anonymous plugin statistics and can be disabled globally in the server's bStats configuration.