Questborn

🔧 New Features: Core & Configurations Smart Auto-Updater (Experimental):* Added a new automated system for syncing missing keys and sections in plugin configurations and language files upon startup and reload. * Automatically detects missing keys from updated JAR versions and safely appends them without touching or overwriting existing user configurations. * Automatically creates backups in /plugins/Questborn/backups/<date_time>/ preserving directory trees. 🛠 Fixes & Improvements: FALL_DISTANCE Objective:* Rewrote the fall distance tracker to accurately record total blocks fallen in air and survived. Safe landings (water, slime, cobwebs, hay, powder snow, MLG water bucket) are now properly credited. GUI Quest Editor:* Fixed an issue where adding potion effects as a quest reward failed with a cast error. GUI Quest Editor:* Fixed experience reward level mode displaying an unlocalized string in the item title. GUI Quest Editor:* Fixed command reward mode switching and hand-held item reward addition. Enjoy using the update!

🔧 New Features: GUI & Usability Quick Actions:* Added new hotkeys for quick quest management directly from the quest list GUI: * Swap (F) - Activate the selected quest (or replace it if another quest from the same list is already active). * Drop (Q) - Deactivate (cancel) the currently active quest. Configurations Quest Status Items:* Added new sections to customize quest status items in menus.yml. You can now change the material (as well as use CustomModelData, ItemsAdder, or CraftEngine) for the following states: <details> <summary>View Config Changes</summary>

# --- menus.yml ---
status-reward:
  material: CHEST_MINECART

status-cooldown:
  material: CLOCK

status-locked:
  material: GRAY_STAINED_GLASS_PANE

</details> Enjoy using the update!

🔧 New Features: Configurations Rewards:* Added money-format setting to customize how money rewards are displayed in chat and menus. <details> <summary>View Config Changes</summary>

# --- config.yml ---
rewards:
  # Format for displaying money rewards in chat and menus.
  # Example: "#,##0.##" will format "1000.50" as "1,000.5", and "130.0" as "130".
  money-format: "#,##0.##"

</details> 🛠 Fixes & Changes: Objectives:* Fixed TILL_SOIL objective not tracking progress at all. GUI Editor:* Fixed the auto-activate-next parameter not enabling correctly when toggled via the editor. Database:* Fixed potential database connection issues. Enjoy using the update!

🔧 New Features: Core & GUI GUI Editor:* Added a multi-functional in-game editor to configure quests, types, NPCs, and dialogues (/quest editor). Commands:* Added the ability to reset player top data, including an -all flag for all players (/quest reset top (type) [player or -all]). Quest List:* Added informative items in the menu for each quest engine (DEFAULT, CHAIN, ROTATION, GLOBAL). Custom Icons:* Added support for custom heads in quest and quest type icons using base-head. Objectives & Integrations Integrations: Added CraftEngine and ItemsAdder* support. You can now use custom IDs (e.g., ce:default:topaz_ore, itemsadder:) for items and custom entities. Block Objectives:* ITEM_COOK and ITEM_SMELT now grant progress when breaking a furnace/smoker/blast furnace containing processed items. Campfires:* The ITEM_COOK objective now supports campfires. Configurations Rotations:* Added sync-rotation setting to optionally synchronize rotation quests for all players. Rotations:* Each ROTATION pool now has its own configured slots. Objectives:* Added allow-spawner-kills setting to control if spawner mobs count towards KILL_ENTITY. GUI:* Added show-rewards setting to toggle displaying rewards in the quest list. Metrics:* Added an option to enable/disable anonymous statistics via bStats. <details> <summary>View Config Changes</summary>

# --- config.yml ---
sync-rotation: false # Shared community experience toggle
allow-spawner-kills: false # Toggle spawner kills
metrics:
  enabled: true # bStats toggle
quest-list:
  show-rewards: false # Display rewards in GUI

# --- Quest Types config (ROTATION engine) ---
rotation-pools:
  common:
    - 20
    - 21
  rare:
    - 23

