ВЕРСИИ (21)

**🔧 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!**

### 🚨 **<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*): ```yaml # 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*): ```yaml # ------------------------------ # 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}" https://i.ibb.co/27hCNJ4h/Scoreboard-1.png https://i.ibb.co/DD6qf4FZ/Boss-Bar-1.png 🎨 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