125

Noob's Guide to Bukkit permissions [Inc example files]

125 diamonds
Collectable

A Noobs guide to permissions.

Get Embed Code

Forum:
HTML:
Link:
avatar
ZaphodX
Retired Moderator
Level 73 : Legendary Warrior



bannersiggif

These days I play Supreme Commander, which is probably the greatest RTS you've never heard of!

I do daily uploads of gameplays, replays and tutorials - check out my videos you might like them :)

Channel: http://www.youtube.com/user/ZaphodX1

Subscribe: http://bit.ly/-subscribe




One part of: The Ultimate Server Guide

GAFjpg

This guide is part 5 of the ultimate server guide. For all other server stuff, check out the ultimate server guide. Includes: Making a server, using plugins, great plugins to have, stopping cheaters and griefers, and a noob's guide to permissions!




A noobs guide to Permissions

  • If you liked it, please Diamond and maybe Favourite ^_^
  • Also, subscribe to me if you want more tutorials!

Permissions, they are an absolute pain, and never seem to be explained in an easy way. This should hopefully be able to get you to set up your own permissions system and be able to use permissions just fine. The 2 plugins available are bPermissions and PermissionsEX. Apologies for length!




The Basics

User groups
Allows you to give ranks/groups to certain players, meaning different players can have different prefixes in front of their name and have access to different commands.
Example:
Default has access to basic stuff. Trusted gets access to a bit more and [Trusted] before their name. Moderator gets access to /mute, /kick, /ban etc and [Mod] before their name.

Inheritance:Inheritance allows you to have all the commands from a lower group. 'Inheritance' in bPermissions works a little differently (see later).
Example: A moderator has inheritance from default users and trusted users. This means they get access to all commands that those two user groups have, as well as the moderator commands.

Nodes:A node basically refers to which /command you are giving or restricting access to. By adding a permissions node, you give access to that particular command. To find which command refers to which node, go to the plugin's page on bukkit (search bukkit.org or dev.bukkit.org) and view the page on their 'permissions nodes'.

Permission node format:
pluginname.commandname

Examples:
Plugin: CommandBook
Command: /sethome
commandbook.home.set

Plugin:
WorldEdit
Command: /sp
worldedit.superpickaxe

Formatting:
Permissions files are done in yaml format. You cannot use tabs in yaml format, you need to use multiple spaces instead. I highly recommend using Notepad++, as it is very easy to use and shows when you have formatted incorrectly by changing text to red.

When you have finished formatting your permissions file, you need to put it through a yaml parser. This basically checks to see if it conforms to the yaml formatting. Copy the permissions into the window. If it displays fine, then great. If it shows you errors, then navigate to the line the error is shown in and check what you have done wrong.



Setting up Permissions

There are two main options for permissions, bPermissions and PermissionsEX. I am going to go into PermissionsEX in detail and give a brief overview of bPermissions. I recommend using PermissionsEX.

Advice
1 Permissions are a nightmare. If you do just one thing wrong it is likely absolutely nothing will work. Don't do anything unless you are sure it is the right thing to do. Don't just guess how it should be! Best way is just to copy from the examples I give.

2 After you do some editing and before you load it up, copy the whole text in your permissions file into HERE. If you get errors then go to line the error is on, and work out what you did wrong. 90% of the time it is adding a tab by accident. Always uses spaces and not tabs.

3 Go really slowly. Don't do or add too many things at once. Go in game and check it is working properly before you move on too far. Otherwise you don't know which bit is wrong.

4 Keep at it, permissions is something you eventually learn from making mistakes and fixing them. It gets easier with practice as you stick with it.

5 Use Google. Find out how to fix various things from other people with the same problem.




PermissionsEx



1 Download and install Notepad++. Open all these .yml files using Notepad++.

2 Download PermissionsEX and put all 4 jar files in your plugins folder. Startup your server, and then type 'stop' in the server command window.

3 Download THIS and open the example files as your read through each part



1 Basic structure of permissions file, with default member, trusted member, moderator and admin.

1 Go to your plugins/chatmanager folder and open config.yml. Change the line 'enable:false' to 'enable:true'. ChatManager is needed to add colours and prefixes.

Open up file 1 and have a look through as you read.

2 'default:true' means that a new player joining the server will start in the group 'Default'

Each group has its own prefix, which you can change to whatever you want. The suffix is currently left blank.

'permissions:null' means that currently none of the groups have any permissions to use commands.

'inheritance:' means that that group inherits all the nodes (commands) from that group.

The admins have - '*' in their permissions list. The * means 'everything' so this means they can use every single command possible.