# --- menus.yml ---
  quest-list:
    items:
      engine-info-rotation:
        slot: 4
        material: PLAYER_HEAD
        base-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNzZjMGQwNDU5YzY3ZjJiZTgyZmJlNTQwNmFiOGQxMzc4ZGExZjI4ZjdhM2Y4MmYxZGZjNDc2MTVhOTU1YTcifX19"
        name: "<#99ff9d>⌚ Rotating Quests"
        lore:
          - "<#cccccc>These quests are time-limited."
          - "<#cccccc>The next rotation will occur"
          - "<#cccccc>in: <#b3ffb6>⏳ {time}"
          - ""
          - "<#70a373>▪ When the time is up, all progress"
          - "<#70a373>  on incomplete quests will be lost."

      engine-info-global:
        slot: 4
        material: PLAYER_HEAD
        base-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2RjZGVlNmQwNmRmMjM0YjhlNjAzMzI4Yjk2YzU3ZjNhMzEyZTc5YWFiZmMzYmU3MmE4YjQyMTg3OGVkNjhjZiJ9fX0="
        name: "<#9e79b8>🌍 Global Quests"
        lore:
          - "<#cccccc>These quests are shared among all"
          - "<#cccccc>players on our server."
          - ""
          - "<#908494>▪ Their completion progress"
          - "<#908494>  is saved for everyone."

      engine-info-default:
        slot: 4
        material: PLAYER_HEAD
        base-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmVhNDY4NWQ1NWFlYzk5NTVkZDg2OWI0OTViMmY1YjJmYjc0MzU4NzYxM2JhNTg3OTYwYzNhM2Q2NWYyNGE4YiJ9fX0="
        name: "<#82b082>📜 Classic Quests"
        lore:
          - "<#cccccc>Regular quests that do not have"
          - "<#cccccc>any time limits."
          - ""
          - "<#8c998c>▪ You can complete them at"
          - "<#8c998c>  your own pace."

      engine-info-chain:
        slot: 4
        material: PLAYER_HEAD
        base-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvN2IyZjJiNzY0MmI1NDQ5MGI5ZmZhMWUwZTFiMjk2YWFkMmI3YTRlZGI5MzYxZTdlOGU5OTAzYjY0ZGJiODkzOSJ9fX0="
        name: "<#c48b52>🔗 Chain Quests"
        lore:
          - "<#cccccc>These quests are closely connected"
          - "<#cccccc>into a single sequential line."
          - ""
          - "<#99897a>▪ Completing one quest"
          - "<#99897a>  unlocks access to the next one."

</details> 🛠 Fixes & Changes: NPCs:* Fixed command actions in dialogues not executing correctly. NPCs:* Fixed indicators falsely flashing when no quests were available. NPCs:* Display requirements are now correctly applied to NPCs. Rewards:* Fixed potions being given as uncraftable/corrupted. Rotations:* Fixed the announcement being sent before the actual rotation occurred. Objectives:* The JUMP objective now uses amount instead of the deprecated jumps parameter. Objectives:* Fixed BREWING and POTION_DRINK not tracking progress at all. Objectives:* Fixed false progress tracking for ItemsAdder custom IDs. Progress Tracking:* Fixed HUD not updating after completing a quest while another is active. Progress Tracking:* Fixed tracking issues when multiple quests are active simultaneously. Global Quests:* Cooldowns are now only applied if the quest successfully starts (minimum participants reached). Global Quests:* The quest menu no longer closes if the activation fails due to insufficient participants. Compatibility:* Fixed errors when activating quests or handing in items on Folia servers. Misc:* Delays before completing stages/quests now function correctly. Misc:* Fixed plugin syntax error messages and added/fixed localization keys. Misc:* Fixed bStats initialization. 📚 Documentation: * The plugin's wiki has been fully updated for version 2.0.0! Enjoy using the update!

⚠️ 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!

🔧 New Features: * Added a new setting for automatic global quest data saving intervals:

  auto-save:
    global-interval-seconds: 900   # Auto-save interval for global quests in seconds (15 mins)
  

* Added a new setting to log all player interactions with quests:

  logs:
    enabled: false   # Enable/disable gameplay events logging to logs/YYYY-MM-DD.log
  

