Mineforgian
AdvancedServerList
A plugin to display a custom MOTD, Player count text, player count hover and Favicon using conditions and priorities.
- Загрузки
- 93K
- Подписчики
- 201
- Обновлён
- 3 июля 2026 г.
- Лицензия
- MIT
Опубликован 14 августа 2022 г.
AdvancedServerList is a plugin designed to allow the largest possible customization for your server's appearance in a Player's multiplayer screen.
The plugin offers extensive customization including changing the MOTD, player count text, player count hover and favicon of your server. All while also allowing you to create multiple profiles with priorities and conditions to set when a specific profile should be displayed.
Supported Platforms
Server List Profiles
A Server List Profile is a single YAML file located in the plugin's profiles folder. It contains settings that allow you to modify the server's appearance within a Player's multiplayer screen.
Priority and Conditions
Each file has a priority and optional condition. The priority is used to determine what file AdvancedServerList should use first - starting from highest number to lowest - with conditions being used to set when the profile should be used.
Once a profile has been found with a condition returning true - which is the default should there be no condition - will AdvancedServerList use said profile.
Read more about Priority and Conditions
Placeholders
AdvancedServerList supports two sets of placeholders. The first one being its own placeholders using the ${<type> <values>} format adobted from BungeeTabListPlus and the second one being placeholders from PlaceholderAPI using its %<identifier>_<values>% placeholder format.
Note that internal placeholders can be used in all text-based options of a profile, while PlaceholderAPI placeholders can be used in all text-based options except the condition one.
As a final note can plugins provide their own placeholders to use within AdvancedServerList by using its API.
Read more about Placeholders
Formatting
AdvancedServerList utilizes the MiniMessage formatting to handle colors and formatting of text. This option was chosen over legacy formatting - using & character - for being more clear and readable in its design, not to mention having an easier way for more complex features such as RGB gradients.
Read more about Formatting
Dependencies
AdvancedServerList soft-depends on the following plugins, meaning their inclusion is not required.
| Plugin | Supported Platforms |
|---|---|
| PlaceholderAPI | Paper |
| ViaVersion | Paper |
| PAPIProxyBridge | BungeeCord, Waterfall, Velocity |
| Maintenance | Paper, BungeeCord, Waterfall, Velocity |
Statistics
The plugin sends statistics to bStats to show.
You can disable the sending of statistics in the global bStats config located inside /plugins/bstats/.
You can find the bStats pages of the plugin for the following platforms:
External Libraries
External libraries can be downloaded by the plugin for various reasons explained below.
You can find these libraries within /plugins/AdvancedServerList/libs/. Unless stated otherwise should these libraries not be deleted as they may provide core functionalities for the plugin to use.
Adventure libraries
These libraries are downloaded by the BungeeCord version of the plugin to provide support for MiniMessage formatting withing BungeeCord chat components.
Configurate
The YAML version of Configurate is downloaded by the BungeeCord version of the plugin to provide support for its Configuration files.
Additionally can the HOCON version be downloaded should the /asl migrate MiniMOTD command be executed.
The HOCON version of Configurate can be removed after a server/proxy restart, as it is only loaded and used during the migration process.
Transitive Dependencies
Additional dependencies may be downloaded when resolving the previously mentioned ones. Please check the console and the linked projects for further info on these transitive depdenencies.
Videos
Below can you find a collection of videos made for my plugin. If you made a video and it isn't shown here, let me know and I'll add it.
Click to show/hide Videos
english Video by KasaiSora
Spanish Video by Ajneb97
Indonesian Video by faajrikha
German Video by Finni Gamer
Screenshots
Support
Ченджлог
5.9.0Релиз26.1.1, 26.1.2, 26.2 · 3 июля 2026 г.
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 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 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.
5.9.0Релиз26.1.1, 26.1.2, 26.2 · 3 июля 2026 г.
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 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 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.
5.8.0Релиз26.1, 26.1.1, 26.1.2 · 3 мая 2026 г.
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 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.
5.8.0Релиз26.1, 26.1.1, 26.1.2 · 3 мая 2026 г.
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 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.
5.8.0Релиз26.1, 26.1.1, 26.1.2 · 3 мая 2026 г.
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 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.
5.7.3Релиз1.21.9, 1.21.10, 1.21.11 · 20 марта 2026 г.
This update brings two smaller changes alongside smaller dependency updates:
- 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.
- The FaviconHandler now only prints stacktraces for its errors, if the
debugoption was enabled.
Ko-fi supporters
This update was supported by... nobody ;-;
If you can, consider donating to my ko-fi 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 when you find them. Thanks.
5.7.3Релиз1.21.9, 1.21.10, 1.21.11 · 20 марта 2026 г.
This update brings two smaller changes alongside smaller dependency updates:
- 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.
- The FaviconHandler now only prints stacktraces for its errors, if the
debugoption was enabled.
Ko-fi supporters
This update was supported by... nobody ;-;
If you can, consider donating to my ko-fi 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 when you find them. Thanks.
5.7.3Релиз1.21.9, 1.21.10, 1.21.11 · 20 марта 2026 г.
This update brings two smaller changes alongside smaller dependency updates:
- 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.
- The FaviconHandler now only prints stacktraces for its errors, if the
debugoption was enabled.
Ko-fi supporters
This update was supported by... nobody ;-;
If you can, consider donating to my ko-fi 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 when you find them. Thanks.
Комментарии
Загружаем…