BeautyQuests

### Note This is a **dev build** and not a release. Please use with care! - Backup your prior data before installing: both the `/plugins/BeautyQuests` directory AND your database (if using one). - Test beforehand on a separate server than your production one. --- - Fixed Citizens NPC custom color being ignored in dialogs **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/2.2.0+build.157...2.2.0+build.158

### Note This is a **dev build** and not a release. Please use with care! - Backup your prior data before installing: both the `/plugins/BeautyQuests` directory AND your database (if using one). - Test beforehand on a separate server than your production one. --- - Stages where the player has to die now take priority over the "fail on death" quest option - Block selection editors have been updated **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/2.2.0+build.156...2.2.0+build.157

### Note This is a **dev build** and not a release. Please use with care! - Backup your prior data before installing: both the `/plugins/BeautyQuests` directory AND your database (if using one). - Test beforehand on a separate server than your production one. --- - Fixed update checker mentioning the _2.1.0 build 138_ as the latest version even if release 2.1.0 is out (due to outdated SpigotMC page) - Added the `dialogs.instant finish` config.yml option. When turned on, the dialogs will complete instantly when the last message is sent to the player, instead of waiting for the player to click once more. **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/2.1.0...2.2.0+build.156

## Quest categories  - The `/quests` menu can now be organized with categories using quest pools! - There are 2 new related config.yml options: - `quests menu.categorize quests by pools` (enabled by default) - `gui.hide folder if single category` - Quest pools have 2 new related options: - Pool name, which is the displayed on the category item in the menu - An option to make the pool shown (or not) as a category in the /quests menu ## Pools - Added "start rewards" and "end rewards" options for quest pools - Added new pool-related placeholders: - %beautyquests_pool_ID_can_start% will return true or false depending on if a player can get a new quest from the pool *ID* - %beautyquests_pool_ID_remaining% will return the amount of quests not yet started or completed in the pool - %beautyquests_pool_ID_in_progress% will return the amount of quests in progress in the pool - %beautyquests_pool_ID_completed% will return the amount of quests completed in the pool - %beautyquests_pool_ID_cooldown% - %beautyquests_pool_ID_can_start_reason% - Fixed a lot of inconsistent behaviors in quest pools ## Quest edition - Most editors that asked to write something in the chat have been replaced with [Minecraft Dialogs](https://minecraft.wiki/w/Dialog). - The editors that previously accepted the "null" keyword can now simply be left empty before the player clicks on "Validate". - Some editors have gained a "reset" button for better ergonomy. - Added indications to some complex editors (e.g. duration, regex, comparisons...) - Since dialogs text input can span multiple lines, replaced old (and bad) "multiline text editor" by this <img width="798" height="466" alt="image" src="https://github.com/user-attachments/assets/2fda54af-9906-46c6-9188-87004c9da933" /> <img width="710" height="476" alt="image" src="https://github.com/user-attachments/assets/d3d1ef4e-c41b-4295-a351-49b958f831d8" /> ## Misc. changes & additions - Added support for Minecraft 1.21.11, 26.1 and 26.2 - **Dropped support for Spigot**, BeautyQuests is now **Paper-only** (+ forks) - Dropped support for Minecraft 1.17 to 1.19 (included) - Added SQLite support - Added FancyHolograms support - "play time" stage type now updates progress bar and scoreboard in real-time, once per second - Added `holograms.preferred plugin` config option - Moved holograms-related config.yml settings in a dedicated section - Added "show progress bars on join" config option - If enabled (default behaviour), progress bars of the active quests are shown when players log in. - Updated "automatic quest" option: - It can now have 3 states: - Disabled (the default) - Only for new players - For all players - Before this update, it was either Disabled or Only for new players. The "For all players" option is new. - Quests created with the option set to "For all players" will be automatically started for all online players and subsequent player joining the server, whether it's their first time or not. - Added (back) the `/bq reload data` command - The old `/bq reload` has been completely removed in favor of this new one. - In contrast with the old reload command, it does *not* reload configuration settings. It only reloads the quests folder and the pools file. - Allowing the quests to be reloaded during the plugin runtime required to change quite a load of loading related code. It may have created some bugs. Please avoid using this command in production. - Added "RegExp" option to the "Write in chat" stage type - This allows complete flexibility of messages to match thanks to the power of [regular expressions](https://en.wikipedia.org/wiki/Regular_expression) - e.g., /town create .+ would match any command starting with /town create - Test your regexes with https://regex101.com - Added a lot of PlaceholderAPI placeholders: - for all quest options: %beautyquests_quest_ID_OPTION%, replace ID with the ID of a quest and OPTION by an option such as name, description, cancellable... - for player-specific quest description, for instance %beautyquests_player_quest_ID_time_left% (if the Expansion is installed). - for launched quests such as %beautyquests_started_ordered_time_left% - The full list available with /papi info beautyquests - Added more debug logging ## Bugfixes - Fixed errors when clicking on an empty slot with an item in hand (potentially spamming errors) - Fixed exploit in "craft items" stage where players can advance in quests when their inventory is full by shift+clicking - Fixed "Use of Maven Central as a CDN is against the Maven Central Terms of Service" warning on startup on Paper - Fixed some errors when having custom sounds without namespaces - Fixed "remove item" action editor showing *right-click* instead of *shift+right click* - Selectors such as @a, @p, etc. are now working again in the commands - Fixed saving of quest options with "null" or "none" values (for instance, end firework or end message) - Fixed max character limit too low in dialogs history GUI - Fixed a bug where a new lore line was added to the "edit items" button on every click for the "smelt items" and "craft items" stages - Fixed an error when using "delay" reward - Quests IDs are now shown in the /quests seePlayer if the *viewer* is OP, not the *target* anymore - Fixed "player" prefix appearing before the actual player name in the {PLAYER} and {player} placeholders - Fixed AccountsHook not being properly loaded - Fixed an error when saving a "bring items" stage with more than 99 items - Fixed help command + added more syntax help **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/2.0.0...2.1.0