🛠 Fixes & Changes: * Global quest progress is now saved to the main configured database instead of a separate .yml file (old data will automatically migrate!). * Fixed an issue where automatic saving for global quests was not working correctly; auto-saving is now fully functional and logs properly. * Fixed a bug where a global quest could be activated in a restricted game mode (preventing it from tracking progress) if game mode settings were changed mid-quest. * Fixed incorrect translation strings in most language files, adapted for the new localization keys. * Optimized plugin size by removing unnecessary translation files for dependencies.

--- ⚠️ WARNING: Please make a backup of your plugin folder before installing this update! 🔧 New Features: - New Quest Engine: GLOBAL - This is a new type of quest that the entire server completes together. - To complete such a quest, every participating player contributes to the overall progress. - Added the ability to configure step-by-step rewards for every N units of progress a player contributes to the global quest. - You can set a personal contribution limit for players to prevent one person from completing the entire quest alone. - After reaching the personal contribution limit, the player will have to wait for the quest to be completed by other players to receive the final reward. - Upon completion of a global quest, statistics will be displayed in the chat: top contributors, time spent, and total number of participants. - Added server-wide sound playback upon completion of a global quest. - Added new visual delays in config.yml: stage-complete, quest-complete, and auto-activate-next. - Added support for Spigot and Folia server platforms. 🛠 Fixes & Changes: - Completely removed the following quest objectives: DELIVER_ITEM, COLLECT_ITEM, FISHING_BOBBER_HOOK. - Changed the progress tracking logic for OPEN_CONTAINER - now only unique opened containers are counted. This restriction can be bypassed using the questborn.antiabuse.bypass permission. - Optimized quest handlers for better performance. - Improved database operations. Enjoy using the update!

--- ⚠️ WARNING: Please make a backup of your plugin folder before installing this update! New Features: - Added official support for versions 26.1, 26.2 - Added support for custom and exact world names in CHANGE_DIMENSION quest (without false triggers from similar names). - Added worlds section to config.yml to translate names of any dimensions (e.g. world_nether -> Nether). Bug Fixes: - Item delivery progress now shows the exact total amount (e.g. 0/32), rather than 0/1. - Fixed a bug where the ActionBar message disappeared in a millisecond. - The successful item delivery message now always shows BEFORE the quest completion message. - Removed unnecessary Vault economy provider not found console spam when Vault is disabled. - Cleaned up quest GUI menus: removed the duplicate item delivery message from the main description. - Edited terminology and completely fixed encoding bugs across all 10 language files. Enjoy using the update!

--- Changes in Quest Objectives: - INTERACT_BLOCK - Now counts only 1 time per block. If it's the same block that was already counted - it simply won't count, unless the player has the questborn.antiabuse.bypass permission to bypass this. - HARVEST_CROP - Now correctly counts the harvesting of nether wart. - STRIP_LOG - Fixed false progress counting when a shield is in the off-hand and an axe in the main hand. - FILL_FUEL - Now counts the amount of item deposited as progress, not the number of times. - TRAVEL_DISTANCE - Now does not count the distance traveled along the Y-axis. - SPRINT_DISTANCE - Now does not count the distance traveled along the Y-axis. - CONDUIT_ACTIVATE - Fixed constant progress counting when the player activated it only 1 time. - REACH_LOCATION - Now functional (previously it was not working at all). - ENTER_REGION - Now functional (previously it was not working at all). - LEAVE_REGION - Now functional (previously it was not working at all). New Quest Objectives: - BURN_FUEL - Counts progress when the player burns the specified items in different furnaces. - VILLAGER_BUY_ITEM - Counts progress when the player buys the specified item from a Villager. - VILLAGER_SELL_ITEM - Counts progress when the player sells the specified item to a Villager. - REACH_BIOME - Counts progress when the player visits the specified biome. Removed Quest Objectives: - TELEPORT - Fully removed. (If you need the player to teleport to a specified world, use CHANGE_DIMENSION). - TRADE_WITH_VILLAGER - Fully removed. (Replaced by 2 new types: VILLAGER_BUY_ITEM and VILLAGER_SELL_ITEM). menus.yml Update: Actions are now supported when clicking on an item. Example:

