AdvancedServerList

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 for such a case.
  • Actually unknown placeholder values (i.e. ${server invalidValue}) will still return null and be therefore treated as invalid.