Questborn

⚠️ IMPORTANT WARNING: Please make a backup of your plugin data before updating. It is highly recommended to completely regenerate all plugin configuration files, as many configs have been significantly updated in this version!

🔧 New Features:

• NPC 2.0 & Interactive GUI Dialogues:
  • Added a fully GUI-based dialogue system with branching responses and custom node actions (give_quest:, run_command:, open_quest_menu, goto:).
  • Added custom NPC settings: display names, GUI titles, sound voice presets, and indicator hologram offsets.
  • Overhauled NPC Indicators with custom view distances, height offsets, and condition-based hiding:

    npc-indicators:
      enabled: true
      hide-on-moods: ["BUSY", "SAD", "ANGRY"]
      view-distance: 20.0     # Distance to see indicators
      offset-y: 0.6           # Height above NPC head
      icons:
        available: "<#ffcc66>&l▽"
        in-progress: "<#a8ff80>&l▽"
        completed: "<#00ff94>&l✔"
        cooldown: "<#ff9e80>⌚"
        locked: "<#ff6666>&l🔒"
        reward-available: "<#a7ff99>&l🎁"
        objective: "<#7dd3ff>⛨"
    

  • Added new subcommands for /quest npc management: dialogue, displayname, gui-title, indicator, info, list, voice, and remove.
• New Objectives & Content:
  • Added 7 new quests (2 daily, 2 weekly, 3 global).
  • Added NPC_INTERACT: Tracks progress when a player interacts with a specified NPC.
  • Added GIVE_ITEM_TO_NPC: Tracks progress when a player hands over items to an NPC.
  • Added CROUCH_DISTANCE & SWIM_DISTANCE: Tracks distance while crouching and swimming.
• Overhauled Rewards System:
  • Fully revamped system with modular reward types. Added new reward types:
    • chance - Percentage-based random rewards
    • message - Personal messages (supports MiniMessage & PAPI)
    • broadcast - Server-wide messages (supports MiniMessage & PAPI)
• Global Quests Enhancements:
  • Global quest engine (GLOBAL) now fully supports required-materials stage objectives for server-wide item contribution goals.
  • Added a message and sound upon global quest activation (configurable in config.yml):

    sounds:
      # Sound played to all online players when a global quest starts
      global-quest-start:
        sound: "ITEM_GOAT_HORN_SOUND_0"
        volume: 0.8
        pitch: 1.0
    

  • Added the ability to set a minimum number of participants for a global quest.
  • Added a message shown to all participants when a player joins a global quest.
  • Added a cooldown for global quest activation (configurable in config.yml).
  • Added cancel-mode and rejoin-cooldown-seconds to config.yml to configure if players can cancel a global quest for themselves:

    # Global quest settings
    global-quests:
      # Mode for canceling active global quests:
      # ALLOW_WITH_CONTRIBUTION_RETAINED - Players can cancel global quests anytime. Their contribution remains in the global goal, but they forfeit completion rewards.
      # BLOCK_IF_CONTRIBUTED - Players cannot cancel global quests if they have already made a contribution (> 0).
      cancel-mode: "ALLOW_WITH_CONTRIBUTION_RETAINED"
      # Anti-spam cooldown in seconds before a player can re-activate a global quest after canceling or replacing it (0 to disable)
      rejoin-cooldown-seconds: 900
    

• Rotations & Formatting:
  • Added support for MiniMessage.
  • Updated the formatting of all localization files (added plugin prefix and changed message colors).
  • Added rotation-announce messages upon quest rotation, unique per rotation type.
  • Updated the required items formatting in the item transfer GUI for better visual feedback:

    gui:
      transfer:
        # Formatting for items in the transfer GUI lore
        # {item} = Item name, {current} = Amount in inventory, {required} = Amount required
        item-format: "<#707070>[<#cc5555>✖<#707070>] <#cccccc>{item} <#808080>(<#cc5555>{current} <#707070>/ <#808080>{required}<#808080>)"
        item-format-complete: "<#707070>[<#55cc55>✔<#707070>] <#cccccc>{item} <#808080>(<#55cc55>{current} <#707070>/ <#808080>{required}<#808080>)"
    

• Modular Minecraft Translations:
  • Extracted vanilla Minecraft translation files into dedicated /language/minecraft/ subfolder for faster loading and cleaner localization files.

🛠 Fixes & Changes:

• Fixed an issue with quest rotation where players kept active quests — they now disappear immediately.
• Fixed progress tracking for TRAVEL_DISTANCE and SPRINT_DISTANCE objectives while fly mode is enabled.
• Fixed an issue where the HARVEST_CROP objective did not track progress correctly.
• Fixed local time detection for quest rotation; previously, it could differ from the machine's local time.
• Improved GUI navigation logic and menu back button routing.
• /quest finish and /quest finish stage commands now automatically target the active quest if it wasn't manually set to "tracked" in GUI.
• Added an automatic 45-second timeout to pending NPC link actions.

📚 Documentation:

• The plugin's wiki/documentation has already been fully updated to reflect all the new features and changes in version 1.9.0!

Enjoy using the update!