Maxplayers
About the plugin
Latest Version: 1.3 for CB 1.1-R6 (compatible with CB 1.2.5-R3.0)
Description
Initially I started this project because I needed a plugin that would let OPs join a server even when it is full, so they could administrate it without kicking people. Then I rewrote the plugin to be able to set the max-players value. It does not set the real max-players value given by server.properties but uses it as the highest value possible. Regular players can join until my plugins max-players is reached. From this point, only OPs can join the server up to the servers max-players.
Features
- Set the max-players value on the go
- Ignore the player limit as an OP
- Permission support
- Different max-players values for different permission groups via permissions
- The current max-players value always shows up properly in peoples server lists
Future Plans
- Any suggestions are appreciated
Why should I use this plugin?
I can set the max-players before I start the server, you could say. Or ask Why would I want to change max-players? The answer is that Maxplayers serves as a slot-reserver for administrators, and in future versions, moderators or VIPs. Unlike other reservation plugins, Maxplayers does not kick players, or hold them off from filling the server. It rather lets Admins overload the server. By that, I mean that even if the server is full, important people may join it.
Example: The server is full. It has 20 players on it. If there are more, the server starts to lag. You have been said, that there was a griefer on the server. Now you want to undo his deeds. You simply join the server. Now there are 21 people on it. It lags, but you can undo whatever the griefer did. As soon as a player leaves the server, it stops lagging too much.
With other reservers, you would either have to kick someone upon joining the server, or the server is never full, if there are no admins or VIPs on it. With Maxplayers you can always have the maximum amount of players on the server, even if they have no reserved slots and if neccessary, you can "overload" it.
Usage
For detailed usage information visit How to use
Installation/Configuration
- Copy Maxplayers.jar file into the plugins directory of your server.
- Change the max-players value in your server.properties file to the highest value you ever want your player limit to be. The plugin can not set it higher than that value.
- Start your server.
The first time the plugin loads up, it creates the directory plugins/Maxplayers and a small configuration file named config.yml.
Configuration File
Property | Default Value | Description |
---|---|---|
max-players | 10 | Stores the maximum amount of players on a server |
overflow-message | The server is full and you just overloaded it. Please hurry up. | The message being sent to users when they "overload" a server |
Example configuration
- Go to server.properties and change the max-players value to 15.
- Start the server.
- Type /max-players 10 in the chat.
With this configuration, the server will be full when there are 10 people on it. Although it is full, OPs will still be able to join the server. When there are 15 players on the server, even OPs will be kicked on login.
Commands
Command | Parameters | Description |
---|---|---|
maxplayers | reload | Reloads the plugins configuration file |
maxplayers | Displays the current max-players value | |
maxplayers | <number> | Sets the maximum amount of players on a server |
Permission Nodes
Permission | Description |
---|---|
maxplayers.ignore | Players with this node are allowed to join the server even when it is full |
maxplayers.ignore.<number> | Players with this node may join even if there are max-players + number minus 1 players on the server |
maxplayers.set | Players with this node can use the /maxplayers command |
Possibly make this possible for a hoster to override the player limit?
Pls. UpDate to 1.4.6
@AGreenV5
I didn't touch the code for months. But I like your idea, so I will probably look into it again and try to implement it. I think I will try to create a config format in which you can define a schedule for every day and one for each day of the week that, if existent, overrides the dayly schedule. Would that be okay? Do you have any additions?
Thanks for you feedback!
I would love to see this add the ability to change max-players based on configurable times. Ideally with unlimited ability to add/change time slots.
@iksDeeh
It is not supposed to work this way. The plugin can not set the max-players value higher than the one given in server.properties. But still, attempting to set it to 50 should, in your case, set it to 10 because it is the upper limit. I will look into this.
Alright, I tested the plugin and it works just fine with CB 1.2.5-R3.0. Your problem seems to occur due to a misconfiguration. You seem to use a beta build of CraftBukkit, but I will not update to beta builds. I will only update to RBs and if neccessary.
Could you please update the Plugin to 1.2.5 R1.3? I am not able to change [as example] the max-player value to 50 if I had set 10 in the server.properties. It sends back: "[Maxplayers] max-players: 8" ;D
@kilorat2
Actually, it is meant to display "The server is full". This confuses me. I will look right into that. Also I will find a way to customize the message. Thank you for providing ideas :D
I love this plugin, but can we get the ability to customize the server full message? Right now it just prints the IP of the client to them, and I think that would confuse the heck out of my users. I'd like to have it tell people how to get a reserved slot on my server.
@Butt4cak3
excellent and no problem! :)
@ThisUsernameIsMine
You're right! We will work on it. Thank you for the feedback.
I like the idea of the plugin, but when someone tries to connect to a full server, their (ghost)name appears @ TAB playerlist :S
tested under latest 1.1-R4 build
Hi, I like this plugin!
Can you please make it so it doesn't say "You are overloading the server" when you login above the limit. I'm using it as a reserve list and it does not need to say that.
Thanks!