125

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

125 diamonds
Collectable

A Noobs guide to permissions.

  • 63,418
    Views, 51 today
  • 118 Comments
  • 43 Favorites
  • Flag / Report

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 :

Join us to post comments.

1 - 50 of 118

GunnerNii
Level 1
New Miner
October 24, 2014, 11:29 pm

nvm fixed it :D

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? :/

Galaxy_Hero
Level 4
Apprentice Engineer
September 9, 2014, 6:38 pm

Thank you so much! I wanna give you 1000 diamonds for this!

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.

TeamKermy
Level 1
New Miner
May 17, 2014, 11:39 pm

modifyworld.* isn't working so players can't talk

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

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?

Junior_Rawrs
Level 1
New Miner
April 3, 2013, 6:17 pm

............................................................... :D............................................. THX............................................For..........................................The..................................Help................................................... :D

Phase_Saber
Level 1
New Toast
April 2, 2013, 4:29 pm

the modify world github is down

OnlyIn5DYT
Level 29
Expert Architect
February 17, 2013, 9:34 am

99th diamond was me

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?

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.

Droid177
Level 1
New Miner
January 31, 2013, 11:02 pm

Ok i fixed it. thanks for the guide, it really helped me. :)

Aang2720
Level 9
Apprentice Mage
January 30, 2013, 10:27 am

Thanks, Helped ALOT

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
January 31, 2013, 11:15 am

Great ;)

JamesBondage77
Level 19
Journeyman Nerd
January 29, 2013, 11:11 am

I think I love you, thanks Diamond'ed etc.

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

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

trollinggenius
Level 7
Apprentice Warrior
January 9, 2013, 6:04 pm

in part one i did everything exactly, It just wont make me admin, all i get is yellow text for my name

Aang2720
Level 9
Apprentice Mage
December 26, 2012, 1:02 pm

Thanks, will use your help ALOT.

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?

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 :)

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.

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

Awes0mecraft
Level 3
Apprentice Mage
November 12, 2012, 11:29 am

OMG thank you soooo much

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?

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

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

BeastFactionServer
Level 4
Apprentice Warrior
October 13, 2012, 2:29 pm

Hey I have a noob question, when I try a pex command it says error in syntax, WHAT DOES IT MEAN

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!

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
September 19, 2012, 10:26 pm

You open config.yml files with a text editor.

Creeper_Killer_X
Level 24
Expert Architect
September 2, 2012, 4:39 am

Which is better, bPermissions or PermissionsEx?

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.

Creeper_Killer_X
Level 24
Expert Architect
September 2, 2012, 3:05 pm

Ok. Thank you very much for this tutorial. Is there a way to add EVERY single essentials command to one group?

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.

Creeper_Killer_X
Level 24
Expert Architect
September 2, 2012, 6:02 pm

So I put

- essentials*

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
September 3, 2012, 12:38 am

Yeah that should work ok.

Creeper_Killer_X
Level 24
Expert Architect
September 3, 2012, 3:56 am

Thank you.

Creeper_Killer_X
Level 24
Expert Architect
September 2, 2012, 4:38 am

Is it supposed to say NULL everywhere?

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
September 2, 2012, 4:51 am

Where does it say null?

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?

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.

monkeygate369
Level 1
New Miner
August 25, 2012, 9:55 pm

this sux cocks

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
August 26, 2012, 2:12 am

Thanks. Enjoy your ban.

Creeper_Killer_X
Level 24
Expert Architect
September 2, 2012, 6:02 pm

lol

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

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
August 26, 2012, 2:11 am

Put it under the default user's permission nodes?

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?

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.

Zaven
Level 1
New Network
July 6, 2012, 8:00 pm

Everytime I setup permissions I want to punch a baby chicken.

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
July 7, 2012, 1:19 am

I KNOW THE FEEL BRO

Haydox99
Level 18
Journeyman Dragon
June 28, 2012, 12:40 am

permissions and so fiddly and hard to use!

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
June 28, 2012, 12:51 am

Permissions are an absolute nightmare D:

Haydox99
Level 18
Journeyman Dragon
June 28, 2012, 2:44 pm

Yeah I hate it. It took forever for me to work them out!

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

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

lilleahy
Level 1
New Miner
May 24, 2012, 4:02 pm

i redownloaded it is version 1.19.2 still wont work

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.

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/

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

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...

karatyman
Level 33
Artisan Architect
April 24, 2012, 5:12 pm

Nice, could you explain negative permissions tho?

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

EmptyOrange360
Level 27
Expert Electrician
April 20, 2012, 1:46 pm

Server wasn't working so i just deleated the properties and plugin. I will have to just keep everyone as op.

EmptyOrange360
Level 27
Expert Electrician
April 20, 2012, 1:17 pm

How do i make it so they can use lwc and essestials though.

gogocp
Level 1
New Nerd
May 18, 2012, 10:24 pm

My server has them. ^.^

EmptyOrange360
Level 27
Expert Electrician
May 19, 2012, 9:58 pm

dw. I finally wasn't too lazy and got the nodes.

EmptyOrange360
Level 27
Expert Electrician
April 20, 2012, 1:11 pm

How do i add people to the ranks. eg. Trusted.

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.

UCHIHA_JAMES
Level 1
New Miner
April 12, 2012, 7:37 am

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

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

UCHIHA_JAMES
Level 1
New Miner
April 12, 2012, 8:09 am

is it

bukkit.essentials.spawn

or not cause i dont know @=@

ZaphodX
Retired Moderator
Level 73
Legendary Warrior
April 12, 2012, 8:31 am

I don't think you need bukkit in front of it.

1 - 50 of 118