Quests

Hello everyone,

This update adds a bunch of new features including: new task types and improvements to existing ones, support for the experimental Folia, a new quest item type, bossbar / actionbar support, and several bug fixes.

Provisional support for the Folia project has been implemented. Folia is a fork of Paper which adds "regionized multithreading" to the server; Quests should now be able to make use of this new multithreading system.

A new BossBar and ActionBar system as been added, which will allow you to display task progress and progression through both these methods. This can improve player experience by not requiring them to open the quests menu to see how close they are to completing a task. This system uses a new set of placeholders called "progress placeholders", whose purpose is to represent the progress for each task. For now, these must be manually set per quest, but in the future there are plans to automatically provide template strings for each task type, removing the need for manual configuration.

There are 9 new task types: blockitemdropping, projectilelaunching, pyrofishingpro_fishing, ecomobs_killing, znpcsplus_interact, znpcsplus_deliver, servernpc_interact, servernpc_deliver, and pinataparty_hit. The configuration for these tasks can be found on the wiki. In addition to new tasks, there are some fixes and improvements to exiting ones, such as: async support for placeholderapi_evaluate task type, better support for smithing task type, farming and position task type reworks, better mode detection in walking task type, and more.

Finally, some other miscellaneous improvements to highlight are: a new ItemsAdder quest item, time-limit placeholder, addition of "cancelcommands" option in quests, support for namespaced sounds, an improvement error messages, support for '_' and '-' in quest and task IDs, PlaceholderAPI support for GUI titles and fixes, and per-menu GUI trimming options. For a full list of changes, please review the commit log below.

A special thanks to the following people on GitHub for their contributions, they have made up the bulk of this update and without them then these changes would not have happened: Krakenied, Elikill58, NahuLD, svaningelgem, and AfkF24.

Commit log since v3.14.2