3 Take the file and put it into you plugins/permissionsEX folder. Rename it to permissions.yml. Now replace 'zaphodx' with your minecraft name at the bottom in the 'users:' section. Try it out and you should see when you chat that your prefix will change depending on what group you are in. Also notice you can only use basic commands unless you are in the admin group.



2 Adding basic Bukkit commands

Open up file 2 and check through it as you read this portion.

Important Note:When adding nodes, you MUST NOT add any tabs. When you press enter to add another line of nodes, it will automatically add 2 tabs. YOU MUST delete these tabs and enter 8 spaces instead!

1 First of all go HERE.

These are the basic commands for a Bukkit server. Look through them and decide who should have which commands. Here is how I decided to do it:

I decided moderators can have the following commands: /kick, /ban, /ban-ip, /pardon and /pardon-ip.So from the list I can see the permission nodes I need to add are:
bukkit.command.kick
bukkit.command.ban
bukkit.command.ban.ip
bukkit.command.ban.player
bukkit.command.unban
bukkit.command.unban.ip
bukkit.command.unban.player

Using the * wildcard I can reduce the nodes I need to add to the 'Moderators' group to just this:
bukkit.command.kick
bukkit.command.ban.*
bukkit.command.unban.*

2 Now moving on to trusted players, I don't really need to give them anything, since they inherit all the commands that Default users have anyway.

And for Default users, Looking at the 'permissions default' column of the Bukkit commands I can see they already get some commands. However I also want to let them have /help and /list so I add:
bukkit.command.list
bukkit.command.help

3 However, If you have read my guide HERE, I recommend disabling /version and /plugins to make it harder for griefers and cheaters. So I will add a negative permissions node to the default group.

Optionally, you could allow your trusted members to access those two commands. In this example I have decided to let the trusted users access these commands. Check the difference in-between the 'Default' group and the 'Trusted' group. Default have a negative node stopping them from using them, and then the Trusted have a normal node added, allowing them to use these commands again.
Default:
-bukkit.command.version
-bukkit.command.plugins
Trusted:
bukkit.command.version
bukkit.command.plugins

4 Look through file 2 and make sure you understand where and why I added the nodes.



3 Adding a couple of plugins

So, I'm now going to add a few plugins, NoCheat and Lockette.

1 NoCheat

First check out the NoCheat permissions nodes HERE.

1 I don't want to let any of my players cheat, but I do want my moderators and admins to be able to fly. From the NoCheat permissions page I see I can add nocheat.checks to stop nocheat checking players.
Add to Moderators group:
nocheat.checks.moving.*

2 Admins have '*' so they have access to all commands. But I don't want my admins to be able to cheat, so I have to place a negative permissions node for all NoCheat checks. This means they aren't immune to NoCheat. However I do still want to let my admins fly and check in-game logs from nocheat. So these are the permissions nodes that I add for admins:
Admins:
-nocheat.* (even admins are checked)
nocheat.checks.moving.* (Admins can still fly)
nocheat.admin.* (Admins can check NoCheat logs)

2 Lockette

Go to the Lockette page HERE. Scroll down and open the spoiler called 'advanced setup (permissions)'.

1 Looking through the permissions nodes, I want my moderators to be able to check up on anyone suspicious, so I will let them have all the admin permissions for snooping, by giving them the node:
lockette.admin.*

2 I want to be able to allow even new guest users in the Default group to lock their chests/furnaces, so I will give the Default group the node:
lockette.user.create.*

3 Have a look through file 3 and check you understand how I edited the permissions file.



4 Multiple world permissions

Multiple worlds:If you have multiple worlds or want seperate permissions for the nether, just split the permissions up into 2 groups, based on the worldname (name of the folder your world is in).

Check file 4 to view how to convert file 3 into worlds with different permissions.



Using modifyworld

Modifyworld is an optional part of PermissionsEX that gives you some extra control over what you choose to let players do.

Go HERE and check out what it can do. In particular, scroll down to the 'generic' modifyworld permission nodes.

First open up your plugins/modifyworld folder. Open the config.yml and set enable:true.

Until you add some modifyworld nodes, nobody can do anything. To enable all, add the permissions node:modifyworld.*

Examples of how you could use modify world:

Protect a VIP's tamed wolves by putting a negative permission on damaging a certain player's wolves:
-modifyworld.damage.deal.wolf.playersname

Stop Default users from using flint and steel (item ID=259):
-modifyworld.items.use.259

To make a special 'Guest' group that can only walk around and check out the server, make a new group and give them only these two nodes and no others:
modifyworld.chat
modifyworld.sprint