### Note This is a **dev build** and not a release. Please use with care! - Backup your prior data before installing: both the `/plugins/BeautyQuests` directory AND your database (if using one). - Test beforehand on a separate server than your production one. --- - Added more debug logging - Reworked quest edition experience (experimental): - Most editors that asked to write something in the chat have been replaced with [Minecraft Dialogs](https://minecraft.wiki/w/Dialog). - The editors that previously accepted the "null" keyword can now simply be left empty before the player clicks on "Validate". - Some editors have gained a "reset" button for better ergonomy. - Added indications to some complex editors (e.g. duration, regex, comparisons...) - Since dialogs text input can span multiple lines, replaced old (and bad) "multiline text editor" by this <img width="798" height="466" alt="image" src="https://github.com/user-attachments/assets/2fda54af-9906-46c6-9188-87004c9da933" /> <img width="710" height="476" alt="image" src="https://github.com/user-attachments/assets/d3d1ef4e-c41b-4295-a351-49b958f831d8" /> **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/2.1.0+build.144...2.1.0+build.151

## Note This is a **dev build** and not a release. Please use with care! - Backup your prior data before installing: both the `/plugins/BeautyQuests` directory AND your database (if using one). - Test beforehand on a separate server than your production one. ## Quest categories  - The `/quests` menu can now be organized with categories using quest pools! - There are 2 new related config.yml options: - `quests menu.categorize quests by pools` (enabled by default) - `gui.hide folder if single category` - Quest pools have 2 new related options: - Pool name, which is the displayed on the category item in the menu - An option to make the pool shown (or not) as a category in the /quests menu ## Pools - Added "start rewards" and "end rewards" options for quest pools - Added new pool-related placeholders: - %beautyquests_pool_ID_can_start% will return true or false depending on if a player can get a new quest from the pool *ID* - %beautyquests_pool_ID_remaining% will return the amount of quests not yet started or completed in the pool - %beautyquests_pool_ID_in_progress% will return the amount of quests in progress in the pool - %beautyquests_pool_ID_completed% will return the amount of quests completed in the pool - %beautyquests_pool_ID_cooldown% - %beautyquests_pool_ID_can_start_reason% - Fixed a lot of inconsistent behaviors in quest pools ## Misc. changes & additions: - Added support for Minecraft 1.21.11, 26.1 and 26.2 - **Dropped support for Spigot**, BeautyQuests is now **Paper-only** (+ forks) - Dropped support for Minecraft 1.17 to 1.19 (included) - Added SQLite support - Added FancyHolograms support - "play time" stage type now updates progress bar and scoreboard in real-time, once per second - Added `holograms.preferred plugin` config option - Moved holograms-related config.yml settings in a dedicated section - Added "show progress bars on join" config option - If enabled (default behaviour), progress bars of the active quests are shown when players log in. - Updated "automatic quest" option: - It can now have 3 states: - Disabled (the default) - Only for new players - For all players - Before this update, it was either Disabled or Only for new players. The "For all players" option is new. - Quests created with the option set to "For all players" will be automatically started for all online players and subsequent player joining the server, whether it's their first time or not. - Added (back) the `/bq reload data` command - The old `/bq reload` has been completely removed in favor of this new one. - In contrast with the old reload command, it does *not* reload configuration settings. It only reloads the quests folder and the pools file. - Allowing the quests to be reloaded during the plugin runtime required to change quite a load of loading related code. It may have created some bugs. Please avoid using this command in production. - Added "RegExp" option to the "Write in chat" stage type - This allows complete flexibility of messages to match thanks to the power of [regular expressions](https://en.wikipedia.org/wiki/Regular_expression) - e.g., /town create .+ would match any command starting with /town create - Test your regexes with https://regex101.com - Added a lot of PlaceholderAPI placeholders: - for all quest options: %beautyquests_quest_ID_OPTION%, replace ID with the ID of a quest and OPTION by an option such as name, description, cancellable... - for player-specific quest description, for instance %beautyquests_player_quest_ID_time_left% (if the Expansion is installed). - for launched quests such as %beautyquests_started_ordered_time_left% - The full list available with /papi info beautyquests ## Bugfixes - Fixed errors when clicking on an empty slot with an item in hand (potentially spamming errors) - Fixed exploit in "craft items" stage where players can advance in quests when their inventory is full by shift+clicking - Fixed "Use of Maven Central as a CDN is against the Maven Central Terms of Service" warning on startup on Paper - Fixed some errors when having custom sounds without namespaces - Fixed "remove item" action editor showing *right-click* instead of *shift+right click* - Selectors such as @a, @p, etc. are now working again in the commands - Fixed saving of quest options with "null" or "none" values (for instance, end firework or end message) - Fixed max character limit too low in dialogs history GUI - Fixed a bug where a new lore line was added to the "edit items" button on every click for the "smelt items" and "craft items" stages - Fixed an error when using "delay" reward - Quests IDs are now shown in the /quests seePlayer if the *viewer* is OP, not the *target* anymore - Fixed "player" prefix appearing before the actual player name in the {PLAYER} and {player} placeholders - Fixed AccountsHook not being properly loaded - Fixed an error when saving a "bring items" stage with more than 99 items - Fixed help command + added more syntax help **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/build/138...2.1.0+build.144