menus:
  main:
    items:
      close_btn:
        slot: 44
        material: IRON_DOOR
        name: "<#ff8888>✖ Close Menu"
        lore:
          - "<#cccccc>Click to exit"
          - "<#cccccc>main menu"
        actions:
          - "[close]"

      website_btn:
        slot: 36
        material: COMPASS
        name: "<#aaffaa>🌐 Our Website"
        lore:
          - "<#cccccc>Discover news and"
          - "<#cccccc>updates on our site!"
          - ""
          - "<#ffffff>» Click to open"
        actions:
          - "[close]"
          - "[player] website"

Other Minor Updates: - The progress bar in ActionBar / BossBar / Scoreboard will momentarily fill completely when the player receives the final progress, before the specified effects are played. - When typing commands, commands starting with questborn: will no longer be highlighted. - Fixed an issue where the number of pages in the GUI could sometimes show more than there actually were. Localization Update: - Added key gui.details.objective.villager-sell-item - Added key gui.details.objective.villager-buy-item - Added key gui.details.objective.reach-biome - Added key quest.icons.villager-sell-item - Added key quest.icons.villager-buy-item - Added key quest.icons.reach-biome - Removed key quest.icons.teleport - Removed key quest.icons.trade-with-villager - Removed key gui.details.objective.trade-with-villager - Removed key gui.details.objective.teleport - Removed keys gui.details.objective.cause.* Enjoy using the update!

<span style="color:#e55144">Make a full backup of the Questborn plugin folder (especially player data and configs) before updating!</span>

--- The New ROTATION Engine Introducing the completely new ROTATION engine! It is perfect for creating daily, weekly, or other cyclical quests: - Quest Pools: Automatic and randomized quest generation from pre-configured pools. - Reset Timers: Flexible configuration for progress resets (daily, every few days, or at a specific time). - Individual Generation: You can now configure it so every player gets their own unique set of quests from a pool, or keep it the same for everyone. - GUI Display: Full support for configuring specific slots where selected quests will appear for each type (rotation-slots). - Built-in Quests Updated: The default daily and weekly quests have been completely rewritten to utilize the new ROTATION engine features! This is how it looks now (daily.yml):

# Unique identifier for this quest type
id: daily

# Directory where quests of this type are stored
folder: quests/daily

# Display name in the GUI
display-name: "<#fffb99>☀ Daily Quests"

# Optional: Overrides the default GUI title for this quest type.
# gui-type-title: "<#fffb99>☀ Daily Quests &8| &f{page}/{total}"

# Optional: Overrides the default quest details GUI title.
# gui-quest-title: "<#fffb99>☀ Daily - {quest}"

# Optional: Overrides the default item transfer GUI title.
# gui-transfer-title: "<#fffb99>☀ Transfer - {quest}"

# Lore displayed in the GUI
lore:
- "<#cccccc>Fresh tasks available every day."
- "<#cccccc>Complete them to earn"
- "<#cccccc>useful rewards."
- ""
- "<#fffb99>Today's Progress:"
- " <#a7ff99>✔ <#ffffff>{cooldown}/{total} <#cccccc>completed"
- ""
- "<#7dd3ff>Click to open"

# Icon material in the GUI
material: CREEPER_SPAWN_EGG
# Slot position in the Main Menu GUI
slot: 20

# Quest engine operation mode
# Choose how quests in this category behave:
# - DEFAULT: All quests are always available, handled individually.
# - CHAIN: Players unlock the next quest only after finishing the previous one.
# - ROTATION: Players get N random quests that reset periodically.
engine: ROTATION

# Number of quests from each pool to include in the rotation
# If not specified, a 'default' pool is created matching the number of rotation-slots
rotation-pools:
  common: 3
  rare: 2

# GUI slots where assigned quests will appear
rotation-slots:
  - 20
  - 21
  - 22
  - 23
  - 24

# Reset every 1 day
reset-period: "1d"
# Optional: Set a specific time of day for global reset
reset-time: "00:00"
# Optional: 1=Mon, 2=Tue...7=Sun. Anchor day for global reset.
# reset-anchor-day: 1

