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.
Optional dependencies
PAPIProxyBridge
Any compatible version
Maintenance
Any compatible version
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }