Description
Gallery
Changelog
Versions
BeautyQuests is a questing plugin which aims at providing a super user-friendly experience: practically nothing has to be done from the chat, except for some admin commands. All of the quest creation is done in game through an easy-to-use graphical user interface.
An unexhaustive list of features:
- +20 stage types: kill mobs, mine blocks, go to location, interact with block, tame entities...
- lot of rewards and actions: money, items, teleportation...
- many requirements to spice up your quests: experience level, region, permission...
- integration with 28 (!) external plugins: WorldGuard, MythicMobs, Citizens, dynmap...
- a dialog system with NPCs
- complex quests thanks to the branching system
- an integrated (and highly customisable) scoreboard system
- holograms above NPCs to mark doable quests
- markers on dynamic maps (dynmap or BlueMap)
- translated in many languages by the community: fr, zh, de, es, ...
- support for both YAML or DB based storage (MySQL/MariaDB/PostgreSQL)
- easily extendable by other developers thanks to the extensive API
You might wanna check the premium Expansion, which adds many unique features to your quest system such as points or objective tracking!
For more informations about commands, placeholders or tutorials, check the documentation!
All Versions
+ Add Version
[2.2.0+build.158] 2.2 - build 158
by SkytAsul on Oct 15, 2026
Download
### Note
This is a **dev build** and not a release. Please use with care!
This is a **dev build** and not a release. Please use with care!
- Backup your prior data before installing: both the
/plugins/BeautyQuestsdirectory 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
[2.2.0+build.157] 2.2 - build 157
by SkytAsul on Oct 15, 2026
Download
### Note
This is a **dev build** and not a release. Please use with care!
This is a **dev build** and not a release. Please use with care!
- Backup your prior data before installing: both the
/plugins/BeautyQuestsdirectory 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
[2.2.0+build.156] 2.2 - build 156
by SkytAsul on Oct 15, 2026
Download
### Note
This is a **dev build** and not a release. Please use with care!
This is a **dev build** and not a release. Please use with care!
- Backup your prior data before installing: both the
/plugins/BeautyQuestsdirectory 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 finishconfig.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
[2.1.0] 2.1.0
by SkytAsul on Oct 15, 2026
Download
## Quest categories
## Pools
## Quest edition
<img width="710" height="476" alt="image" src="https://github.com/user-attachments/assets/d3d1ef4e-c41b-4295-a351-49b958f831d8" />
## Misc. changes & additions
## Bugfixes
- The
/questsmenu 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="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 pluginconfig 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 datacommand - The old
/bq reloadhas 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
[2.1.0+build.151] 2.1.0 - build 151
by SkytAsul on Oct 15, 2026
Download
### Note
This is a **dev build** and not a release. Please use with care!
<img width="710" height="476" alt="image" src="https://github.com/user-attachments/assets/d3d1ef4e-c41b-4295-a351-49b958f831d8" />
This is a **dev build** and not a release. Please use with care!
- Backup your prior data before installing: both the
/plugins/BeautyQuestsdirectory 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="710" height="476" alt="image" src="https://github.com/user-attachments/assets/d3d1ef4e-c41b-4295-a351-49b958f831d8" />
[2.1.0+build.144] 2.1 - build 144
by SkytAsul on Oct 15, 2026
Download
## Note
This is a **dev build** and not a release. Please use with care!
## Quest categories
## Pools
## Misc. changes & additions:
## Bugfixes
This is a **dev build** and not a release. Please use with care!
- Backup your prior data before installing: both the
/plugins/BeautyQuestsdirectory AND your database (if using one). - Test beforehand on a separate server than your production one.
## Quest categories
- The
/questsmenu 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 pluginconfig 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 datacommand - The old
/bq reloadhas 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
[2.0.0] 2.0.0
by SkytAsul on Oct 15, 2026
Download
# 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
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
## Miscellaneous
## Code-wise
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
/questsmenu 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 hidesetting 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 owneroption 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
/questsmenu - Added the
questsMenu.keep menu openconfig.yml option - This option, enabled by default, makes the
/questsmenu 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
--overrideRequirementsoption of/quests startto--force(and made it working) - Removed the
--idflag of the/quests createcommand, 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
[1.0.5] 1.0.5
by SkytAsul on Oct 15, 2026
Download
- 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_rewardsplaceholder in scoreboard - Fixed name for some Oraxen items
- Caught errors in countable stage
- Fixed MythicMobs without names being used as NPCs
[1.0.4] 1.0.4
by SkytAsul on Oct 15, 2026
Download
- 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 resetQuestcommand: 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!
- 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
``
[1.0.3] 1.0.3
by SkytAsul on Oct 15, 2026
Download
- 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
[1.0.2] 1.0.2
by SkytAsul on Oct 15, 2026
Download
- Fixed plugin not starting on 1.8
- Fixed missing items and blocks on 1.20.3 and 1.20.4
- Fixed impossible to edit min/max values for "random rewards"
- Added support for PostgreSQL databases
- Optimized WorldGuard integration
- Added advanced "mustBeHighest" option for region requirement
[1.0.1] 1.0.1
by SkytAsul on Oct 15, 2026
Download
- Fixed "scoreboard" requirement
- Fixed some dialog lines not having placeholders parsed
- Fixed outdated migration to DB algorithm
- Fixed bugs when filling entirely a page of rewards or requirements
- Fixed errors when running the plugin on Java 8
- Updated translations
- Added Finish and Danish translations
- Added support for 1.20.3 and 1.20.4
- Scoreboard scores at the right are no longer shown in those versions
- Added some logging to understand issues with inventories
- Fixed custom mob name and minimum level not being updated in the GUI while editing mobs to kill
- Added a "DISABLED" mention to the "validation requirements" button of the "wait some time" stage
- Fixed the NPC selection editor not working for "kill mobs" stage
- Fixed error popping in console when scoreboards failed to enable
- Made plugin extra resilient to lack of data for a stage
- Added player selector support for pool start command
- Fixed dynmap integration not working
- Added offline modes to "play time" stage
- Fixed item creator GUI not refreshing properly
- Players cannot place quest items as blocks anymore
- When setting "none" as the custom stage description, the stage will no longer appear in the scoreboard if there are other stages to branch with (this allows to make hidden stages)
- Added some customization to the GUIs:
- Previous page and next page buttons can now be configured separately as two configuration settings in the new "gui" section (see below)
- You can now customize more deeply the page item, for instance, by adding custom model data to them
- Added a new configuration setting "vertical separator" that can be used to remove the column of glass pane in most GUIs. This gives 5 more slots to show objects.
yaml
# - GUIs-
# Some options related to graphical user interfaces
gui:
# Previous page item
previous page item: ARROW
# Next page item
next page item: ARROW
# Show a vertical separator made of glass pane between the items pane and the arrow buttons
vertical separator: true
``Here is an example of utilisation of the new options, as well as a texture pack and custom fonts:
[1.0_BUILD383] 1.0 dev build #383
by SkytAsul on Oct 15, 2026
Download
- Fixed issues with 1.20.2 (including scoreboard support)
- Placeholders should now be parsed everywhere
- Reworked quest selection GUI (the menu that appears when a player clicks on an NPC): the description, rewards and requirements of quests are now shown. It is also now more configurable:
yaml
# - Quest selection -
# Options related to the behavior when a player click on an NPC which has associated quests
questsSelection:
# If enabled, the "choose a quest from this NPC" GUI will not open if there is only 1 quest attached to the NPC
skip gui if only one quest: true
# Hide quests from the GUI if the requirements are not met
hide quests without requirement: true
`
- Fixed blockdata editor not working
- Fixed particle GUI not showing up-to-date data
- Fixed
not working properly when clicking on an NPCFixed /quests edit` not working properly when editing a quest with branches
[1.0_BUILD380] 1.0 dev build #380
by SkytAsul on Oct 15, 2026
Download
# Changelog
### Code-wise:
### Misc. changes:
# Warnings
This is a beta. Because there are more than 30'000 lines of code that has changed, *precaution must be taken*. Do *not* use this version on a production server. Make a backup before upgrading. Expect your integrations to break. Extensions will break (BeautyQuestsAddon for instance, but I'm working with its author to update is quickly). Once you've upgraded to 1.0, you *cannot* go back to 0.20 or 0.21.
If you are using the expansion, PM me so I'll send you a compatible version.
I did my best to make all migrations happen automatically, but some points of caution must be taken:
### Code-wise:
- Completely separated the api, the features and the integrations in different modules. This will help future development, and will make extension development easier for external developers.
- Rewritten most of the plugin to allow more flexbility in future features. This means cleaner code, less bugs and hopefully a performance boost!
- Deployed javadocs and sources artifacts of the API on the Maven repository
- Having an NPC plugin is no longer mandatory** to use BeautyQuests :) This means anybody can now simply download the plugin and run it without any dependency to add.
- You can now have NPCs from **multiple NPCs plugins**. For instance, some of your NPCs come from Citizens, and some others from ZNPCs.
- all stages that have some kind of progress can now have a progress bar (e.g. "eat food", "craft items" or "play time")
- you can now configure much more finely the description of stages with progress in *config.yml*
- added integration for ZNPCsPlus
- upgraded support for ZNPCs from 3.6 to 4.2
- All placeholders in strings are now named and no longer indexed.
- For instance:
Level {short_level} for {job_name}replacedLevel {0} for {1} - This is 1. much more easier to understand when translating the plugin
- And 2. an amazing thing to allow much more personalized messages, because there are now many different placeholders for every message.
- By popular request, the remove button for rewards and requirements from middle-click to shift + left-click :)
- Added a way to configure the reason sent in the chat when a player wants to start a quest but does not meet a requirement
- Added a way to configure the description of rewards and requirements in the quest description shown in the menu
- Fixed issue with requirement reason order
### Misc. changes:
- The GPS integration has been removed and is now a tracker in the expansion
- The
skillAPIoverride*config.yml* option has been deleted. Instead, a new reward type has been created: "SkillAPI XP Rreward" - Placeholders are now parsed by default in command rewards
- Checkpoints are now using the "quest flow" feature to follow the path players have taken during the quest
- Changed middle-click to shift-left-click to remove items from GUIs
- Added
%beautyquests_quest_restartable_ID%placeholder to get whether a quest is restartable or not - Added support for 1.20, 1.20.1 and 1.20.2
- Added MMOItems item comparison
- Fixed multiple exceptions
- Fixed an issue with the "parse placeholders" option of "write in chat" stage not working
- Added "max messages per history page" dialog option in *config.yml*
- Changed some quest pool give logic, this will probably fix issues with the "avoid duplicates" pool option. This will also allow users to use the "yes/no" GUI to accept or not quests from the pool!
# Warnings
This is a beta. Because there are more than 30'000 lines of code that has changed, *precaution must be taken*. Do *not* use this version on a production server. Make a backup before upgrading. Expect your integrations to break. Extensions will break (BeautyQuestsAddon for instance, but I'm working with its author to update is quickly). Once you've upgraded to 1.0, you *cannot* go back to 0.20 or 0.21.
If you are using the expansion, PM me so I'll send you a compatible version.
I did my best to make all migrations happen automatically, but some points of caution must be taken:
- some strings will look weird, because of the placeholders system that has changed. Your best bet is to **completely delete the /plugin/BeautyQuests/locales** directory before upgrading.
- because you can now have multiple NPC plugins, the format in which the npc ids are stored has changed. Migration should happen automatically, but you may have some warnings in console if NPCs are nowhere found.
- as previously stated, the
skillAPIoverrideoption has been deleted. If you've been using it, you must therefore replace your "vanilla" XP rewards with the new SkillAPI XP reward. - many options in *config.yml* have been renamed or moved. It should happen automatically but... who knows? Backup config.yml as well!
[0.20.1] 0.20.1 release
by SkytAsul on Oct 15, 2026
Download
- Changelog:**
- Added support for 1.19.3 and 1.19.4
- Added lot of debug logs for player data loading
- Updated lot of translations, added Brazilian Portuguese translations
- Added the {3} placeholder for stageDescriptionItemsSplit.amountFormat config option. It represents the progression as a percentage.
- Added "skip npc gui if only one quest" config option, which defaults on "true"
- Added "hide unknown quest placeholders" scoreboard config parameter, which allows to hide lines such as ones containing the {quest_time_limit} placeholder from the Expansion when the current quest does not have a time limit
- Made block type name customizable for Mine/Place blocks stages.
- Helpful when using block tags such as minecraft:iron_ores, now you can have the counter with a pretty name such as "Iron Ores".
- Refactored how stage with progression work internally (kill mobs, eat/fish/enchant/melt items, place/break blocks).
- Code is now cleaner and will allow more customization in the future.
- Migration will happen automatically.
- Once quests are migrated, there is no way to come back unless you restore a backup.*
- Updated "kill mobs" and "mine/place blocks" stage edition GUIs to allow more than 8 mobs.
- Added "ItemsAdder ID" item comparison for "bring/craft/melt/enchant/fish/eat/drink items" stages
- Added "none" keyword to the "asking message" editor for "bring items" stage
- Internally reworked data management to be handled fully asynchronously => it will prevent the server from crashing when the database connection is lost :)
- Added the /quests pools start <player> <pool> command
- Moved /quests resetPlayerPool to /quests pools resetPlayer
- Fixes:**
- Fixed issues in 1.8
- Fixed "quest limit" feature not working correctly
- Fixed issues with "quest stop" reward for branches
- "region exit" stage is now working correctly with WorldGuard 7
- Fixed WildStacker on 1.8
- Fixed bugs with "fill buckets" stage
- Fixed scoreboard not being used at its full width
- Fixed hex colors not working in scoreboard
- Fixed equipment requirement not checking item amount
- Added database auto-reconnect option
- Potion of the Turtle Master is now correctly displayed in stage description
- Made logger file encoded in UTF-8
- Improved TPS by a lot when using znpcs
- Full Changelog**: https://github.com/SkytAsul/BeautyQuests/compare/0.20...0.20.1
[0.20.1_347] 0.20.1 dev build #347
by SkytAsul on Oct 15, 2026
Download
- Added support for Minecraft 1.19.3**
- Fixed an issue with interact stages on 1.8 preventing users from saving quests
- Fixed "quests limit" feature not working
[0.20.0] 0.20 release
by SkytAsul on Oct 15, 2026
Download
- Fixed BlueMap and dynmap not being properly disabled if the config values are empty
[0.20.0.345] 0.20 dev build #345
by SkytAsul on Oct 15, 2026
Download
First release on modrinth!
Difference with dev build #344:
Difference with dev build #344:
- Added LevelledMobs integration
- You can now choose the target level of mobs to kill from the MythicMobs and LevelledMobs plugins
- Added WildStacker integration: when killing a whole stack of entities, all of the mobs are now counted for the quest