# Optional: Requirements to unlock this quest type
# requirements:
#   permission: "questborn.type.daily"
#   quest-completed: "starter_chain_01_wood_call"
#   type-completed: "starter_chain"

# Optional: Description of requirements displayed in GUI when locked
# requirements-lore:
#   - "<#ff5555>Requires completion of:"
#   - " <#ff5555>• <#ffffff>Starter Chain"

# Set to false to completely disable this quest type (it won't be loaded by the plugin)
enabled: true

Global Database Update The progress storage system has been written entirely from scratch to provide better performance and stability. - Supported Databases: The plugin now supports H2, SQLite, MySQL, PostgreSQL, MongoDB, and YAML. - New Standard: The default database type is now H2. This guarantees much faster, more stable, and reliable saves compared to regular .yml files. - Automatic Migration: Don't worry about your old data! On the first launch of version 1.5.0, your old playerdata.yml file will be automatically recognized, and all player data will be seamlessly migrated to the new H2 format. This is how it looks now (config.yml):

# ------------------------------
#   STORAGE
# ------------------------------

storage:
  # Storage backend to use for player data.
  # Options:
  #   H2 - H2 file-based database (fast alternative to SQLite, recommended default)
  #   YAML  - Individual YAML files per player (legacy)
  #   MYSQL - MySQL / MariaDB database (recommended for networks with multiple servers)
  #   POSTGRESQL - PostgreSQL database (alternative to MySQL)
  #   SQLITE - SQLite file-based database (good middle-ground for single servers)
  #   MONGODB - MongoDB via official driver (requires internet or local server)
  type: H2

  # MySQL / MariaDB settings (used only when type: mysql)
  mysql:
    host: localhost
    port: 3306
    database: questborn
    username: root
    password: ""
    # Connection pool size
    pool-size: 5
    # Connection timeout in milliseconds
    connection-timeout: 30000
    # Use SSL for connection
    use-ssl: false

  # PostgreSQL settings (used only when type: postgresql)
  postgresql:
    host: localhost
    port: 5432
    database: questborn
    username: postgres
    password: ""
    # Connection pool size
    pool-size: 5
    # Use SSL for connection
    use-ssl: false

  # MongoDB settings (used only when type: mongodb)
  mongodb:
    uri: "mongodb://localhost:27017"
    database: questborn
    collection: player_data
    # Timeouts in milliseconds
    connect-timeout: 5000
    read-timeout: 5000

  # SQLite settings (used only when type: sqlite)
  # The database file is located in the plugin's data folder.
  sqlite:
    file: questborn.db

Enjoy using the update!

IMPORTANT - BEFORE UPDATING: - Make a full backup of the Questborn plugin folder (especially configs, player progress data, and player files) before updating! - After the update, delete the old config.yml file — the plugin will automatically create a new one with all the latest settings. - The old top.yml file is no longer used and can be completely deleted — everything has been moved to the new menus.yml. New features and changes: New integration with ItemsAdder Added the ability to use custom ItemsAdder items in quests. Usage example: objectives: type: ITEM_FISH amount: 6 target-materials: - "itemsadder:iasurvival:blue_parrotfish" Full integration with PlaceholderAPI Added complete PlaceholderAPI support. Now you can display quest information in holograms, chat, tab list, Scoreboard, etc. Available placeholders: %questborn_quests_completed% - total number of quests completed by the player %questborn_status_<id>% - quest status (ACTIVE, COMPLETED, COOLDOWN, AVAILABLE, UNAVAILABLE) %questborn_cooldown_<id>% - remaining cooldown time for a specific quest %questborn_active_id% - ID of the current active quest %questborn_active_name% - name of the current active quest %questborn_active_description% - description of the current active quest %questborn_active_stage_current% - current stage %questborn_active_stage_total% - total number of stages %questborn_active_progress_current% - current stage objective progress %questborn_active_progress_target% - target stage objective progress %questborn_active_progressbar% - graphical progress bar %questborn_active_objective% - current objective text (first line) %questborn_active_objective-<number>% - specific line (e.g. -0, -1, etc.) Quest display (Scoreboard & BossBar) Added convenient display of the current quest on screen via Scoreboard and BossBar. Fully configurable in config.yml. Configuration example: bossbar: enabled: true title: "&e{quest_name} &7[{progress}/{target}]" color: AUTO mode: "STATIC" style: SOLID scoreboard: enabled: true lines: - "&fQuest:" - "{quest_name}" - "{objective_details}" New menu configuration system (menus.yml) The old top.yml file has been merged into a single menus.yml. Now you can freely customize the GUI size and exact element placement in each menu. Example for Top menu: menus: top: rows: 5 slots: players: - "10-16" - "19-25" - "28-34" mask: - "0-9" - "17, 18, 26, 27, 35, 36" - "36-44" rank-styles: 1: prefix: "<#FFAA00>♛ " footer: "<#FFAA00> TOP 1 LEADER " Integration with SkinsRestorer Added small integration to improve skin display in the player leaderboard. Technical improvements - Updated and optimized configuration structure - Minor code refactoring and performance optimization Enjoy using the update!

