Questborn

**🔧 New Features:** **Compatibility & Core** * **Minecraft 26.3 Support:** Fully updated and supported! Added all new 26.3 localization keys for blocks, entities, items, and biomes across all supported languages. **GUI & Controls** * **Quick Actions Toggle:** Added a new setting to enable or disable plugin hotkeys (swap/drop keys F and Q) in GUIs: <details> <summary>View Config Changes</summary> ```yaml # --- config.yml --- gui: # Enable or disable quick actions via swap/drop keys in GUI (F/Q) quick-actions-enabled: true

**🔧 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> ```yaml # --- 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> ```yaml # --- 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> ```yaml # --- 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: ```yaml 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`): ```yaml 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: ```yaml # 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: ```yaml 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: ```yaml 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: ```yaml 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: ```yaml 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!**