AdvancedServerList

This is a bug fix release that only affects the Velocity version of the plugin.

I accidentally left in a relocation for Configurate - config library used - for the Velocity version, causing a NoClassDefFoundError to appear on enable. This should be fixed now.

If you still get such errors, make sure to use the latest Velocity jar file, as the one you use might be outdated and not have the necessary classes.

This is a Beta release. Make backups of your plugin configuration for safety.

This update brings significant changes to how AdvancedServerList is handling conditions.

The old conditions system, while functional, had one main flaw, which was that all listed conditions are ANDed, meaning only if all are true will the profile be displayed. This is rather limiting in terms of making complex conditions and requires you to make duplicate profiles, if you want to display the same content for multiple possible conditions.

With this update, the old conditions options is being deprecated in favour of a new option called condition. Unlike the old option is this one using a single string. Said string can contain multiple conditions and special operands such as and or or to make more complex expressions. The system was taken from BungeeTabListPlus, which uses it to parse their own complex conditions.

Be aware that while I did some basic tests, including some with placeholders, can I not guarantee that this is working flawlessly (Hence this being a beta). This is why I want you to report any issues you encounter with this system in my Discord Server, so that I can try to fix it.

The documentation has been updated with the new condition option, including all available operands.

This is a small update that adds a debug option to the config.yml of AdvancedServerList.

The plugin should automatically migrate your old config to the new version. A backup will be made for safety. Also, comments will be removed through the migration.

Long time no update ey?

This update brings an important change to the project. Namely, the Spigot platform will no longer be supported by AdvancedServerList.
There are many reasons, but the main one is, that I don't like having to rely on a 3rd-party plugin for features that other servers provide out of the box. It stops my plugin from working on newer versions on Spigot because I have to wait for the dependency to update, which may also bring breaking changes, making it possibly incompatible with former server versions.

The plugin will now print a huge warning and disable itself should it not detect specific classes present in Paper, so make sure your server is paper-compatible.

Other changes

There also were some other changes. One is in fact a breaking one and related to the ${server ...} placeholders.
Previously, the ${server playersOnline} would allow a space-separated list of server or world names to count the players in and display.
Issue is that I messed it up and didn't really split the string up at the spaces (Or rather I limited it to two parts: playersOnline and whatever followed it afterwards). Also, using spaces feels weird... So I now changed it to split at commas.

This means that instead of ${server playersOnline lobby1 lobby2} the new syntax would be ${server playersOnline lobby1,lobby2}

This update brings some signifcant changes to the placeholders provided by AdvancedServerList to use in PlaceholderAPI.
If you use %asl_extra_players_max% read this changelog carefully as it has important news for you.

New placeholders %asl_playercount_maxplayers% and %asl_server_maxplayers%

2 new placeholders have been added, each providing their own kind of functionality.

• %asl_playercount_maxplayers% will return the value of playerCount -> maxPlayers -> amount. This value can return null, so keep this in mind.
• %asl_server_playersmax% will return the effective output of ${server playersMax}. This placeholder is meant as a replacement for %asl_extra_players_max%'s old behaviour (Read below for details)

Changes, deprecation and future replacement of %asl_extra_players_max%

This placeholder is planned to be removed in the next release, but for now still exists for you to use. There is however a new placeholder that will take its place, which is %asl_playercount_extraplayers%.

The change was made to keep it consistent with the profile structure itself.

Another important thing to note is, that this placeholder (And its deprecated counterpart) will no longer return <online players> + <extraPlayers amount> but instead just the value of playerCount -> extraPlayers -> amount.
This value can return null so keep that in mind.

To keep using the old behaviour, use %asl_server_playersmax% instead.

This update adds a new feature to the server list profile. This also includes changes to the API.

Note about 1.20.2

I am aware that 1.20.2 is available now. And I'm confident that my plugin works on BungeeCord and Velocity, and also will work on Paper once they publish first updates.
However, Spigot is not supported yet, which is due to the plugin's dependance on ProtocolLib which has yet not received any update for 1.20.2 from what I know.

New maxPlayers option

The server list profile now supports a new section called maxPlayers. It is part of the playerCount section and behaves similarly to the extraPlayers section.
The difference here is, that the number you provide is used as the max player count to display while extraPlayers adds it to the online players and uses that for the max player count.

Note that extraPlayers takes priority over this new option, so if you want to use maxPlayers, you have to disable or remove extraPlayers.

Example configuration:

priority: 0

# We use just colour to hide the MOTD
motd:
  - '<grey>'
  - '<grey>'

playerCount:
  maxPlayers:
    enabled: true
    amount: -1

Result:

API updated

The API has been updated to v3.1.0. It includes support for the above mentioned maxPlayers feature but also a deprecation.
Please read the v3.1.0 changelog for details.