Updated library that caused ActionBar to not work on version 1.21.11

!!! IMPORTANT NOTE !!! Before using this version of the plugin, make a backup of your plugin data. Also, delete the existing configuration file, localization files, and effect presets so the plugin can generate fresh, updated versions of these files. Update Log New NPC Integration (Citizens & FancyNPCs) Added full support for NPCs from the Citizens and FancyNPCs plugins! - Players can now accept and complete quests by interacting with NPCs. - An indicator above the NPC's head displays the status of available quests. New supported versions - 1.16 - 1.17 - 1.18 - 1.19 - 1.20 New settings in config.yml Integration

integration:
  enabled: false               # Enable or disable NPC integration
  npc-plugin: FANCYNPCS        # Choose plugin: CITIZENS or FANCYNPCS
  mode: MIXED                  # Modes:
                               # MIXED – both commands and NPCs work
                               # NPC_ONLY – only NPCs (commands disabled)
                               # MENU_ONLY – only commands (NPCs disabled)
  interaction-button: RIGHT    # Button used to interact with NPC (LEFT / RIGHT)

Indicators above NPC head

npc-indicators:
  enabled: true
  view-distance: 20.0
  offset-y: 0.6
  icons:
    available: "&6&l!"
    in-progress: "&a&l▣"
    completed: "<#00ff94>&l✔"
    cooldown: "&b⏳"
    locked: "&c&l"
    reward-available: "<#00ff66>&l"

Other new settings

gameplay:
  allowed-gamemodes:           # Game modes allowed for quest progression
    - SURVIVAL
    - ADVENTURE

chat:
  show-details: true           # Show detailed info (objectives + clickable link) in activation/stage messages

rewards:
  # If true, rewards are automatically given upon quest completion (bypassing NPC claim).
  # If false, player must claim rewards (via NPC interaction or GUI).
  auto-claim: false

New commands - /quest npc link <typeID> <npcID> – link a quest type to an NPC Examples: • FancyNPCs: /quest npc link daily joe • Citizens: /quest npc link daily 1 - /quest npc unlink <typeID> <npcID> – unlink a quest type from an NPC Examples: • FancyNPCs: /quest npc unlink daily joe • Citizens: /quest npc unlink daily 1 - /quest details – open detailed view of the currently active quest Note: Before linking an NPC, create it in Citizens or FancyNPCs and note its ID (for Citizens – numeric ID, for FancyNPCs – name). Improved quest details menu The quest details interface has been completely redesigned – all elements are now arranged conveniently, beautifully, and informatively. Updated documentation Documentation has been updated to reflect the current plugin version: https://questborn.gitbook.io/docs/ Thank you for using QuestBorn!

