ServerListPlus
ServerListPlus provides a simple but powerful configuration to customize the appearance of the server in the client's server list. It can change almost all parts of the status ping and even allows you to customize it per player.
Note: If you're using ServerListPlus on Spigot and you're not using 1.8.3 or newer you need to use special versions of ServerListPlus:
- Spigot 1.8: ServerListPlus v3.4.8-1.8
- Bukkit/Spigot 1.7.x or Spigot 1.8 protocol hack: ServerListPlus v3.4.8-1.7.X
Features
ServerListPlus provides options in the configuration for:
- Description/Motd
- Favicons (Server icons): Load from files, URLs, or use the player's head for example
- Maximum player count
- Custom player slot format
- Player Hover Message: Displayed when a player hovers the player count in the server list
- Virtual/Forced Hosts: Use a custom configuration if players ping the server by using a special IP/hostname to connect with
- Multiple entries to choose a random one from the list
- Personalize the status ping by adding the player's name to the messages
The features page in the wiki describes all features in detail.
Installation
ServerListPlus is currently supported on Bukkit, Spigot, Paper, BungeeCord, Waterfall, Canary, Sponge and as Standalone Server.
The latest release of ProtocolLib is required for most features to work on Bukkit/Spigot/Paper servers. You can download it from: https://www.spigotmc.org/resources/protocollib.1997/
- Download the plugin and copy it in your plugins folder.
- Restart your server to load the plugin.
- The configuration file is located in the plugin folder:
ServerListPlus.yml
. Please refer to the configuration page for more information. - After you have customized the configuration to your likings you can enable the plugin by executing the
/serverlistplus enable
command. The plugin will stay disabled until you execute this command.
Development Builds
> Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
You can download unsupported development builds on the Jenkins Server. Use them at your own risk.
Configuration
The configuration file is located in the plugin folder: ServerListPlus.yml
. Please refer to the configuration page for more information.
Commands & Permissions
/slp
- Display an information page about the plugin and list all available commands./slp reload
or/slp rl
- Reload the plugin configuration./slp save
- Save the plugin configuration./slp enable
- Enable the plugin and start modifying the status ping./slp disable
- Disable the plugin and stop modifying the status ping./slp clean <favicons/players/requests>
- Delete all entries from the specified cache.
If /slp
is used by another plugin you can also use /serverlistplus
instead. The permission for all commands is serverlistplus.admin
.
Statistics
The plugin is collecting some information about your server only for statistical purposes. It uses the MCStats / Plugin Metrics system to provide the collected information for everyone at the ServerListPlus page on MCStats. It is not possible to track a specific server from the collected data. This is enabled by default so if you do not want the plugin to collect information about your server, you can disable it in the plugin configuration section by setting Stats
to false
.
These are the statistical information collected from your server:
- The version of the Metrics implementation used by the plugin.
- Plugin and Server version.
- Auth mode (online mode / offline mode).
- Current player count.
-
Additional data about your host system:
- Operating system name, version and architecture.
- Number of cores.
- Java version.
Source
The plugin is completely open source and released under the terms and conditions of the GNU General Public License. You are free to redistribute and/or modify it to your likings, but please add a link to the GitHub Page of the plugin and redistribute it under a compatible license.
@bakakuroko
ProtocolLib is required for the current version available on BukkitDev. I have removed the required dependency on ProtocolLib in the latest version (not yet approved), however this will only include a very basic feature set of ServerListPlus, so you will need it anyway. I think I have removed the dependency on ProtocolLib in the installation steps, will add this again later. For now, just install ProtocolLib and it should work. :)
Sorry for the confusion.
It doesn't work....
I try to remove all other plugins to confirm if it's plugin-conflict....But it still doesn't work....
Then I try to download CB1.7.2.......But still failed....
All the errors is same..
My System is Windows 8....CPU is Intel Core i7
Following is error log:
[21:02:38] [Server thread/INFO]: This server is running CraftBukkit version git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks (MC: 1.7.9) (Implementing API version 1.7.9-R0.2)
[21:02:38] [Server thread/ERROR]: Could not load 'plugins\ServerListPlusUniversal-3.2.2_bdev.jar' in folder 'plugins'
org.bukkit.plugin.UnknownDependencyException: ProtocolLib
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:216) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.loadPlugins(CraftServer.java:355) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at org.bukkit.craftbukkit.v1_7_R3.CraftServer.<init>(CraftServer.java:317) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at net.minecraft.server.v1_7_R3.PlayerList.<init>(PlayerList.java:68) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at net.minecraft.server.v1_7_R3.DedicatedPlayerList.<init>(SourceFile:14) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at net.minecraft.server.v1_7_R3.DedicatedServer.init(DedicatedServer.java:126) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:436) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628) [craftbukkit-1.7.9-R0.2.jar:git-Bukkit-1.7.9-R0.1-10-g8688bd4-b3092jnks]
Thanks!
@Equlibryum
Add %player% in the Personalized section instead of the Default one and you need to have joined the server once to make that work.
When i do the %player%, it just says player instead of the actual name.
@Roadhog360
I cannot reproduce this, which operating system are you using (Windows, Linux, ...)? Also, would you mind pasting your configuration here together with your server log so I can see if something is wrong?
Doesn't work. No matter what, when I edit the config, it resets when I save it. Yes I have ProtocolLib for the correct version
Edit: Just followed the Wiki turotial, still won't work.
@agusztin
Thanks! Unfortunately the "Client out of date" problem is currently not fixable in the plugin due to the way how it works. I'm basicly using the outdated version display name to provide colored slots. If you use them make sure to understand the problems with this feature as stated in the wiki.
I will remove the required dependency of ProtocolLib in a future version of the plugin, however it will stay recommend to be installed anyway. I already know how to implement this, just didn't find the time for this up to now.
Hours after posting my comment I discovered that if you can put special characters.
You're one of the first to implement this feature.
You're a genius and I promise that I will donate for this work, really deserve it.
It would be a great achievement if you fix the error of "Client out of date".
And also it would be good that does not require ProtocolLib for work.
Are only suggestions, which I think would be good for the plugin.
@agusztin
Good that you have found my post how to use special characters in most YAML files. However, ServerListPlus doesn't have this issue. You can just copy+paste the special characters directly into your configuration file and save it using UTF-8 (most editors should do that automatically). It should load them without any problems, I haven't got any reports about issues with special characters.
So if you have problems with using them within your configuration please paste the stack trace here! :)
https://forums.bukkit.org/threads/special-characters-in-server-motd.213829/ Please, allow special characters in this plugin . It would be the best plugin in the world.
@Freelix2000
No, the only way to do that is IP based. If a client pings the server within the server list he isn't authenticated and doesn't send his name. I'm aware of the problems with dynamic IPs and had actually a setting to remove the name for an IP after a specified time. However, that was not working that well and I disabled this as of the latest updates.
I'm planning to improve the player name -> IP cache in a future update and I was thinking about disabling the player tracking for a specified IP if multiple players log in with an IP.
Is the name detecting IP based? I've made something similar that detects a player's name, and I've noticed a few issues as a result of dynamic IP and some players sharing IPs if they are siblings or live in the same house, and I was wondering if this plugin uses another method.
@Minecrell
Thank you!
@madtomic
Yes, but usage of the latest versions is recommend and I don't test with the old versions that often.
@daniel0964
The warning is nothing bad but the error after it is not good. You haven't saved the configuration using UTF-8 as far as I can see in the error. That's required if you use special characters.
Hey, i have following errors:
12:41:37 CONSOLE: WARN]: [ServerListPlus] [Core] Your server is using an outdated YAML version. The configuration might not work correctly.
12:41:37 ServerListPlus: [Core] Reloading configuration... 12:41:37 CONSOLE: ERROR]: [ServerListPlus] [Core] Unable to parse the configuration. Make sure the YAML syntax is correct! 12:41:37 CONSOLE: Input length = 1 12:41:38 CONSOLE: java.nio.charset.MalformedInputException: Input length = 1 12:41:38 ServerListPlus: Please fix the error before restarting the server! 12:41:38 ServerListPlus: Disabling ServerListPlus v3.2.1 12:41:38 ServerListPlus: ServerListPlus v3.2.1 disabled. ======
@B8con
Could you paste your
file? If it doesn't exist you should update your ServerListPlus version.
It doesn't enable Personalized Configuration on startup it enables the default and It says my server has an outdated yaml version. what does this mean and how can I fix it?
Can I use this on CB1.7.2-r0.3?
nvm i said not working spiggot but dident install protcollib sorry
Looks great!! Definently will be using soon keep up the good work