ServerListPlus Minecraft Plugin
Last modified on Feb 27, 2023 in Plugins
By Dalton Whalen
When creating and running a Minecraft server, customizing its looks can be vital for keeping players interested. Whether it’s a unique server icon or a personalized message of the day, these can be helpful but are oftentimes limited in what can be changed. This issue is rectified thanks to ServerListPlus, a Spigot plugin that allows you to adjust the various aspects of your server’s appearance in the multiplayer menu. With the ability to add multiple MOTDs, custom icons, and even set messages in the online player count, there are tons of possibilities with this plugin. With this in mind, we have created this Apex Hosting tutorial to help you get started with ServerListPlus.
- Visit the ServerListPlus Spigot page.
- Near the top-right, press the blue
- Save the file to a safe location for later, as it will be needed shortly.
- Navigate to the Apex panel page, then stop the server.
- Scroll down to the
Game Filesection, then open the dropdown menu.
- Ensure it is running a plugin-compatible version, such as PaperMC or Spigot.
- Afterwards, enter the
FTP File Accessfrom the left-hand menu and log in.
- Enter the
pluginsfolder and then press
Uploadin the top-left.
- Drag + drop the plugin .jar files into the right-hand side.
- Once at 100%, return to the main panel page.
- Restart the server to load up ServerListPlus and ProtocolLib.
How to Get Started
Upon connecting to your server for the first time, the plugin will be loaded but will not be enabled by default. In order to allow the plugin to function, you will need to use the /serverlistplus enable command from in-game. Once done, a message will appear in-game letting you know that the plugin has been successfully enabled.
You can check the default configuration settings by disconnecting from the server to access the server list menu. Here you should see that your Message of the Day has been changed to a new message. Additionally, hovering over the player count number will display an extra message.
The default messages are likely not what you want to display on your server. To remedy this, the plugin can be customized to suit your needs.
Accessing the Configuration File
In order to adjust the plugin messages to your liking, you will need to edit the plugin’s configuration file. This will allow you to edit the two messages and even the server icon.
- From the Apex panel, stop the server and wait until it is fully offline.
- Return to the
FTP File Access, then navigate to
- Locate the
ServerListPlus.ymlfile, then press
Editto the far-right.
- Make the desired changes using the below info, then press
- Once prompted, restart the server to load up the changes.
Adjusting the Config
Within the Status section of the config file, there are two main areas to edit. The Default messages are displayed for a user who has never joined the server or their username is unknown. The Personalized messages are for a user who has joined the server at least once.
The text that appears as the MOTD within the server list. These can use color codes, placeholders, and more. Additionally, multiple descriptions can be added and will randomly display whenever the in-game server list is refreshed.
Displays a message when the player count is hovered over with the mouse. This can also be customized using the various settings provided previously.
If added to the configuration file, allows you to adjust the server icon to a variety of settings. These include adding multiple images, using image folders, image URLs, player skins, and more. For the full information on this, consider visiting the wiki.
Once you have saved the file, use /serverlistplus reload from in-game or the same command in the server console without a
/. Once you refresh the server list page, you should find your new changes have taken effect. If you have added multiple messages, you can continuously refresh to see the others.
The enable command does not work:
If the command is not registered from in-game, use
/plugins to confirm whether or not the plugin is listed. If not, ensure the files were uploaded directly into the plugins folder, as they will not function elsewhere. After this is fixed, restart the server to try to enable the plugin features once again. If the plugin is listed, ensure you are a server operator to gain access to all commands.
I receive an error when saving the configuration file:
After editing the configuration file, you may receive a formatting error when attempting to save. Press
Cancel and check your file to find where the red
X is listed. If it is under a section you have edited, ensure you have all the necessary spaces and apostrophes. Otherwise if it is under a section that was unchanged and it looks correct, you can save the file anyway and reload as normal.