# Note This release contains a great number of changes in data storage. Thus, you would be well-advised to **backup your data before installing**: both the `/plugins/BeautyQuests` directory AND your database (if using one). 2.0.0 took a full year to be made (first commit is dated 2024/10/04). All this time is not for nothing: it laid the foundation for more flexibility in how the player data is handled, making global quests or party progress sharing possible! See the "code-wise changes" section below for more information. # Changelog ## Scoreboards * Fixed a timing issue where quests did not stay long enough in the scoreboard * No longer showing scoreboards-related errors when version is incompatible * Added quests pinning to scoreboard * Use *Shift+Left Click* on a quest in the `/quests` menu to pin it to the scoreboard. * When quests are pinned, they will be the only ones shown in the scoreboard and it will cycle among them only, without showing the non-pinned quests. * Added an `auto hide` setting for the scoreboards (disabled by default). * When enabled, the scoreboard will automatically hide itself after the set amount of seconds when no progress has been done to the quests shown on it. ## Miscellaneous * 1.21.6 to 1.21.10 support * Dropped support for versions < 1.17 and Java < 17 * Removed WorldGuard 6 support (useless since the it only supports MC up to 1.12.2) * Added a new `mythicmobs.count kill for pet owner` option to make kill made by MythicMobs pets count for their owners * Added a tooltip for "smelt items" stage to help users understand which items to put in the editor * Added a "custom ordering index" quest option to customize the order the quests appear in the `/quests` menu * Added the `questsMenu.keep menu open` config.yml option * This option, enabled by default, makes the `/quests` menu stay open after the player starts or cancels a quest * Fixed mobs or blocks editing causing "Cannot find object with UUID" errors * Updated FR, HU, RU, TH, VI, ZH translations * Renamed the `--overrideRequirements` option of `/quests start` to `--force` (and made it working) * Removed the `--id` flag of the `/quests create` command, now the quest ID is simply an optional parameter * Suppressed particles load message from the console (now only found in the log file) * Fixed integration with ZNPCs 5.2 * Made plugin no longer remapped on Paper * Updated IT and RU translations ## Code-wise * Refactored everything about the way player data is stored, for cleaner code and higher flexibility * This also means the YAML format and SQL schema have been updated * "Player Accounts" are now known as "Questers" * Questers are the basic actors in BeautyQuests * They hold data about the quests they do, and can have additional data * They can be of different types: Player (by default), Server (in the Expansion), and maybe new ones in the future * New API is present to create various types of Questers * New API is present to choose which Questers gain progress when a player does an action related to a stage (e.g. killing a mob) **Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/1.0.5...2.0.0

