UltimateAdvancementAPI

You can support the development of UltimateAdvancementAPI by contributions or by [sponsoring the project on Github](https://github.com/sponsors/frengor). * Added support for Minecraft 26.2 (by [@Ariouz](https://github.com/Ariouz)) * Updated CommandAPI to 12.0.0 * Updated Libby to 1.3.2 * SQLite database is now [vacuumed](https://sqlite.org/lang_vacuum.html) at startup, optimizing the database file and reducing its disk space #### Internal changes: * Unused imports are now checked at compile time * The project now uses .editorconfig * Added project icon for IntelliJ

UltimateAdvancementGenerator

Released the new version of [UltimateAdvancementGenerator](https://generator.devheim.space/), the official generator for UltimateAdvancementAPI: * New UI and improved user experience * Supports both 2.X.X and 3.0.0-beta versions * To migrate, download the JSON data from the [old generator](https://escanortargaryen.dev/UltimateAdvancementGenerator/), log in on the [new one](https://generator.devheim.space/) and import it into a new project * You can now manage multiple projects using your Google account * Export your projects as JSON to easily share them with your collaborators * Easily insert color codes with the new widget in titles and descriptions * Other fixes and improvements The tool is still in BETA*, please report bugs and wanted features on [GitHub](https://github.com/frengor/UltimateAdvancementAPI/issues)

* Added support for Minecraft 26.1.2 * Updated CommandAPI to 11.2.0 * Renamed the mojang-mapped classifier to mojang-mapped-legacy. Starting from 26.1, both Spigot and Paper are Mojang mapped, so we now consider these versions as legacy, since they are only useful on (Mojang mapped) Paper 1.18-1.21.11 servers. * Minor improvements

* Added support for Minecraft 26.1.2 * Updated CommandAPI to 11.2.0 * Renamed the mojang-mapped classifier to mojang-mapped-legacy. Starting from 26.1, both Spigot and Paper are Mojang mapped, so we now consider these versions as legacy, since they are only useful on (Mojang mapped) Paper 1.18-1.21.11 servers. * Minor improvements

* Updated Java version to 17 * Advancement displays overhaul to allow, for example, multi-language or the usage of placeholders in displays: * Advancement displays are now abstract classes and use BaseComponents by default * Now there are three kinds of displays: * Immutable (AbstractImmutableAdvancementDisplay), which always returns the same values from the same methods (i.e., display properties never change) * Per-player (AbstractPerTeamAdvancementDisplay), which provides customized values for each player * Per-team (AbstractPerTeamAdvancementDisplay), which provides customized values for each team * Advancement constructors now accept an AbstractAdvancementDisplay instead of AdvancementDisplay * The AdvancementDisplay class is now an immutable display and can be constructed exclusively using the builder * Announcement messages now employ a system similar to advancement visibilities. For more information, see IAnnouncementMessage * Announcement messages are now customizable per-player * Tab icon, background and title are now customizable (even per-player and per-team) and independent from the root advancement * On advancement grant, toasts are now shown to every online team member by default. Use AdvancementTab.setShowToastToTeam to send toasts only to the player who completed the advancement * On advancement grant, announcement messages can be shown only to team members by using AdvancementTab.setSendAnnouncementMessageOnlyToTeam. By default, announcement messages are sent to every online player * Renamed UltimateAdvancementAPI.updatePlayer to updateAdvancementsToTeam * Removed deprecated methods * Added more team management methods in UltimateAdvancementAPI class: * createNewTeamWithOneLoadingRequest * loadAndAddLoadingRequest * addLoadingRequest * removeLoadingRequest * setTeamPermanent * isTeamPermanent * getPermanentTeams * Renamed UltimateAdvancementAPI.loadOfflinePlayer to loadAndAddLoadingRequest * Renamed UltimateAdvancementAPI.unloadOfflinePlayer to removeLoadingRequest * Removed CacheFreeingOption, ObjectResult and Result classes * Reworked MultiTasksAdvancement and TaskAdvancement * Make advancement constructors more coherent * Added AdvancementGrantedEvent * Fixed AdvancementTab.showtab sometimes being ignored * Refactored the advancement granting procedure * Reserved a prefix for namespaces and keys for internal use. For more information, see AdvancementKey.RESERVED_NAMESPACE_PREFIX and AdvancementKey.RESERVED_KEY_PREFIX * Replace callbacks in UltimateAdvancementAPI class with CompletableFutures #### Internal changes: * Massively improved the DatabaseManager * Use MockBukkit for tests * Added more tests For more details, refer to the [Javadoc](https://frengor.com/javadocs/UltimateAdvancementAPI/3.0.0… or contact us on Discord. The Wiki will be updated with the 3.0.0 official release.

* Updated to Minecraft 1.21.11 * Updated CommandAPI to 11.1.0 * Commands do not fail anymore if an advancement method throws UnsupportedOperationException. UnsupportedOperationException is thrown when granting or revoking some advancements (like FakeAdvancements), usually when they are not saved in the database. Now, when an UnsupportedOperationException is thrown, the advancement is simply ignored instead of failing the command execution #### Internal changes: * Refactored commands implementation

* Replaced usages of (the deprecated) PlayerLoginEvent on Paper 1.21.7+ * Fixed SQLite not working on 1.15-1.17.1 * Minor fixes and improvements

* Added support for Minecraft 1.21.9 and 1.21.10 * Updated CommandAPI to 11.0.0 * Updated ConfigUpdater to 2.2 * TeamLoadEvent may now provide an invalid TeamProgression, fixing a rare IllegalArgumentException. TeamLoadEvent has been deprecated for removal since 2.2.0, it is recommended to use AsyncTeamLoadEvent instead

* Added support for Minecraft 1.21.8 (by [@NickCloudAT](https://github.com/NickCloudAT)) * Updated CommandAPI to 10.1.2 (by [@NickCloudAT](https://github.com/NickCloudAT)) * Vanilla recipe advancements are now disabled separately from vanilla advancements (by [@Hydrolien](https://github.com/HydrolienF)). Vanilla recipe advancements can be disabled using the new disable-vanilla-recipe-advancements config option or using the UltimateAdvancementAPI#disableVanillaRecipeAdvancements() method. #### Internal changes: * Added config updater * Added disabled vanilla recipe advancements to bStats

* Added support for Minecraft 1.21.6 and 1.21.7 * Updated CommandAPI to 10.1.1 * Fixed a rare stack overflow error when enabling commands

* Updated CommandAPI to 10.0.1

* Added support for Minecraft 1.21.5 * Updated CommandAPI to 10.0.0 * Updated bStats to 3.1.0 * Added support for custom database implementations in the shaded version (by [CrazyDev05](https://github.com/CrazyDev05)). See [AdvancementMain#enable(...)](https://frengor.com/javadocs/UltimateAdvancementAPI/2.5.0… javadoc for more information * Improved config comments #### Internal changes: * Reworked database initialization

* Added support for Minecraft 1.21.4 * Updated CommandAPI to 9.7.0 * Fixed hex color codes not working in 1.20.3-1.20.6 * Added constructors taking a BaseComponent to AdvancementDisplayWrapper (by [CrazyDev05](https://github.com/CrazyDev05))

* Added support for Minecraft 1.21.3 * Updated CommandAPI to 9.6.1 * Updated HikariCP to 5.1.0 * Minor fixes and improvements

* Added support for Minecraft 1.21.1 * Updated CommandAPI to 9.5.3

* Added support for Minecraft 1.21 * Updated CommandAPI to 9.5.1 * Added support for hex color codes in titles and descriptions (for example using BungeeCord's ChatColor.of(new Color(0, 0, 0))) * Commands now use the ultimateadvancementapi namespace (only for 1.17+)

* Fixed a SQLite related bug

* Added support for Minecraft 1.20.6 * Added support for Mojang mapped servers: if you're running a Mojang mapped server you should download the Mojang-Mapped jar instead of the normal one. If you're shading, just add <classifier>mojang-mapped</classifier> to the UltimateAdvancementAPI dependency. For more information, see the [wiki](https://github.com/frengor/UltimateAdvancementAPI/wiki/Sh… * Refactored the Maven structure of the project to support Mojang mapped jars * Added load: STARTUP to the plugin.yml of the plugin version * Updated CommandAPI to 9.5.0-SNAPSHOT * Updated Libby to 1.3.0 * Minor improvements and fixes

* Added support for 1.20.3 and 1.20.4 * Updated CommandAPI to 9.3.0

* Fix NullPointerException on player join on 1.20.2 * Now PlayerLoadingCompletedEvent and PlayerLoadingFailedEvent are always called after PlayerJoinEvent

* Added support for 1.20.2 * Updated CommandAPI to 9.2.0 * Fixed a bug where, when loading on an unsupported server version, an error was printed to the console instead of the nicer message that was supposed to be printed

* Added support for 1.20.1 * Updated CommandAPI to 9.0.3 (by [dandan2611](https://github.com/dandan2611)) * The plugin version of the API now doesn't crash anymore when it fails to load or enable commands

* Added support for 1.20 * Updated CommandAPI to 9.0.2 * Fix SQLException: Generated keys not requested when using movePlayerInNewTeam(...) on MySQL

* Added support for 1.19.4 * Updated CommandAPI to 8.8.0

* Added support for 1.19.3 * Updated CommandAPI to 8.7.1 * Fixed AdvancementKey#VALID_ADVANCEMENT_KEY and AdvancementKey#VALID_KEY patterns. Now they recognize keys correctly

* Added support for 1.19.2 * Updated CommandAPI to 8.5.1

* Added support for 1.19 * Advancements updates are now sent maximum one time per tick to avoid sending useless packets * The method AdvancementTab#updateEveryAdvancement has been deprecated, use AdvancementTab#updateAdvancementsToTeam instead * The following utility methods has been added to the AdvancementTab class: * automaticallyShowToPlayers, which automatically shows this tab to every player just after they have been loaded * automaticallyGrantRootAdvancement, which automatically grants the root advancement of the tab to every player after they have been loaded * registerEvent, which registers an event into the EventManager of the tab * Added the following events: * AsyncTeamLoadEvent * AsyncTeamUnloadEvent * AsyncTeamUpdateEvent * AsyncPlayerUnregisteredEvent * Deprecated for removal (in the next versions) the following events: * TeamLoadEvent (use AsyncTeamLoadEvent instead) * TeamUnloadEvent (use AsyncTeamUnloadEvent instead) * TeamUpdateEvent (use AsyncTeamUpdateEvent instead) * Updated CommandAPI to 8.3.1 * The CHANGELOG file has been added on GitHub * Jenkins workspace is now cleaned after every successful build * The NOTICE file has been updated since UltimateAdvancementAPI is licensed under LGPL but it was containing GPL instead

* Fixed IllegalArgumentException thrown when AdvancementTab#hideTab(Player) is called with a player who hasn't the tab shown

* Added support for 1.18.2 * Updated CommandAPI to 6.5.4

* The Javadoc of CoordAdapter has been improved * Tests has been improved, so now more things can be tested

* Added builders for AdvancementDisplay and FancyAdvancementDisplay (by [SoSeDiK](https://github.com/SoSeDiK)) * Added CoordAdapter class, which adds support to negative coordinates for AdvancementDisplays * Added some missing @Override annotations * Added some testing utilities which makes writing tests easier

* Fixed a bug that causes advancements not showing up on Paper * Updated Libby to 1.1.5

* Added support for 1.18.1 * Updated CommandAPI to 6.5.3

* Improved failing during API enabling: * Now the AdvancementMain#disable() method can be called multiple times without throwing any error * Added a bStats chart about whether vanilla advancement feature is enabled or not * Added a bStats chart about used database type * Added AsyncExecutionException * Apache Commons' Validate class has been replaced with Guava's Preconditions * Updated Libby to 1.1.4

* Added support for 1.18 * Added in-memory database: * No connection to any database is made since the data is kept in RAM * The in-memory database is reset at every server restart/reload (reload usage is discouraged though) * It can be used for minigames which don't need to save the advancement progressions after games * Advancement announce messages are now not sent if announceAdvancements gamerule is set to true * Added a message error when an error occurs during command execution * Fixed vanilla advancement disabling issue

* Improved the Advancement Visibility System: * Added the final method Advancement#isVisible(Advancement, TeamProgression), which should help avoiding compilation errors when implementing multiple IVisibility subinterfaces. It always throws an IllegalOperationException, since it should not be called * Fixed a bug where the default method of an IVisibility subinterface was not called correctly

* Updated to Java 16 * Added multi-version support: 1.15.x to 1.7.1 * Maven project has been restructured: * Added the NMS module with the per-version code * Commands have been moved to the Commands module * Added the com.frengor:ultimateadvancementapi-commands artifact, which can be used alongside the shadeable version to add commands to the plugin * Commands now works with @a and @s selectors * /ultimateadvancementapi criteria ... command has been renamed to /ultimateadvancementapi progression ... `ultimateadvancementapi.criteria. permissions have been renamed to ultimateadvancementapi.progression.*` * Lombok has been removed * criteria has been replaced with progression in classes, fields, and methods names: * AdvancementCriteriaUpdateEvent has been renamed to AdvancementProgressionUpdateEvent * CriteriaUpdateEvent has been renamed to ProgressionUpdateEvent * ArbitraryMultiTaskCriteriaUpdateException has been renamed to ArbitraryMultiTaskProgressionUpdateException * Advancement#maxCriteria has been renamed to maxProgression * Advancement#getMaxCriteria has been renamed to getMaxProgression * Advancement#getTeamCriteria has been renamed to getProgression * Advancement#incrementTeamCriteria has been renamed to incrementProgression * Advancement#setCriteriaTeamProgression has been renamed to setProgression * TeamProgression#getCriteria has been renamed to getProgression * DatabaseManager#getProgression and UltimateAdvancementAPI#getProgression have been renamed to getTeamProgression * DatabaseManager#updateCriteria has been renamed to updateProgression * DatabaseManager#updateCriteriaWithCompletable has been renamed to updateProgressionWithCompletable * AdvancementUtils#validateCriteria has been renamed to validateProgressionValue * AdvancementUtils#validateCriteriaStrict has been renamed to validateProgressionValueStrict * MultiTasksAdvancement#ENABLE_ARBITRARY_SET_TEAM_CRITERIA has been renamed to ENABLE_ARBITRARY_SET_PROGRESSION * MultiTasksAdvancement#DISABLE_EXCEPTION_ON_ARBITRARY_SET_TEAM_CRITERIA has been renamed to DISABLE_EXCEPTION_ON_ARBITRARY_SET_PROGRESSION * The column 'Criteria' into the 'Advancements' table in the database has been renamed to 'Progression' * Added VALID_ADVANCEMENT_KEY, VALID_NAMESPACE, and VALID_KEY patterns to AdvancementKey * MultiTasksAdvancement#ENABLE_ARBITRARY_SET_PROGRESSION and MultiTasksAdvancement#DISABLE_EXCEPTION_ON_ARBITRARY_SET_PROGRESSION are now protected * Updated Libby to 1.1.3 * Minor fixes and improvements

* Added Javadoc for almost every class * Now the plugin version checks for updates at startup * Added validation for TeamProgressions: now DatabaseManager accepts only TeamProgressions that exists in cache. Old TeamProgressions are no longer accepted * Added IllegalOperationException * Default pool-size config value is now 10 * Minor fixes

* Added bStats * Added Versions utility class to handle versions

* Initial Release