AdvancedServerList

PLEASE READ BEFORE UPDATING!

This update brings various important changes alongside a known issue/limitation on Paper Servers (More below). Please make sure to read this update completely before deciding to update.

Ko-fi supporters

This update was supported by... nobody ;-; If you can, consider donating on my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any person who donated will be mentioned in the next release, if their name isn't inapropriate.

Removal of BungeeCord support

Due to recent dependency issues and the fact that a [long standing issue blocking Dialog support for ASL on BungeeCord](https://github.com/SpigotMC/BungeeCord/issues/3871) hasn't been addressed yet after almost a year, did I decide to finally drop BungeeCord support. This means that with this version onwards, will ASL only support Paper, Velocity and possibly forks of these two (If they do not bring breaking API changes). I'm sorry about this sudden change, but I simply cannot see a reason to support a dated, inefficient Proxy software like this anymore.

Paper: Known issues

The dialog system for /asl profiles edit <profile> will not display content of a profile correctly on versions prior to 26.x (Encountered on 1.21.11). I cannot currently think of a possible solution other than distribution a separate jar build using the 1.21.11 API of Paper. Dialogs seem to work fine on 26.x (Tested on 26.2).

Changes

Improvements of Commands

The commands have been organized into their own set of record classes, to allow easier maintenance and overall better organisation. Function-wise should there've been no notable changes.

26.x support

The plugin uses the 26.1.2 API of Paper and should work on these versions alongside 26.2.

Dependency updates

Several dependencies have been updated.

This is a small update that bumps the version of the ExpressionParser to v1.7.0-b1 which allows ASL to provide custom extra arguments to the parser without the need of using a hacky workaround. Additionally is the condition parsing now wrapped in a try-catch to prevent stacktraces from filling your console if someone with f.e. a wrong/malformed protocol version (A bot?) pings your server and the parser fails due to an unexpected exception. It will now only print a warning with the exception reason. When debug is enabled will it also give the Stacktrace.

Ko-fi supporters

This update was supported by... JW! If you can, consider donating to my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any donators will have their names mentioned in the next release of this plugin as a thank you. Note that I may not mention your name, if it appears to be inapropriate or otherwise indecent.

This update brings two smaller changes alongside smaller dependency updates: 1. The PAPIUtil now uses a CacheKey created from the Player's UUID and the text to parse, to properly separate individual text with placeholders to parse. This should fix errors like the Favicon option suddenly having MOTD text present, causing errors. 2. The FaviconHandler now only prints stacktraces for its errors, if the debug option was enabled.

Ko-fi supporters

This update was supported by... nobody ;-; If you can, consider donating to my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any donators will have their names mentioned in the next release of this plugin as a thank you. Note that I may not mention your name, if it appears to be inapropriate or otherwise indecent.

Before updating...

It's recommended to always make backups before updating the plugins. While I try to test features, I cannot test everything due to a lack of a proper server setup with active players on it. As such can bugs and issues appear. Always [report them on Codeberg](https://codeberg.org/Andre601/AdvancedServerList/issues) when you find them. Thanks.

This patch update fixes a bad argument length check for the date placeholder, specifically the isBefore, isExact and isAfter placeholders. This fix was done by @UninenVille. Thanks!

Ko-fi supporters

This update was supported by... nobody ;-; If you can, consider donating to my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any donators will have their names mentioned in the next release of this plugin as a thank you. Note that I may not mention your name, if it appears to be inapropriate or otherwise indecent.

Before updating...

It's recommended to always make backups before updating the plugins. While I try to test features, I cannot test everything due to a lack of a proper server setup with active players on it. As such can bugs and issues appear. Always [report them on Codeberg](https://codeberg.org/Andre601/AdvancedServerList/issues) when you find them. Thanks.

Happy new year everyone! This small update fixes a NullPointer issue reported in #537 where using /asl profiles set would give a NullPointerException. This was caused due to a missing Meta Key to set the command type (Whether it can only be used by player or also console). Thanks to @UninenVille for reporting!

Ko-fi supporters

This update was supported by... nobody ;-; If you can, consider donating to my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any donators will have their names mentioned in the next release of this plugin as a thank you. Note that I may not mention your name, if it appears to be inapropriate or otherwise indecent.

Before updating...

It's recommended to always make backups before updating the plugins. While I try to test features, I cannot test everything due to a lack of a proper server setup with active players on it. As such can bugs and issues appear. Always [report them on Codeberg](https://codeberg.org/Andre601/AdvancedServerList/issues) when you find them. Thanks.

Updates

- Fix #537 (NullPointerException for /asl profiles set)

It has been a long time since a proper release was made, so I now decided to make one and actually make it a proper release, instead of a beta, as I haven't heard about any issues with the Dialog system on Paper and consider it stable. As a quick note, I do plan to implement Dialog support into BungeeCord as a last, final update for the platform, before finally dropping support for it. But until an [annoying issue is fixed](https://github.com/SpigotMC/BungeeCord/issues/3871) am I unable to ship this feature for people to use. If you know possible causes and/or ways to fix it, maybe contribute to BungeeCord (Or this plugin if it actually is a mistake on my end) to get it fixed!

Ko-fi supporters

This update was supported by... nobody ;-; If you can, consider donating to my [ko-fi](https://ko-fi.com/andre_601) to support this project. Any donators will have their names mentioned in the next release of this plugin as a thank you. Note that I may not mention your name, if it appears to be inapropriate or otherwise indecent.

Before updating...

It's recommended to always make backups before updating the plugins. While I try to test features, I cannot test everything due to a lack of a proper server setup with active players on it. As such can bugs and issues appear. Always [report them on Codeberg](https://codeberg.org/Andre601/AdvancedServerList/issues) when you find them. Thanks.

Updates

Support for newer MC versions

Newer MC versions (1.21.11 for example) should now be properly supported by the plugin. They weren't due to dependencies, namely Adventure, not being updated, which should now be the case.

LuckPerms Addon

A new Addon, namely the [LuckPerms Addon](https://asl.andre601.ch/addons/first-party/luckperms/), has been created and is now available to use. It will provide placeholders to use in conditions to check for things such as the player's primary group, if it has a specific group or if it has a specific permission. This addon does has some downsides tho, namely the fact that LP's retrieval of User data is asynchronous, but due to various issues and limitations, the addon forces the data to be given synchronous, causing possible lag. This is mitigated by caching the data for 1 minute.

New date placeholder set

A new placeholder set named [date](https://asl.andre601.ch/profiles/placeholders/#date) is available for use. It allows you things related to dates such as getting the current date, whether it is before, excactly or after the specified date. Each placeholder accepts an optional pattern to represent the date with. As an example, ${date current dd/MM/yyyy would return 19/12/2025 for the current date of this release.

MiniPlaceholders support

This version brings (experimental) support for MiniPlaceholders on Paper and Velocity. Note that only global placeholders/tags, meaning those not requiring a player, are actively supported, as per-player tags aren't due to various limitations. Also, just as with PAPI placeholders are MiniPlaceholders tags not supported in the condition option. I do hope this feature is working well for you.

This update fixes a NoClassDefFoundError on Paper versions before 1.21.7 (Before their implementation of a Dialog API). The entire Dialog handling was rewritten in the process, making it a lot more platform-agnostic too, allowing future expansion into other platforms (Velocity) once API becomes available.

This beta introduces a new command allowing you to edit profiles ingame using the new Dialog feature, and also announces the planned discontinuation of BungeeCord support.

New Dialog-based edit feature

A new command called /asl profiles edit <profile> was added to allow editing of profiles ingame using the Dialog feature introduced in MC 1.21.6.

IMPORTANT

This feature currently only supports Paper Builds 17 and newer for 1.21.7 due to older builds not having the necessary API and Velocity having no Dialog support yet. Once Velocity provides Dialog support will it be added to the plugin.

Discontinuation of BungeeCord support

v5.7.0 will be the final version of AdvancedServerList that will support BungeeCord. I simply cannot see any good reason for keeping support given the existance of Velocity - a far superior Proxy. Note that the plugin can work on future BungeeCord versions, especially due to their attempts at keeping backwards compatability, but it's not guaranteed. This means, that once v5.7.0 has been released, there will be no future updates -including bug fixes - for it anymore.

As promised last time is here a proper release of v5.6.0 which I call the "Favicon Overhaul". This update provides significant changes to the FaviconHandler, providing a new feature in the form of Favicon merging and also a config.yml option to set how ASL should handle images with sizes that aren't exactly 64x64 pixels.

FaviconHandler improvements

The FaviconHandler has received major improvements. First of all are PlaceholderAPI placeholders now supported. Additionally was the async handling of Favicon creation simplified, as it was overcomplicated before.

Favicon merging

A new feature was added called favicon merging. With this feature are you able to combine multiple sources into a single favicon, allowing more complex, dynamic favicons to be created. To merge favicons, add new entries to the String separated by semicolons. As an example ${player uuid};border.png would first place the Player head followed by putting border.png over it. The result would be similar to this: ![image](https://codeberg.org/Andre601/AdvancedServerList/attachme…

Favicon resizing

A new option called faviconStrategy was added to the config.yml. This option allows you to set how ASL should handle Images that have a size that isn't 64x64 pixels. The default option is resize but can be changed to center and none: - center does not resize the image, but instead centers it as good as possible in the Favicon. - none does not resize the image, nor move it. The image will simply placed at 0,0, which is the top-left corner of the Favicon. With these features should you be able to create some really cool Favicons for your server.

This update adds a faviconStrategy: <string> option to the config.yml This option allows you to change how AdvancedServerList should handle images for a favicon, that do not have a size of 64x64 pixels. The following Options are available: - resize (Default): Resizes the image to fit the 64x64 pixels area. - center: Doesn't resize the image, but instead centers it as good as possible. - none: Doesn't resize nor center the image. It simply puts it at 0,0 (top-left corner of the favicon) unchanged. Note that the favicon itself is always 64x64, even if the images depicted in it are smaller. This is simply due to Minecraft requiring such a size. This option should allow some creative aproaches with Favicons, especially when combined with the favicon merging published in the previous beta. Should there be no reports of bugs or similar do I plan to publish a proper release during the next week.

This Beta brings support for PlaceholderAPI placeholders in the Favicon and a new feature of Favicon merging!

PlaceholderAPI support in favicon

For whatever reason did the plugin not support placeholders from PlaceholderAPI in the favicon option. This has been changed now.

Favicon merging

The Favicon option now allows you to merge multiple values into a single Favicon to display. To use this option, separate each part with a semicolon. Each part supports the same options as a normal favicon, meaning you can use URLs, a placeholder that turns into a player name/UUID or an image name maching one in the favicons folder. As an example, setting ${player uuid};border.png can return a favicon like this: ![example](https://codeberg.org/Andre601/AdvancedServerList/attachme… This should allow you to create more unique Favicons to display to players. Keep in mind, that each part follows the same rules as a normal favicon, meaning that images not having a size of 64x64 pixels will be resized accordingly. Also, the creation of such a Favicon is done asynchronously, similar to Favicons from a URL/placeholder. As such can it take a while for a Favicon to be displayed and may require more than one ping of the server. Please let me know about any issues you may encounter with this feature.

Fixes a NoClassDefFoundError you encounter on Paper. This was due to the fact that the cloud-paper dependency wasn't shaded into the jar itself.

This update brings three significant changes: The addition of new operands for the condition option, the move to cloud for command handling and some new commands. Please note that I tried my best in testing these changes, but given I do not have an actual server can there be bugs and issues. Please report them to me if you encounter them! Also, do note that the plugin now compiles against Java 21. But given there being no stats listing Java 16 should this not be an issue here. If it is for you, update your Java version please.

New operands

There are three new operands that can be used within your conditions: - |~ Starts with (Ignoring case) - ~| Ends with (Ignoring case) - <~ Contains (Ignoring case)

Move to cloud command framework

The plugin is now shading in and using the Cloud command framework by incendo, to have some better overall handling of commands, including improved tab completion. The /asl help command has also been changed. It now uses the MinecraftHelp class from cloud to display a list of all available commands with hover and click actions. It also allows you to provide a query to search for specific commands (Has suggestions and tab completion available).

New commands

New commands have been added to further improve the handling of profiles in the plugin: /asl profiles info <profile> This command provides you with information regarding the selected profile. The returned tree will be a representation of the profile's options, including whether they are set or not and what value they may have. Additionally do most of these options have click actions to receive a matching /asl profiles set command to set or reset the value accordingly. /asl profiles set <profile> <option> [value] This command allows you to update an option's value. What values you can set depends on the provided option (i.e. priority only allows whole number values). The options motd and playercount.hover allow you to set multiple lines by using either \n or <newline> in the text. Finally can you also leave [value] blank to reset the option to its default value, which usually is an empty String or List. Note that the returned success response has a hover for the mentioned option that shows the old and new values you have set.

This is just a small fix to add hidePlayersHover to the ignoreMaintenance option in the config.yml alongside adding the option to the default.yml file. As usual should the plugin make a backup and migrate the config.yml on its own.

This update brings two changes to the plugin, the first being a new playerCount option called hidePlayersHover and the second being a small refactoring of the command usage output.

New hidePlayersHover option

This option is part of the playerCount option, similar to hidePlayers. When set to true will it remove the list of players (or custom text if hover is used) from the player count when hovering over it. Do note that I couldn't test this option properly, as I do not have a server with players on it to test, but it seems to work. Do also note, that enabling this will automatically disable the hover option.

Smaller refactoring of the Command usage text

The commands displayed when f.e. running /asl help is now a bit more detailed in terms of hovering over it. Individual arguments will now have a hover describing their purpose. Here are some screenshots: ![Hover Example 1](https://codeberg.org/Andre601/AdvancedServerList/raw/bran… ![Hover Example 2](https://codeberg.org/Andre601/AdvancedServerList/raw/bran…

This update brings basic support for SayanVanish to the BungeeCord and Velocity versions of AdvancedServerList.

What does this mean?

Should a player be vanished through this plugin will AdvancedServerList not count it for the online player count, similar to how it did this for PremiumVanish already.

Styled Log messages

The plugin now makes use of the ComponentLogger provided by Kyori Adventure, allowing to have more styled messages. This Library was implemented into Paper around 2 years ago and into Velocity 3.2.0-SNAPSHOT. This means should you be using older versions will the plugin not function properly. BungeeCord won't use the componentlogger and therefore won't have styled log entries.

Added printBanner config option

The config.yml now has a printBanner boolean option. When set to false will the plugin no longer print the "ASL" ASCI art in the console. I personally can't see why this logo should bother you so much, but here you go if it really bothers you... As usual should the plugin automatically create a backup and migrate the config for you. If not present will the option default to true.

Reduced startup messages

The number of text printed in console on startup has been reduced. Some messages were removed, while others got moved into debug, meaning they only display when debug is enabled in the config.yml file.

Bit of an early christmas present for you all. This update provides a feature some of you have been waiting for: Center support for motd! It also has some notable changes making it incompatible with older Paper servers.

MOTD Centering

The feature is relatively simple. Start a line with <center> and the plugin will try to center it as good as possible using spaces. Example:

priority: 0

motd:
  - '<center><grey>This is <bold>centered</bold> Text!'
  - '<aqua>And I am not!'

Result: ![image](https://codeberg.org/Andre601/AdvancedServerList/raw/bran… The text is processed before centering, meaning that placeholders will be parsed first to get the actual text-width before centering. Important: Centering text uses specific hardcoded values and only supports a specific set of fonts. Namely: - Max width of MOTD is set to 270. - Spaces are set to a value of 4. - Supported fonts are minecraft:default, minecraft:alt and minecraft:uniform Because of these factors can the centering look not quite right on specific UI scales or with specific custom fonts used by the client. Nothing I can change on my end.

plugin.yml removal

I decided to remove the plugin.yml file from the Paper version of the Plugin. This means that if you were using the plugin on a version that doesn't support the paper-plugin.yml file, meaning only using the plugin.yml, this update won't work for you anymore. The paper-plugin.yml was introduced (And subsequently supported by AdvancedServerList) in 1.19 builds of Paper, tho notable breaking changes regarding dependencies were introduced in later 1.19.4 builds of Paper. To be on the safe side here will releases on Modrinth and Hangar now only list 1.20+ versions as supported.

This small update should hopefully fix an issue where a IndexOutOfBoundsException could be raised in Conditions if only using a placeholder. Truth be told, I'm not sure if this issue is fixed for good or not, as I wasn't really able to properly reproduce it. But the way I understand it is this: I had a system in place where the index (Current position in the full text) would be increased by one, if the placeholder was parsed in a condition. This had a unwanted side-effect here, where if you only used a Placeholder for the condition, it could cause the aforementioned exception. It could also happen, if the condition ended with a placeholder. As an example, here are the indexes indicated on a condition after handling the placeholder:

# This one is fine.
${player name} != "Anonymous"
              ^

# This one is Out of bounds
${player isWhitelisted}
                       ^

# This one is also Out of bounds
"Anonymous" != ${player name}
                             ^

I really hope this issue is now fixed, as I otherwise have no idea what could be the problem.

This is a small update that only changes the MiniMOTD Migrator. It now also converts "random" being set as favicon option given the recent update of allowing random favicon to be set in AdvancedServerList. Only other changes are some dependency bumps.

This update adds the option to set random as the favicon option. Doing so will make AdvancedServerList pick a random image from its favicons folder, if any are available. This can be useful for setups, where you want a randomized MOTD and Favicon without having to make profiles entries for every possible combination.

AdvancedServerList now caches the CompletableFuture PAPIProxyBridge gives for finding servers, rather than the actual result (which may be null). This should hopefully help in improving compatability of the plugin without having to block threads, causing larger delays.

Due to an oversights was hover text not being sent through PAPIProxyBridge to be parsed by PlaceholderAPI. This should now be fixed.

There is no longer a warning whenever the plugin is unable to ping a server. Other than that was there only some smaller code cleanup.

Another small fix for the BanPlugins Addon. This update fixes a wrong name for the Paper version, where the plugin expects AdvancedBans when it should be AdvancedBan.

This is a small bugfix correcting a wrongly set main class for the paper version of the BanPlugins Addon.

This is a major plugin release, meaning it has breaking changes due to API changes, making it incompatible with plugins using the v3 API of ASL.

Breaking Changes

- API was bumped to v4 due to major breaking changes: - ProfileEntry#extraPlayersCount() and ProfileEntry#maxPlayersCount() now return a String instead of an Integer. - Methods in ProfileEntry.Builder to set max and extra players count also have changed to accept Strings instead of Integers. - Deprecated methods in ProfileEntry.Builder have been removed.

Additions

- New Server List Profile Option OnlinePlayers - It allows to modify the online player count to any number value you like. - It has the same structure as the ExtraPlayers and MaxPlayers option, meaning it's under PlayerCount and has the options Enabled: <boolean> and Amount: <String> - Should an invalid number be provided will it default to the current online player counts. - IMPORTANT: Similar to ExtraPlayers and MaxPlayers influencing ${server playersMax} does using this option modify ${server playersOnline} (Except when used in Condition). It also alters the output of ExtraPlayers due to it adding x number to online players. - New ${proxy ...} placeholders were added for the BungeeCord and Velocity version of the plugin. - These allow you to retrieve the motd, online players, max players, etc. of a Server connected to the proxy. - This system uses pinging servers every 10 seconds, so it may take a while for values to update properly.

Changes

- ExtraPlayers and MaxPlayers options now accept a String instead of an Integer. - This allows the usage of placeholders that return a number. - All ${server ...} placeholders now return an empty String instead of null. - This should avoid random situations of some placeholders being treated as "invalid" despite being a supported placeholder. See [#317](https://codeberg.org/Andre601/AdvancedServerList/issues/317) for such a case. - Actually unknown placeholder values (i.e. ${server invalidValue}) will still return null and be therefore treated as invalid.

This update fixes an issue, where the FaviconHandler stores local favicons using their non-lowercased file-names, while checking for an all-lowercased filename when getting it. This means, if you had a file named Example.png would the FaviconHandler save it as such but always check for example.png, which results in it failing. This has now been fixed.

A new Placeholder called ${maintenance maintenanceEnabled} was added to the plugin. It gets registered when the [Maintenance Plugin](https://hangar.papermc.io/kennytv/Maintenance) by KennyTV is present on the server/proxy and allows you to return true or false based on if the global maintenance mode is active or not. Other than that have there mostly been some smaller code improvements to the plugin. You should (hopefully) not notice a difference.

The UpdateChecker has received some improvements to hopefully help in fixing lag and slowdowns in case the Modrinth API is down or struggling. The HTTPClient used now times out after 5 seconds of no response. In addition is the message players receive on join (if they have permissions) done inside a CompletableFuture's whenComplete(...) method, meaning the sending of the message is done outside the main thread itself, which should help reducing the load on the main thread.

This update fixes an issue, where the hover did not work when using the plugin on a 1.21 Paper Server. The reason was breaking changes within Paper's code (Which afaik go even back to the latest 1.20.6 builds) that made AdvancedServerList's way of updating the hover no longer functional. I've implemented a fix for this now. The plugin should also still work on older Server versions, but I want to emphasize that I do not guarantee this and should this old API be removed in the future, will I not implement a hacky backwards aproach but instead simply remove this old code. With that said will I still try to fix smaller issues with this hover, if they are within my skillset to do so.

This is a small update that only updates some dependencies which also adds proper support for 1.20.6 in BungeeCord (Which wasn't the case before, because apparently adventure platform bungeecord wasn't supporting it.)

This update reworks the command handling a bit while also adding a new sub-command called profiles.

Command overhaul

The command system has been tweaked to add some quality of life changes. Namely, the help command now contains hover and click actions for the listed commands, to show usage of command, permission required and description respectively, while also putting the sub-command into your chat-bar when clicking it.

Profiles sub-command

A new profiles sub-command has been added. It allows you an easier creation of new profiles. There are the following options available: - /asl profiles add <profile> - Create a new Profile with file name <profile> - /asl profiles copy <profile> <name> - Make a copy of <profile> and save it as file <name> - /asl profiles list - Show all loaded profiles. This list has hover text showing priority, condition and whether the profile is considered valid.

Screenshots

Here are some screenshots showing all the changes. ![clearcache command hover](https://codeberg.org/Andre601/AdvancedServerList/raw/bran… ![profiles command hover](https://codeberg.org/Andre601/AdvancedServerList/raw/bran…