SimpleReserve
SimpleReserve
Simple, easy-to-use Reserve slot plugin
Tired of not being able to offer VIPs reserved slots or being unable to join your own full server? SimpleReserve provides an easy way to add that functionality with bukkit permission support.
Features
- Simple to use reserve slots plugin with bukkit permission support
- Provides functionality for 2 reserve slot methods:
- Full method: Users with 'simplereserve.enter.full' may enter past the imposed player limit
- Kick method: Users with 'simplereserve.enter.kick' may enter a server when full by kicking the first player found that is able to be kicked. Users with the 'simplereserve.kick.prevent' permission are immune to being kicked(Utilize inheritance!)
Config Overview
The config file for SimpleReserve is very simple and will be auto-generated on first run. The file should contain:
reserve: type: both full: cap: 5 reverttokick: false kick-message: Kicked to make room for reserved user! full-message: The server is full! reserve-full-message: All reserve slots full!
Types:
- full - A type of full limits the reserve plugin to allowing people with the proper Permissions to join even when the server is full.
- kick - Conversely, a type of kick will only allow people with the proper Permissions to join a full server by kicking the first player it comes across that does not have Permission to prevent being kicked.
- both - A type of both can use either the full server or kick method, but the full method takes precedence if a user has that Permission.
- none - "none" type effectively eliminated the reserve slot functionality, allowing you to disable it without removing the plugin.
- if you put something else as the type, the plugin will automatically regenerate it back to "both". Please note this.
You may also customize the messages sent by the plugin for different situations using the 'kick-message' and 'full-message' config nodes.
Permissions Overview
Permissions for SimpleReserve are...well...simple. There are only 3 Permissions to worry about.
'simplereserve.enter.full' - Permission required to give "full" joining capabilities. Allows joining above limit. 'simplereserve.enter.kick' - Permission required to allow joining full server by "kick" method--kicks first player it can. 'simplereserve.kick.prevent' - Prevents player from being able to be kicked by someone joining using the "kick" method
Examples
- Lets say you have 4 usergroups. Guests(default), Users, Moderators, and Admins. You want to give Admins and Moderators joining full server via "kick" method, but you only want to be able to kick at the expense of guests.
Permissions:
Note that Users only have the prevent permission. Any groups that inherit from Users will also have the same permission. Now to ensure we're using the right type of reserve slot, the config.yml would look like:
groups: Guests: default: true info: prefix: '' suffix: '' build: false inheritance: permissions: Users: default: false info: prefix: '' suffix: '' build: true inheritance: Guests permissions: - 'simplereserve.kick.prevent' Moderators: default: false info: prefix: '' suffix: '' build: true inheritance: Users permissions: - 'simplereserve.enter.kick' Admins: default: false info: prefix: '' suffix: '' build: true inheritance: permissions: - '*'
reserve: types: full,kick,both,none type: kick
- Same situation but we want to be able to join over capacity instead of kicking. We only need to change Mod's 'simplereserve.enter.kick' permission to 'simplereserve.enter.full' and change "type: kick" to "type: full" in config.
- We can also use * to allow either method(DEPENDS ON PERMISSIONS PLUGIN), and just change the type to and from kick and full as desired. will allow whichever type is configured.
'simplereserve.enter.*'
- We could also allow mods to join using the kick method and admins to join using full. In config we'd set type to both, and give mods 'simplereserve.enter.kick' Permission only. In this case, Admins have both kick and full Permission, which will default to using full when both are available, and mods can join using the Permission they have.
As you can see, almost any desirable Situation is achievable.
Screenshots
Users attempting to join full server with no Permission to enter: User being kicked to make room for a reserved member: No kick-able players for "kick" join method:
Console output for full type joining:
20:17:46 [INFO] [SimpleReserve] Allowed player tj007razor to join full server!
Project & Source
See our project page for activity and source.
@taylorjb
I'm getting file updates for source zips as well as jars, so I assumed the zips were meant to be just that.
@kilorat2
I fixed and did some quick tests, v0.4.3 appears to be working fine.
http://dev.bukkit.org/server-mods/simplereserve/files/14-simple-reserve-v0-4-3/
My bad, I assumed that clicking the big download button would take me to the newest version, if I manually click 1.4.2 in the recent files section I get the right thing and it loads right up. I tested this on a user with simplereserve.enter.full and they couldn't join, as Rocky143 said. I'm not sure why I even typed this out actually. :)
@kilorat2
Are you positive that is 0.4.2? That exception is caused by a reference to PlayerListener, which is no longer in the API and no longer in SimpleReserve since code revision 6( http://dev.bukkit.org/server-mods/simplereserve/files/7-r6/ ).
This plugin does load on 1.2.3-R2.
@Rocky143
Alright thanks for testing. I will get to that later today.
I don't think its working, this is my config file:
reserve: types: full,kick,both,none type: full full: cap: 0 reverttokick: false kick-message: Kicked to make room for reserved user! full-message: The server is full!
and I want them to join when its full and i gave them this permission node:
simplereserve.enter.full
but no they are not able to join and even I tried the cap: 5 in the config file still they are not able to so please help!
I was just going through all my plugins looking for updates and happened to try downloading it right after you put up an untested version, so I'll do my part and report what happens. I tried 0.4.2 on CB2034 (2060 just came out an hour ago, but it won't load with that either) I get this:
@shutka
There's a new jar waiting approval, but it is entirely untested so I'll need someone to let me know if it works or sets off nuclear explosions.
@Vitaminous
You were downloading the source zip.
The jars are jars.
lol, your jar's a zip.
@taylorjb
thanks in advance. We all will be happy..
@shutka
I have a lot to do in the next day or two. Being a full-time student often restricts my time for this. r7 should work so if someone would like to grab and compile the source and test I could put something up.
EDIT: Oh and a tested update should be up tomorrow or Friday.
@TheMadMan697 @funk1983 @TheFluffey @Godworld @dogbig
Update coming, just need to verify it works with latest RB.
I'm also waiting on an update. This is the only reserve slot plugin that works like I want it to. There's no messing with config files and max players. just give the group the permission and it just works.
+1 for the "please update" thread :)
@taylorjb
Please update for 1.6:D!
Please update your plugin.
errors when using on 1.2.2
@RealityIntern
Bukkit changed something in logins so make that happen, it happens with a few reserve and whitelist plugins. I have adjusted the priority but I still need to test it.
Anyway, I will fix ghost players before I release an updated compiled jar, so I'll get back to you.
I don't suppose these last updates eliminate the phantom players?
@Tauryuu
And what about offline servers? :)