If you want some more support for PermissionsEX check out BENNETTMAN's guide here!



bPermissions



1 A few different player groups, prefixes, players

First open file 1, in the bPermissions folder HERE and look at it in notepad++. I've created 5 groups.

Scroll down to the bottom and you will see names of players and then the groups of commands they are allowed to use. For example a VIP has default, trusted and VIP groups. This means they get access to all commands that default and trusted players get, as well as VIP commands.

Scroll back up to the top, and you can see which nodes are in each group. The default group has 'bpermissions.build' which means they can break and place blocks. If you only want guests to be able to walk around, then you could put that node into the trusted group.

A prefix appears before your name in chat. Each group has a prefix, in the format:- prefix.[strength].[text]The strength indicates whichever prefix a player has will override any other prefix which has a lower strength. Example: admins have strength 50 for the prefix [Admin], so in-game they will only have '[Admin]', and not get any other prefixes that have a lower strength. I have left the prefixes as the same name as the groups but they can be changed to whatever you want.

The moderators and admins have 'bpermission.' nodes that allow them to promote or demote up to their rank of moderator/admin.



Important things to note:
You cannot use '*' as a wildcard in bPermissions, you MUST enter every permission node.
Capital letters are very important! You MUST enter player's names and group names with the correct capital letters!



Using /p helpme:
This is a useful command in bPermissions, but be very careful! Backup your permissions file FIRST. By typing /p helpme it will generate a new permissions file that generates all the permission nodes for the plugins that support it, and auto-places them into groups based on a guess of where they should be. This isn't supported by all plugins, but it does work for quite a few. You can then cut and paste the permissions into the groups you want them to be in.



Troubleshooting bPermissions

Use the YAML parser and check you do not have any errors

Be very careful with capital letters of player names and group names

You have to stop the server to reload permissions changes


Tags:Tutorial, Minecraft, Server, Make, Setup, Create, Host, Beta, Hosting, Vanilla, Bukkit, Plugins, Help, Hamachi, Port, Forwarding, Portforwarding, Guide, Herobrine, Permissions, BPermissions, PermissionsEX

Comments : 118

Join us to post comments.

Show Comments

1 - 50 of 118

  • GunnerNii
  • Level 1
  • New Miner
  • October 24, 2014, 11:29 pm
nvm fixed it :D
Edit Reply Delete
  • GunnerNii
  • Level 1
  • New Miner
  • October 24, 2014, 10:46 pm
hey uhhhh
it doesnt work when i do <pluginname,*> cause i dont want the admin or mod to have access to ALL plugins. but of course the owner /me will -.- sooo how can i fix it? :/
Edit Reply Delete
  • Galaxy_Hero
  • Level 4
  • Apprentice Engineer
  • September 9, 2014, 6:38 pm
Thank you so much! I wanna give you 1000 diamonds for this!
Edit Reply Delete
  • Stormbow
  • Level 1
  • New Explorer
  • June 2, 2014, 6:31 pm
@ZaphodX :  I don't know that you'll ever seen this message, but I just thought you might like to know that this guide is still helpful to players after all these years.
Edit Reply Delete
  • TeamKermy
  • Level 1
  • New Miner
  • May 17, 2014, 11:39 pm
modifyworld.* isn't working so players can't talk
Edit Reply Delete
  • jerryjoey100
  • Level 5
  • Apprentice Explorer
  • October 29, 2013, 12:37 am
Is there a way to get it already set up ??? I am having trouble with the whole thing. I know I will Need to add my own nodes for my different plugins Thanks
Edit Reply Delete
  • Mioblin
  • Level 1
  • New Crafter
  • October 18, 2013, 8:55 pm
Is there a way to make yourself owner without having access to the console?
Edit Reply Delete
............................................................... :D............................................. THX............................................For..........................................The..................................Help................................................... :D
Edit Reply Delete
the modify world github is down
Edit Reply Delete
  • OnlyIn5DYT
  • Level 29
  • Expert Architect
  • February 17, 2013, 9:34 am
99th diamond was me
Edit Reply Delete
  • Droid177
  • Level 1
  • New Miner
  • January 31, 2013, 8:56 am
When i say something in my server my name looks like this: [Admin][Admin]Droid177 ,not [Admin]Droid177
What should i do?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • January 31, 2013, 11:15 am
No idea you must have entered it twice or a chat plugin is adding it in. Check through the permissions and chat settings.
Edit Reply Delete
  • Droid177
  • Level 1
  • New Miner
  • January 31, 2013, 11:02 pm
Ok i fixed it. thanks for the guide, it really helped me. :)
Edit Reply Delete
  • Aang2720
  • Level 9
  • Apprentice Mage
  • January 30, 2013, 10:27 am
