v4.1.1: Fix `ProfileEntry#builder()` not setting the `hidePlayersHover` NullBool + use jspecify Annotations Stable

This is a small update that fixes the builder() method of ProfileEntry not setting the hidePlayersHover value for the builder.
In addition is jspecify annotations now used to mark Nullable and NonNull objects, methods, etc.

v4.1.0: Add option to hide Player list hover Stable

This update adds a new option to the ProfileEntry called hidePlayersHoverEnabled.
It accepts a NullBool and when set to true, will make AdvancedServerList hide the player list you can see on hovering the player count.

v4.0.0: New onlinePlayersCount and onlinePlayersEnabled options, change Int options to String and remove deprecated options Stable

This is a breaking release for multiple reasons:

• All the existing Integer options have been changed to use Strings. This is to allow ASL to parse placeholders in a future release.
• All deprecated methods in the ProfileEntry.Builder class have been removed.

New options called onlinePlayersEnabled and onlinePlayersCount have been added. These set the online count that should be displayed.

v3.3.0: PostServerListSetEvent Stable

This version adds a PostServerListSetEvent to the different platform Modules.

It's purpose is to act as an indicator for when AdvancedServerList is "done" with handling the event. It also provides the ProfileEntry instance that was used during the event.

v3.2.1: Don't use placeholders to define dependency versions Stable

This is a small change that only removes the use of ${api.version} placeholders in the pom.xml files for the dependencies, but also APIs.

v3.2.0: Rename methods in ProfileEntry Builder for consistency Stable

The setters in the ProfileEntry Builder have been renamed to be more consistent with the method naming of the ProfileEntry itself.
This means that instead of Builder#setFavicon(String) you now have Builder#favicon(String).

The old methods still exist but have been marked as deprecated and for removal. This will only happen on a v4 release tho, which there is no reason for it yet. It's still recommended to switch tho.

v3.1.0: New getters, setters and 1 deprecation Stable

Added

• New getters in ProfileEntry:
  • maxPlayersEnabled() - Returns the value for playerCount -> maxPlayers -> enabled as NullBool
  • maxPlayersCount() - Returns the value of playerCount -> maxPlayers -> amount as nullable Integer
• New setters in ProfileEntry.Builder:
  • setMaxPlayersEnabled(NullBool) - Sets whether the max players feature is enabled or not.
  • setMaxPlayersCount(Integer) - Sets the number to use for the max players count.
  • setExtraPlayersCount(Integer) - Replacement for deprecated setExtraPlayerCount(Integer) method.

Deprecated

• setExtraPlayerEnabled(Integer) in ProfileEntry.Builder - Typo in method name.

v3.0.0: Platform specific Server and Proxy instances Stable

This update brings some breaking changes, but also some new additions.

Breaking Changes

• Packages for the different platform-x APIs have been renamed from ch.andre601.advancedserverlist.<platform> to ch.andre601.advancedserverlist.api.<platform>
• platform-spigot was removed and instead a platform-bukkit API has been made.

Added

• GenericServer now has platform-specific extensions in their respective platform API, providing new getters to use
  • BukkitServer - Available on platform-bukkit. Provides a getWorlds() method that returns a Map<String, World> of all loaded worlds.
  • BungeeProxy - Available on platform-bungeecord. Provides a getServer() method that returns a Map<String, ServerInfo> of all registered Servers on the proxy.
  • VelocityProxy - Available on platform-velocity. Provides a getServer() method that returns a Map<String, RegisteredServer> of all registered Servers on the proxy.

Removed

• All deprecated methods in the ProfileEntry class have been removed.

v2.1.0: Changed ProfileEntry to a Record Stable

The ProfileEntry class has been turned into a record. This brings one important change, which is that the old getX methods have been replaced with their new x methods.

As an example:

• getMotd() is now motd()
• getPlayerCountText() is now playerCountText()
• etc.

To keep backwards compatability are the old getters still available, but deprecated and planned for removal in a future minor or major version (patch updates won't have them removed)

v2.0.0: Custom event support Stable

Added PreServerListSetEvent

This event is accessible through one of the platform APIs and is called before AdvancedServerList tries to alter the Server list.
It can be used to override the used ProfileEntry (Read more below) or even cancel the event resulting in no changes being made.

Added ProfileEntry

The ProfileEntry has been moved from the core module to the API. It is used to hold the different settings configured in a server list profile. You can make your own using the nested Builder class, create a Builder instance from an existing entry by using getBuilder() or just make a copy of a ProfileEntry using copy()

Added NullBool

The NullBool enum is used to set a boolean option in the ProfileEntry. It can be either TRUE, FALSE or NOT_SET if the retrieved value is not present or null.

It also has a method getOrDefault(boolean def) that returns the boolean value associated with the state used, or def if NOT_SET is used.

Changed classes to interfaces

Some classes have been changed to interfaces to make them a bit more clean.

Affected classes are:

• GenericPlayer (api)
• GenericServer (api)
• BungeePlayer (platform-bungee)
• SpigotPlayer (platform-spigot)
• VelocityPlayer (platform-velocity)

[BREAKING] Removed modules

The core module has been removed alongside the platfrom-paper one. Later one was removed since it didn't have any Paper specific features and was therefore not useful and only duplicated code.

[BREAKING] Moved GenericPlayer methods

The GenericPlayer interface now only has getName(), getProtocol() and getUUID() present. The other methods have been moved to their respective, platform-specific player instance:

• SpigotPlayer
  • hasPlayedBefore()
  • isBanned()
  • isWhitelisted()
• VelocityPlayer
  • getVersion()