SlotGroups

A different approach to slot management.

Description

SlotGroups gives you the ability to create multiple independent slot groups. Each one has their own maximum player count and group full kick messages, enabling more advanced slot management than is possible with typical reserved slots.

For example, you could give your 10 admins and moderators a slot group with 10 slots and set the default slot group to be 30 slots. This would allow all of the 10 moderators and admins to be on the server without taking up any of the 30 slots in the normal player group, while still keeping an overall cap of 40 players on the server.

You can configure as many slot groups as you like, creating some interesting possibilities. Slot inheritance has been implemented recently, increasing the possibilities even further.

I made this plugin to fill a very specific need on my server, and as such it is still pretty specialized. I'm working on adding more features to give it more general appeal, and am definitely looking for feature requests! If there's something you'd like to see added, please request it on the SlotGroups Redmine or post it here.

Features

Create multiple independent or inherited slot groups.
Have different maximum slot counts for different players or groups.
Make slot distribution more fair.
Have certain slot groups 'overflow' into others.
Users can automatically be put in a 'Default' slot group.
Manage user slot group membership from within the game.
Put the server in lockdown mode, preventing all but specific users from being able to join.
Add/Edit/Remove slot groups in the config file, then apply in-game using `/slotgroups reload`.
Slot group in-game list.
Requires Vault >=1.2.8
Recommended to use Vault >=1.2.15

How to Use

Download and extract the .zip package.
Place the contents of the .zip in your Plugins folder.
Configure SlotGroups.yml to your liking.
Set your max-players in your server.properties to the total number of slots in all slot groups.
Add relevant SlotGroups command and slot group permissions to groups or users as desired.
Enjoy!

Commands

/slotgroups (/sg)
- Shows the main command syntax.
/sg list
- Lists all loaded slot groups plus their current and max players.
/sg reload
- Reloads the configuration file from disk.
/sg version
- Displays version information to users. Users with the slotgroups.version permission will also be notified of new versions when running this command. (Update check done by a connection to api.curseforge.com)
/sg lockdown
- Locks all slots that do not have override set to true.
/sg unlock
- Unlocks all slots.
/slotgroupsuser (/sguser)
- Shows the syntax for user management commands.
/sguser set <user> <group>
- Puts <user> into slot group <group>.
/sguser remove <user> <group>
- Removes <user> from slot group <group>.
/sguser info <user>
- Shows slot group information for <user>.

Permissions

slotgroups.list
- Gives access to `/sg list`.
slotgroups.version
- Allows the version command to perform an update check against api.curseforge.com
slotgroups.reload
- Gives access to `/sg reload`.
slotgroups.lockdown
- Gives access to `/sg lockdown` and `/sg unlock`.
slotgroups.user.set
- Gives access to `/sguser set`.
slotgroups.user.remove
- Gives access to `/sguser remove`.
slotgroups.user.info
- Gives access to `/sguser info`.
slotgroups.group.<group>
- Puts a group or user in slot group <group>.

To Do

Add per-group configurable login queue.
Add optional per-group AFK settings.
Create public API for slot groups and counts.
Add in-game commands for manipulating slot groups.
Add in-game commands for manipulating slot groups Permissions group membership.
Release accompanying /who plugin with support for displaying slot group slot counts.
Add more configuration options.
Add command to lock/unlock specific slots while in-game.

Images

`/slotgroups list` output:

Conflicts

Any slot reservation plugin.

Known Limitations/Bugs

You should set your server.properties max-players to equal the number of slots in all your slot groups to prevent issues.
Existing plugins are not slot group aware and will report the number of max-players in your server.properties. I will be releasing the /who plugin I use on my server that is slot group aware.
Changing a Permissions group's slot group won't take effect until /sg reload or the server restarts.