Thanks, Helped ALOT
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • January 31, 2013, 11:15 am
Great ;)
Edit Reply Delete
I think I love you, thanks Diamond'ed etc.
Edit Reply Delete
  • I_PRO_JACKZ
  • Level 2
  • Apprentice Miner
  • January 20, 2013, 4:49 am
My run.bat doesnt work, it says something like the path specified, what does it mean i have tried downloading but have then had different issues
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • January 20, 2013, 10:52 pm
The bat file has to be in the same place as craftbukkit.jar
Edit Reply Delete
in part one i did everything exactly, It just wont make me admin, all i get is yellow text for my name
Edit Reply Delete
  • Aang2720
  • Level 9
  • Apprentice Mage
  • December 26, 2012, 1:02 pm
Thanks, will use your help ALOT.
Edit Reply Delete
  • cjcraft01
  • Level 31
  • Artisan Spelunker
  • December 23, 2012, 6:36 am
Okay, thanks for this blog but how do I add normal vanilla Minecraft commands? Like (whatdoitypehere).toggledownfall?
Edit Reply Delete
  • Zeromight12
  • Level 1
  • New Miner
  • December 13, 2012, 5:43 am
Im having problems on my server, because i dont know how to fix this, because when default players try do do things they get this popup: You are not permitted to use/drop and interract, may someone help me and tell what to type in the permissions.yml, i would be so happy if someone could help me :)
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • December 13, 2012, 6:13 am
If you're using modifyworld as part of permissionsEX then you need to give them permissions to use/break/place etc.
Edit Reply Delete
  • Zeromight12
  • Level 1
  • New Miner
  • December 13, 2012, 9:02 pm
I changed much, but i dont know how, am i going to write modifyworld.blocks.place in permissions? Because that didnt work :l
Edit Reply Delete
  • Awes0mecraft
  • Level 3
  • Apprentice Mage
  • November 12, 2012, 11:29 am
OMG thank you soooo much
Edit Reply Delete
  • Awes0mecraft
  • Level 3
  • Apprentice Mage
  • November 12, 2012, 11:30 am
oh and how do i make it so people cant do /pl or /ver with perms and not a plugin?
Edit Reply Delete
  • jogoodman
  • Level 2
  • Apprentice Miner
  • October 23, 2012, 5:41 pm
Im Having the same problem as pauang. I believe essentials is overriding some commands like /ban or /kick since it wont say "contact administrator if you belive this is incorrect" and just says the normal "you dont have permission" also two of the bukkit ones worked for me toggledownfall and i -version all others didnt work. i googled but couldn't find an updated deafult bukkit permissions thingy but overall this was very helpfull to me and helped me figure out how to use permissions.Thanks and when you get a chance find an updated default permissions
Edit Reply Delete
  • jogoodman
  • Level 2
  • Apprentice Miner
  • October 30, 2012, 7:18 pm
Nevemind it was just other plugins blocking it and nocheat too. This guide works great thanks again
Edit Reply Delete
Hey I have a noob question, when I try a pex command it says error in syntax, WHAT DOES IT MEAN
Edit Reply Delete
  • eldin
  • Level 22
  • Expert Geek
  • September 19, 2012, 10:20 pm
I was opening my config.yml folder with WinRAR but said the archive was either in the wrong format or damaged. Help!
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 19, 2012, 10:26 pm
You open config.yml files with a text editor.
Edit Reply Delete
Which is better, bPermissions or PermissionsEx?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 2, 2012, 4:51 am
I find PermissionsEx much, much easier to use. With bPermissions you have to add every single command node, which I find incredibly time consuming.
Edit Reply Delete
Ok. Thank you very much for this tutorial. Is there a way to add EVERY single essentials command to one group?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 2, 2012, 3:51 pm
For permissionsEx you can just add essentials.* but for bpermissions you'll have to try and copy paste them in from the essentials permission nodes list.
Edit Reply Delete
So I put

- essentials*
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 3, 2012, 12:38 am
Yeah that should work ok.
Edit Reply Delete
Thank you.
Edit Reply Delete
Is it supposed to say NULL everywhere?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 2, 2012, 4:51 am
Where does it say null?
Edit Reply Delete
  • rejectdeath
  • Level 1
  • New Miner
  • September 1, 2012, 11:50 am