593d3af - Add ItemsAdder quest items <LMBishop>
b721847 - Add some config <Elikill58>
e5c0237 - Add support for Folia <NahuLD>
3448146 - Fix issues and wrap up work <NahuLD>
63d8c6b - Remove unused region scheduler <NahuLD>
481773d - Add missing scheduler wrapper methods for future usage <NahuLD>
af949f2 - Fix quest controller ignoring count-towards-limit <LMBishop>
548deb8 - Actually fix counts-towards-limit <LMBishop>
104e1f6 - Fix issues with delay ticks for Folia scheduler <NahuLD>
ae262e0 - Add time limit placeholder (closes #524) <LMBishop>
0f5ccf8 - Make placeholder always return no tracked quest <LMBishop>
86a365d - Add allow negative progress option to mining task <LMBishop>
d8c0362 - Alternative task constraints implementation <Krakenied>
ffa6b7d - Update task types to the new impl <Krakenied>
0d81659 - Some refactor Use new constraints impl <Krakenied>
8642fec - Add alternative raw value ctor <Krakenied>
0b0cd61 - Add alternative single constraint ctor <Krakenied>
dc25526 - Remove finals to keep the project code style <Krakenied>
3e677ae - Clean project and update gitignore <Elikill58>
0de1838 - Remove bungee in gradle <Elikill58>
95d5363 - Add bossbar and full track advancement <Elikill58>
fa3e19f - Fix error <Elikill58>
b30c24a - Add actionbar <Elikill58>
b6802d4 - Prevent possible issue <Elikill58>
ee4e229 - Change default values <Elikill58>
541d53f - Fix 0/1 value <Elikill58>
a67162a - Better support for smithing task type in 1.20 <Krakenied>
edfc159 - Rewrite position task type <Krakenied>
816be92 - Fix build after rebase <Krakenied>
953ca7e - Get rid of tabs <Krakenied>
93e7821 - Fix not deleted bossbar <Elikill58>
a101ba1 - Add missing import <Elikill58>
c7c9acf - Rewrite & optimize boss bar <Krakenied>
1cbede7 - Add dedicated progress placeholders section <Krakenied>
78f8118 - Rewrite title and action bar handles Add hex support to action bar (Paper only feature) <Krakenied>
ae484b6 - Optimize and organize imports <Krakenied>
7f4b9d3 - Add block item dropping task type Closes https://github.com/LMBishop/Quests/issues/544 <Krakenied>
29d15b2 - Organize imports in common project <Krakenied>
41e6964 - Clean up task type registration <Krakenied>
43812ea - Optimize send track advancement method more <Krakenied>
b94b596 - Fix up task type manager <Krakenied>
68010d3 - Add and remove players from the boss bar synchronously <Krakenied>
b462fe2 - Farming task type rework Closes https://github.com/LMBishop/Quests/issues/548 <Krakenied>
15011f6 - Make boss bar color and style customizable <Krakenied>
157a13f - Detect the server version using a long-standing API <Krakenied>
c9d978f - Additional online check in inventory task type Fixes NPE on logout <Krakenied>
ba56278 - [ci-skip] Update Gradle wrapper <Krakenied>
9206827 - Remove expired links from docs <LMBishop>
af2b1f2 - Dynamic boss bar style and color support <Krakenied>
3f22618 - Better required amount detection <Krakenied>
9aa600d - Add cancel commands Partially closes https://github.com/LMBishop/Quests/issues/558 <Krakenied>
9043a4d - Improve item getters Implement separate skull getters <Krakenied>
8ddb69a - Schedule inventory check at location to avoid weird behaviour <Krakenied>
af711c9 - Add PyroFishingPro fishing task type <Krakenied>
d7f1c29 - Nullable block interact task type support <Krakenied>
25d27b2 - Remove unnecessary method calls <Krakenied>
5facd15 - Add useful method overloads <Krakenied>
1b44d06 - Implement projectile launching task type <Krakenied>
5b61fc4 - Fix walking task type not detecting horse mode <Krakenied>
25a2d1a - Bump Gradle wrapper to 8.5 <Krakenied>
ee59747 - Bump checkout and setup-java actions to v4 Improve workflow run condition <Krakenied>
98e55ac - Fix CoreProtect delay caused by queue Closes https://github.com/LMBishop/Quests/issues/162 <Krakenied>
369ded8 - Add namespaced sounds support Closes https://github.com/LMBishop/Quests/issues/585 <Krakenied>
554bb10 - Add namespaced types support to the 1.14+ item getter <Krakenied>
a55916d - Do not try to load tasks with unresolved task type Closes https://github.com/LMBishop/Quests/issues/583 <Krakenied>
e6f0d05 - Add FabledSkyBlock 3 support <Krakenied>
3551c1e - EcoMobs support <Krakenied>
b1bf539 - Add WildStacker support to mob killing and breeding task types Closes https://github.com/LMBishop/Quests/issues/584 <Krakenied>
a184e76 - Also allow '_' and '-' to be used as "characters". <svaningelgem>
65f0ad3 - Reverting back to for-loop because of performance considerations. <svaningelgem>
454c8d4 - List all available categories when you encounter a missing one. <svaningelgem>
597086d - camelCase the variable name. <svaningelgem>
2c96d1a - Add PlaceholderAPI support in GUI titles <AfkF24>
c5f63c4 - Set back button to correct slot if GUI trim is off <AfkF24>
b2918ae - Fix quests occupying pagination row slots <AfkF24>
af1a539 - Add GUI trimming options per GUI type <AfkF24>
e356e1c - Support custom elements in started quests menu <AfkF24>
48ee7a6 - Add async and refresh-ticks options to PAPI task type <Krakenied>
832e99c - Ensure that custom menu element commands are ran from Folia GlobalTickThread Closes https://github.com/LMBishop/Quests/issues/601 <Krakenied>
3c354a0 - Update documentation for release 3.15 <LMBishop>
df3263b - Add ZNPCsPlus support <Krakenied>
4cdb262 - Add ServerNPC support <Krakenied>
399dd21 - Handle empty names in another way <Krakenied>
704ece3 - Do not send track advancement for PAPI task type as it behaves really weird <Krakenied>
0229544 - Add ServerNPC and ZNPCsPlus interact task types too <Krakenied>
604537b - Use current hologram data for ServerNPC task types <Krakenied>
bb6a273 - Another compatibility requirement for ServerNPC tasks <Krakenied>
0cc6541 - Add PinataParty support Closes https://github.com/LMBishop/Quests/issues/518 <Krakenied>
c650dfb - Remove unnecessary classes from IridiumSkyblock JAR to reduce its size <Krakenied>
b636bef - Update documentation <LMBishop>
2343ebc - Bump version number <LMBishop>

More information

• Documentation: https://quests.leonardobishop.com
• Report a bug: https://github.com/LMBishop/Quests/issues
• Contribute to Quests: https://github.com/LMBishop/Quests/pulls