GroupPermsLite

Unsatisfied with a number of other permissions management plugins publicly available, I sought to create a lighter and more elegant plugin to handle group-based permissions. With a focus to making all of the commands understandable at a glance and providing helpful details when queried. You should be able to get on with permissions management simply through typing /help GroupPermsLite and reading the command descriptions.

Features

Simple and elegant
Easy to use and understand
Allows setting up an unlimited number of groups (names are case-insensitive)
Has a default group called "all" that all players start in
Has a unique group for each player called "personal_[player name]" that allows individual permissions settings
Saved in YAML format, advanced users can read and manage on disk and reload while the server is running using a command
Simple and easy to use commands to add/remove players from groups and grant/revoke permissions from groups
Allows use of the wildcard (*) to match any value for a node in a permission string when granting permissions using a command
Allows adding negative permissions using the (-) operator to prevent a particular group from receiving the given permission from any other source

Commands

/GroupCreate [group] - Creates a group without adding a player or permission
/GroupAddPlayer [group] [player] - Adds a player to the given group (creates the group if it doesn't already exist)
/GroupRemovePlayer [group] [player] - Removes a player from the given group
/GroupGrantPerms [group] [(-)permission-string] - Grants the given permission(s) to the specified group (creates the group if it doesn't already exist)
/GroupRevokePerms [group] [permission-string] - Revokes the given permission(s) from the specified group
/GroupListPerms [group] ([page number]) - Lists all of the permissions for a given group
/GroupListPlayers [group] - Lists all players in a given group
/GroupList - List all groups
/GroupDelete [group] - Deletes a given group
/GroupReload - Reloads config from disk

Permissions

group.admin - Allow use of all GroupPermsLite commands (defaults to op)

Add-ons

RankDisplayNames - Create ranks with chat prefixes that update automatically with permissions set through GroupPermsLite

Troubleshooting

It says the permission is not registered, what can I do?

Sometimes plugin developers will forget or simply not bother to register their permissions with Bukkit, but still use them in their code. Fortunately, the bukkit permissions.yml file can come to the rescue here. You should be able to find the permissions.yml file in the server directory. It is used by server owners to manually register additional permissions in bukkit. See http://wiki.bukkit.org/Permissions.yml for details about editing the Permissions YAML. It is usually used to group permissions together so that they can all be assigned at once (this is compatible with GroupPermsLite!), however there is also nothing stopping you from registering all of the unregistered permissions for a plugin manually.

For example, here is how to register all of the permissions for Essentials (the most notorious for not registering their permissions): http://dev.bukkit.org/paste/7208/. You can cut and paste these into your permissions.yml if you use essentials. Be aware that permissions with square brackets [ ] around a permission node mean that you have to change that to the specific type you want in order for it to work.

Coming in v0.4: Added support for unregistered permissions - You will be able to grant unregistered permissions to a group with a prompt for confirmation

I am getting an error after starting up the server

Are you getting the following error after starting up your server with GroupPermsLite in the plugins folder?

[SEVERE] Could not load 'plugins/GroupPermsLite.jar' in folder 'plugins' org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: me/xhawk87/GroupPermsLite/GroupPermsLite : Unsupported major.minor version 51.0

This means you are using an old version of java and are trying to run a plugin written in a newer version. You will probably get this error on a number of other plugins too. To enable your server to use all of these plugins, all you need to do is install the latest version of java. If you are on managed hosting, you can contact your hosting provider about installing the latest version of java. Otherwise you can obtain the latest version from the Oracle website.

Donations

If you like my work, please consider donating using the Donate button in the top-right corner of the screen. As a freelance professional, I rely on donations and payments to support my work. Anything you can contribute to support my work will allow me to spend more time making plugins for Bukkit and supporting the plugins I publish. Thank you.

Everything I create here will be 100% free to download and use as you please, just keep the license attached and give me credit for the original work if you decide to redistribute.

Help

If you need help you can leave a comment below and I will get back to you as soon as I can. You can also join my IRC chatroom using the following link. Please note, I am not always at my keyboard! http://webchat.esper.net/?channels=XHawk87&prompt=1

You must login to post a comment. Don't have an account? Register to get one!

79 comments
1
2
3
4
5
6
7
8
Next →

- Reply
- #80
Skyjet3000 Jun 13, 2013 at 06:25 UTC - 0 likes
i like this pulgin
- Reply
- #79
XHawk87 Jun 11, 2013 at 19:11 UTC - 0 likes
@Makhulu: Go

That is a good idea, and there are tutorials available already on how to install plugins, however I don't have time to create an in-depth tutorial for the whole process right now. However, if someone else creates a tutorial, with screenshots or a video, I will include a link here so everyone can see it.

Need help? http://webchat.esper.net/?channels=XHawk87&prompt=1

My Minecraft servers and Bukkit plugins: Arcane Games

I am currently working on: AntiBranchMining, Coinage
- Reply
- #78
Makhulu Jun 11, 2013 at 18:57 UTC - 0 likes
How about a tutorial on putting EVERYTHING together! Downloading it putting the plug in in! And the permissions! Do everything obviously no one here doesnt know what to do!
- Reply
- #77
XHawk87 May 08, 2013 at 18:09 UTC - 0 likes
@Jong100: Go

As with all of my plugins at present, GroupPermsLite is Bukkit API-compliant, which means it does NOT break after CraftBukkit updates. You can continue to use the same version. You only need to update GroupPermsLite for bug fixes and new features when they come out.
- Reply
- #76
Jong100 May 08, 2013 at 15:11 UTC - 0 likes
I Need Version 1.5.2 ;(
- Reply
- #75
XHawk87 May 05, 2013 at 18:06 UTC - 0 likes
@necrodoom: Go

The plugin.yml isn't the only way to register permissions. You can do so programmatically through the Bukkit API. see PluginManager.addPermission(...).

Although its not technically required to register permissions at all, it is highly recommended as it allows in-game help to be provided for them as well as allow more robust permissions handling for permissions plugins. Without registering permissions, a single typing error could lead to considerable confusion for a new or experienced server admin. Potentially leading to hours of wasted time on hunting a solution and talking to plugin devs.
- Reply
- #74
necrodoom May 05, 2013 at 16:55 UTC - 0 likes
@XHawk87: Go

the reason is that many of the permissions are dynamic. trying to put all the essentials.kits.kitname permissions or similar in plugin.yml wont end well.
- Reply
- #73
XHawk87 Apr 06, 2013 at 01:45 UTC - 0 likes
@deadyasar: Go

If you use the /reload command this can cause permissions to disappear until you relog or restart the server.
- Reply
- #72
deadyasar Apr 05, 2013 at 15:02 UTC - 0 likes
hi i got a problem with this plugin every time i set the groups the permissions and other stuff and i unop my self everything goes away do you know how i fix this?
- Reply
- #71
XHawk87 Mar 20, 2013 at 04:38 UTC - 0 likes
@18ijohnson: Go

This is a Bukkit API-compliant plugin, so it should work in 1.5. Have you tried it?