Fixed objectives: - BREWING - Now correctly counts progress when picking up a brewed item. - STRIP_LOG - Now it only counts when cutting a log, previously it could be obtained. - PLANT_SEED - Now counts both various crop seeds and tree saplings. Changed the active quest icon: - An active quest is now marked with an enchantment. - A completed one-time quest now shows the quest icon. Fully updated built-in quests: - 4 new quest types. - 60+ total quests, (These quests are made to demonstrate the plugin's capabilities). Minor localization fix.

Fixes: - Quests of the 'starter' type: Problem: The progression chain for built-in quests of the 'starter' type was broken, preventing subsequent quests from activating. Fix: Corrected the internal chain logic. Progression for 'starter' type quests now works correctly. - Objective ITEM_CRAFT (Craft Item): Problem: The objective failed to register a successful craft if the player immediately dropped the resulting item by hovering over it and pressing Q. Using Shift to craft multiple items also did not register. Fix: Updated the tracking logic to record the crafting action as successful the moment the item is created, prior to any inventory management. Pressing Q to drop the newly crafted item now correctly counts towards objective completion. Crafting multiple items with Shift + Click is now also registered properly.

Before installing this update, you MUST: 1. Make a full backup of the plugin folder 2. Delete the following folders from the old plugin: - config/ - languages/ 3. These folders will be automatically regenerated when the updated version starts with the new structures Version Changes New Systems - Added item transfer system for quests Now you can configure receiving/turning in items during quest completion. - Added quest stage system Quests can have multiple sequential stages with different completion conditions. Detailed documentation: See the documentation for how to properly use the new systems. Quest Types and Examples - Added new quest types with support for stages and item transfer. - On first launch, the plugin automatically creates a demonstration quest type that illustrates: - Stage functionality - Item transfer mechanics Localization Expansion Added support for 5 new languages: - pt-BR - Portuguese (Brazil) - fr-FR - French - tr-TR - Turkish - kk-KZ - Kazakh - pl-PL - Polish Technical Changes - Updated configuration file structure - New localization file structure - Improved data loading system Notes - Check plugin settings after updating - Demonstration quests can be deleted after familiarization - Recommended to test the update on a test server first

Fixed: - disabled-for-types in config - now correctly accepts the type and disables it for display in ActionBar. - ITEM_CRAFT objective - now correctly counts the number of crafted items. Changed: Distance-based objectives now only read the distance parameter. - ELYTRA_FLY objective now uses distance instead of amount. - MINECART_TRAVEL objective now uses distance instead of amount.

Major New Features - Chain Quest System - Full support for sequential quest chains. New quests are auto-generated in the plugin folder on first launch. - Quest Engine Selection - Added engine: setting (default or chain) to define quest behavior. - Visual Customization - Set quest icons with icon-material: and arrange chain quests with slot: positioning. - Optimization Setting - New performance tuning option in main configuration. - Simplified GUI Mode - Use /quest open list daily --simple to hide back buttons (ideal for NPC menus). Core Changes - Permission System Overhaul - All permissions migrated from quest. to questborn.. - Startup Log Revamp - Cleaner, more informative initialization messages. CRITICAL UPDATE NOTES Before installing this update, you MUST DELETE these old files/folders: - config.yml - Entire language/ folder These files have been completely restructured and will be regenerated automatically on startup with new defaults. Update Summary - Chain quest engine with automatic setup - New permission namespace (questborn.*) - Quest icon & slot customization - Performance optimization options - Simplified GUI for NPC integration - Improved logging and configuration structure Note: Backup your existing quest files before updating, as the configuration format has significantly changed.

IMPORTANT: Before installing this update, you MUST delete the following old files: - config.yml - language/en_us.yml - language/uk_ua.yml These files were updated and will be regenerated automatically on startup. New Features: - Added plugin update checker. Questborn now notifies server owners when a new version is available. - Added new language localizations: • es_es (Spanish) • de_de (German) • ru_ru (Russian) Improvements: - Updated and improved existing localizations: • en_us • uk_ua - Fixed potion display in quest objective descriptions. Potion names and types are now displayed correctly. - Quest Effects localization update: The plugin page now provides downloadable quest-effects versions localized for all supported languages: • en_us • uk_ua • es_es • de_de • ru_ru Fixes: - Minor GUI text rendering fixes. - Localization consistency improvements across quests and objectives.

First version