Hey, probably a completely noob question, but how do you promote players once the permissions are made?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • September 1, 2012, 3:39 pm
I always manually add them into the config textfile in ther permission. You can check the comands for the plugin to see how to add/change them through server commands.
Edit Reply Delete
this sux cocks
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • August 26, 2012, 2:12 am
Thanks. Enjoy your ban.
Edit Reply Delete
lol
Edit Reply Delete
  • jacksonzane
  • Level 1
  • New Explorer
  • August 10, 2012, 1:08 pm
If i were to use the command bukkit.command.list or bukkit.command.help were would i put that
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • August 26, 2012, 2:11 am
Put it under the default user's permission nodes?
Edit Reply Delete
  • leobizaz
  • Level 5
  • Apprentice Crafter
  • July 9, 2012, 3:04 pm
everytime i try to use any PEX command, it says internal error and floods my console with a giant error... it asks me if PEX is enabled. How do i 'enable' it?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • July 9, 2012, 10:24 pm
Try redownloading PEX, you will probably find in the stratup that is said there was an error and pex was being shutdown.
Edit Reply Delete
  • Zaven
  • Level 1
  • New Network
  • July 6, 2012, 8:00 pm
Everytime I setup permissions I want to punch a baby chicken.
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • July 7, 2012, 1:19 am
I KNOW THE FEEL BRO
Edit Reply Delete
  • Haydox99
  • Level 18
  • Journeyman Dragon
  • June 28, 2012, 12:40 am
permissions and so fiddly and hard to use!
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • June 28, 2012, 12:51 am
Permissions are an absolute nightmare D:
Edit Reply Delete
  • Haydox99
  • Level 18
  • Journeyman Dragon
  • June 28, 2012, 2:44 pm
Yeah I hate it. It took forever for me to work them out!
Edit Reply Delete
  • lilleahy
  • Level 1
  • New Miner
  • May 24, 2012, 3:00 pm
i need help when i start up the bukkit server it goes through and does all of the stuff but at the end it says permissionex not found disabling when it tries to load modifyworld and chatmanager
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • May 24, 2012, 3:18 pm
They rely on PermissionsEx make sure you have it. Download a newer version of PermissionsEx
Edit Reply Delete
  • lilleahy
  • Level 1
  • New Miner
  • May 24, 2012, 4:02 pm
i redownloaded it is version 1.19.2 still wont work
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • May 24, 2012, 9:35 pm
Sorry, I'm not sure that happened to me and I think I just redownloaded it. Try searching Google.
Edit Reply Delete
  • Emorak
  • Level 11
  • Journeyman Miner
  • May 9, 2012, 7:11 am
If you don't have Notepad++

Use this > http://yaml-online-parser.appspot.com/
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • May 9, 2012, 7:46 am
Yeah I've put a link in there to it, it's a very useful tool. Pity no-one usually bothers xD
Edit Reply Delete
  • gogocp
  • Level 1
  • New Nerd
  • May 18, 2012, 10:23 pm
I did, but I gave up after fixing like 10 mistakes when I couldn't understand one...
Edit Reply Delete
  • karatyman
  • Level 33
  • Artisan Architect
  • April 24, 2012, 5:12 pm
Nice, could you explain negative permissions tho?
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • April 24, 2012, 9:18 pm
For permissionsEX just put a hyphen before the permissions node to stop them using that command:

Normal:
- essentials.spawn

negative:
- -essentials.spawn
Edit Reply Delete
Server wasn't working so i just deleated the properties and plugin. I will have to just keep everyone as op.
Edit Reply Delete
How do i make it so they can use lwc and essestials though.
Edit Reply Delete
  • gogocp
  • Level 1
  • New Nerd
  • May 18, 2012, 10:24 pm
My server has them. ^.^
Edit Reply Delete
dw. I finally wasn't too lazy and got the nodes.
Edit Reply Delete
How do i add people to the ranks. eg. Trusted.
Edit Reply Delete
  • gogocp
  • Level 1
  • New Nerd
  • May 18, 2012, 10:25 pm
I just copy the rank bit for default and change name, prefix, suffix, inheritance and permissions.
Edit Reply Delete
I kinda understand but i dont understand how to put other plugins in the permission like Essentials and setrank to stop ppl from using thoso things. im like WTF @A@

i need mega help
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • April 12, 2012, 8:02 am
Go to the download/wiki page for the plugin and search for the permissions nodes.

Example: for Essentials /spawn the node is: essentials.spawn
Edit Reply Delete
is it

bukkit.essentials.spawn

or not cause i dont know @=@
Edit Reply Delete
  • ZaphodX
  • Retired Moderator
  • Level 73
  • Legendary Warrior
  • April 12, 2012, 8:31 am
I don't think you need bukkit in front of it.
Edit Reply Delete

1 - 50 of 118

Show Comments