ВЕРСИИ (42)

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.3 * Updated CommandAPI to 12.1.0 * Improved the plugin update checker

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.3 * Updated CommandAPI to 12.1.0

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)

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 `BaseComponent`s 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 `CompletableFuture`s #### 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-beta-1/) 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 `FakeAdvancement`s), 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/com/fren_gor/ultimateAdvancementAPI/AdvancementMain.html#enable(java.util.concurrent.Callable)) 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/Shadeable-Version) * 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