AquaBreeder

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.