- Added support for 1.21.4 and 1.21.5 - Updated many translations - `minecraft:` namespace is no longer shown in the list of available block tags - Fixed issues with MythicMobs when replacing vanilla mobs - Added "dont cancel npc click" config option - Damage dealt by players are no longer counted for "deal damage" stages if in a protected region - Fixed exception when adding a 45th object in a "list" type GUI (for instance, list of mobs to deal damage to) - Added Tooltips integration - Fixed locations with world patterns not working for GPS trackers - Fixed placeholders in "Remove items" reward - Added way to disable npc check for vanilla mobs - Upgraded FancyNpcs integration - Fixed display issue in MythicMobs with Paper (with advanced formatting like `<red>Hello</red>`) - Fixed "without NBT" comparison >1.20.4 - Fixed bug with `quest_rewards` placeholder in scoreboard - Fixed name for some Oraxen items - Caught errors in countable stage - Fixed MythicMobs without names being used as NPCs

- Bugfixes in some versions - Removed SkillAPI and ProSkillAPI integrations in favor of Fabled - Added support for Minecraft 1.21(.1) - Fixed issues with world patterns resetting during quest edition - Added `/quests resetPool <pool id>` command, which works in a similar manner to the `/quests resetQuest` command: it removes all data for all players for the specified pool - Made the "keep player data" button always visible when editing a quest in the creation GUI. Its old behavior was too confusing. - Updated wrong vietnamese translation - Updated LevelledMobs integration - Added selectors (such as @a) support for `/quests scoreboard show/hide <player>` - Fixed bugs with BlueMap - Fixed bugs with WildLoaders - Fixed wrong NPC name displayed in dialog history - Fixed bug in "place blocks" or "break blocks" editor with non-item blocks (such as Cocoa) - MythicMobs can now serve as NPCs! > To be used properly that way, each MythicMob that serves as an NPC must have at most 1 active mob. If more than 1 mob are spawned, then the behavior is undefined. - Added StackMob integration to count all the mobs in a mob stack when killing them - Added configuration options for the 3 tabs of the /quests menu. You can now customize the icon and the color of the separator bar. Default values: ```yaml # - Quests Menu - # Options related to the "/quests" menu questsMenu: # Configuration of the tabs in the menu tabs: # This tab shows the quests the player has previously completed. finished: # Whether the tab will appear in the menu enabled: true # The icon in the bar at the right icon: BOOK # The color of the vertical separator (if enabled) color: GREEN # This tab shows the quests currently being done by the player. in progress: enabled: true icon: WRITABLE_BOOK color: YELLOW # This tab shows the quests the player can start. not started: enabled: true icon: PAPER color: RED ```

- Allow "none" as a message for "bring items" stage to disable the "Bring me xxx" message - Fixed wrong playername displayed when resetting player datas - Fixed exception in Particle Effect GUI - Fixed exception when having Eat/Dring stages - Fixed some issues with "Kill NPC" stage - Added some more metrics on integrations - Fixed particles that can be seen where they should not (across worlds) - Fixed issues with WorldGuard and __global__ regions - Fixed "play time" stage showing negative progress with long time spans - Fixed issues with WorldGuard showing wrong world in editor - "Breed animals" stage now works with entities that lay eggs (turtles and frogs) - Fixed UnsupportedOperationException when dropping a custom item in the GUI - Fixed "done" button in "create command" GUI not being properly refreshed - Fixed locale files sometimes being completely reset in case of syntax errors - Fixed pool start message not being sent to the command sender - Added some methods in the API to manually change a player's running stage - Fixed "bring xxx items" wrongly numbered - Added support for 1.20.5 and 1.20.6 - Fixed issues in /quests menu - Changed icons used in the right bar of the menu - Updated UltimateTimber integration to 3.0.0 - Caught some errors when loading accounts - Updated a lot of translations