Bukkit

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:

  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:
                                      - '*'
  

  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:

  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.

  'simplereserve.enter.*'
  

  will allow whichever type is configured.
• 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.