bPermissions
bPermissions
Welcome to bPermissions, a Superperms Manager for Bukkit! bPermissions focuses on being unique from the rest of the Permission managers. It's very simple to set up and use, it's lightning fast, fully featured, and has a great support team!
Some features:
- bPermissions has a gui client specifically designed to make running a server so easy that you'll forget that you ever used any other permissions plugin. Get it here!
- bPermissions has a unique command structure, never before seen in a permission manager. It's best used for adding lots of nodes to a user or group from the console or in-game, less typing!
- bPermissions has everything you would expect from a Permissions manager. Prefix and suffix support, inheritance, per-player permissions, multiworld support, promotion/demotion tracks, and even group priorities for multi-group setups.
- Note - bPermissions only defines prefixes and suffixes. You need a chat plugin such as bChatManager for them to show up in chat.
Commands
Say you have a user called 'Bob' and you want to put him in the group 'admin' and give him the prefix 'awesome'.
- /world yourmainworld - selects the world "yourmainworld"
- /user bob - selects the user "bob"
- /user setgroup admin - set bob's group as "admin"
- /user meta prefix awesome - set bob's prefix to "awesome"
You can do the same with groups!
- /world yourmainworld - again, selects the world
- /group admin - selects the group "admin"
- /group addgroup moderator - makes the admin group inherit from the moderator group
- /group meta prefix &c[Admin] - sets the admin prefix to "&c[Admin]"
Some other commands are as follows
- /permissions (or /bperms,/bp,/p) - general commands for bPermissions are prefixed by this
- /permissions import pex - import a pex permissions.yml in the pex folder
- /permissions reload - reloads your bPermissions files
- /permissions save - if auto-save is false, this saves your perms
- /permissions backup - backup your permissions
- /permissions helpme - for the lazy among you, this spews out some basic permissions files into your folder.
In order to use these commands, you'll need the permissions node bPermissions.admin
For configurable /promote and /demote tracks, you'll want to use permissions tracks. To read about those, visit this page
Want more commands? We have some others over on the commands page. Check 'em out!
Editing Files
bPermissions creates per world groups.yml and users.yml files in the bPermissions folder, which allow you to configure permissions on a per world basis.
Because bPermissions was designed to be configured largely via commands, bPermissions will often overwrite changes to these files especially if you /reload or restart the server.
If you've edited the files, you MUST use /permissions reload to load the modified files into the server, otherwise the permissions changes won't apply. Because a standard /reload unloads all plugins like a server stop, we cannot tell the difference between them and this will overwrite changes to your files with whatever the server last stored.
World mirroring
Worlds are mirrored like so:
world_mirroring_to: world_mirroring_from world_nether: world world_the_end: world
This duplicates the whole config for that world. Currently there's no way to have just the users or the groups mirrored, stay tuned for an update that adds this!
bPermissions and EssentialsChat
Allow me to put this issue to bed. Essentials Chat + bPermissions works for prefix and color.
This guide is for current users of EssentialsChat and want to use bPermissions along with it.
Players have colored rank prefixes and faction chat modes are also colored. All text can be colored by the players too using color codes such as &c.
bPermissions\world\groups.yml ( code snippet )
default: default groups: ## Peasant ## default: permissions: - group.default - group.userannouncer - group.userauction groups: - userannouncer - userauction meta: priority: '100' ## Citizen ## rank1: permissions: - group.default - group.rank1 groups: - default meta: priority: '200'
It has nothing configured for prefix but the group names are important (default, rank1)
Essentials\config.yml ( Code Snippet )
change-displayname: true #add-prefix-suffix: false player-commands: - chat.color - chat.format - chat.shout - chat.question chat: radius: 0 group-formats: default: '&8&lPeasant &r&8{DISPLAYNAME}&7:&r {MESSAGE}' rank1: '&8&lCitizen &r&7{DISPLAYNAME}&7:&r {MESSAGE}' moderator: '&e&l[Mod] &r&3{DISPLAYNAME}&7:&r {MESSAGE}' admin: '&c&l[Admin] &r&e{DISPLAYNAME}&7:&r {MESSAGE}'
Please direct all other Essentials support to their official support networks.
How do I get support?
First, we highly recommend you go read the FAQ page. If the answer isn't there, there's a few options of support.
- Visit the #bananacode irc channel on irc.esper.net. Just head there, as your question, and wait for someone to help you. It might be a while before you get an answer, so be patient!
- You can file a ticket. This is recommended if you don't have the time to hang around in the IRC or you have a bug report. Be prepared to check back to the ticket though, and make sure you attach your bPermissions groups and users yml files to the ticket.
- Comment on the bPermissions main page.
Note that as there's only one (slightly inactive) maintainer at the moment, any support queries may take some time.
However you choose to get support, "pls dont use txt spk," and make sure you use actual grammar.
I'm a developer!
If you wish to hook your plugin into bPermissions, please see the Developer Page for more information! If you wish to contribute code to bPermissions, fork us on GitHub!
Development builds of this project can also be downloaded from GitHub now. These builds have not been approved by the BukkitDev staff, and are possibly buggy. Use them at your own risk.
-
View User Profile
-
Send Message
Posted Jun 12, 2012Heya, it has been over a year since I have played around with minecraft :P
Anyways I am having trouble getting my RepairChest to work. This is what I put into my world folder.
And then after I start the server, it changes to this automatically.
And therefor I cannot make a repair chest :(
It has no tabs, and it is in the correct folder.
EDIT
Just figured it out! Listen carefully because this is an easy mistake/bug! My world starts with an Uppercase letter....when bpermissions makes the world folders, it ignores the uppercase, causing it to not work!
-
View User Profile
-
Send Message
Posted Jun 12, 2012why is it i set all the ranks no error but yet all i get are the default level s like admin and
-
View User Profile
-
Send Message
Posted Jun 12, 2012This just takes he piss still problems was json then i converted it and now it still dos not work can some one just do the files for me please.
i want it to look like this
default
groups:
Level 5:
meta:
prefix: '[&5Level 5]'
groups:
- level 4
permissions:
- bukkit.command.ban.list
- bukkit.command.list
- bukkit.command.plugins
- bukkit.command.teleport
Level 4:
meta:
prefix: '[&4Level 4]'
groups:
- level 3
permissions:
- bukkit.command.kick
World Leader:
meta:
prefix: '[&8World]'
groups:
- nation leader
permissions:
- bukkit.command.whitelist.disable
- bukkit.command.whitelist.enable
- bukkit.command.whitelist.remove
Level 1:
meta:
prefix: '[&1Level 1]'
groups: []
permissions:
- bukkit.command.help
- worldportal.use
Village Leader:
meta:
prefix: '[&6Village]'
groups:
- level 5
permissions:
- bukkit.command.save.perform
- bukkit.command.toggledownfall
- worldportal.create
- worldportal.remove
- worldportal.save
- worldportal.teleport
Level 3:
meta:
prefix: '[&3Level 3]'
groups:
- level 2
permissions:
- bukkit.command.tell
Level 2:
meta:
prefix: '[&2Level 2]'
groups:
- level 1
permissions:
- bukkit.command.me
- bukkit.command.version
Nation Leader:
meta:
prefix: '[&9Nation]'
groups:
- town leader
permissions:
- bukkit.command.ban.ip
- bukkit.command.gamemode
- bukkit.command.give
- bukkit.command.kill
- bukkit.command.op.give
- bukkit.command.op.take
- bukkit.command.reload
- bukkit.command.save.disable
- bukkit.command.save.enable
- bukkit.command.save.perform
- bukkit.command.say
- bukkit.command.time.add
- bukkit.command.time.set
- bukkit.command.unban.ip
- bukkit.command.whitelist.list
- bukkit.command.whitelist.remove
- bukkit.command.xp
Town Leader:
meta:
prefix: '[&7Town]'
groups:
- village leader
permissions:
- bukkit.command.ban.player
- bukkit.command.pardon
- bukkit.command.time
- bukkit.command.unban.player
- bukkit.command.whitelist.add
- bukkit.command.whitelist.reload
-
View User Profile
-
Send Message
Posted Jun 12, 2012Hey guys I have one concern about bPermissions. No matter what permissions I type they only work when in op.
PLEASE HELP!!
-
View User Profile
-
Send Message
Posted Jun 12, 2012Hi, first off, I love this plugin!
Is there anyway to integrate the [Faction] tag with prefixes?
And I know this isn't related but when i set up bgroupmanager, it's fine when someone is in a faction:
example: [**Bukkit Member] Notch: <message> (Bukkit is a faction that you own). Now when he disbands or leaves his faction it has a space: [ Member] Notch: <message>. Is there any way to remove the space before the M in member?...
-
View User Profile
-
Send Message
Posted Jun 12, 2012@DrMadFellow
/permissions import pex
-
View User Profile
-
Send Message
Posted Jun 11, 2012Was wondering if there is any way to convert users from pex to bperms. The problem I am having is that pex is no longer compatible with what I need it to be. I have over 300 vip users and would prefer to not have to rewrite all of them into their groups again.
-
View User Profile
-
Send Message
Posted Jun 11, 2012I AM USING THIS PERMISSIONS SYSTEM. WHEN I ALLOW PEOPLE ON, THE CAN NOT BUILD UNLESS THEY ARE ADDED TO THE OP-LIST.
HEEEEELLLLLPPPPP MEEEEEEEEE!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-
View User Profile
-
Send Message
Posted Jun 11, 2012@codename_B
Thanks :)
-
View User Profile
-
Send Message
Posted Jun 11, 2012What are permission nodes?
-
View User Profile
-
Send Message
Posted Jun 11, 2012@sillyrosster
It auto-alphabetises.
Turn auto-save: false in config.yml
-
View User Profile
-
Send Message
Posted Jun 11, 2012@captainstar4
That's json not yaml o.o
-
View User Profile
-
Send Message
Posted Jun 10, 2012Help me ive got everything and this is what my group code is this it took 4 hours to do and when i try to set a group it justs keeps saying too many arguments:
{
"efault": "default",
"groups": {
"Level 5": {
"meta": {
"prefix": "[&5Level 5]"
},
"groups": [
"level 4"
],
"permissions": [
"bukkit.command.ban.list",
"bukkit.command.list",
"bukkit.command.plugins",
"bukkit.command.teleport"
]
},
"Level 4": {
"meta": {
"prefix": "[&4Level 4]"
},
"groups": [
"level 3"
],
"permissions": [
"bukkit.command.kick"
]
},
"World Leader": {
"meta": {
"prefix": "[&8World]"
},
"groups": [
"nation leader"
],
"permissions": [
"bukkit.command.whitelist.disable",
"bukkit.command.whitelist.enable",
"bukkit.command.whitelist.remove"
]
},
"Level 1": {
"meta": {
"prefix": "[&1Level 1]"
},
"groups": [],
"permissions": [
"bukkit.command.help",
"worldportal.use"
]
},
"Village Leader": {
"meta": {
"prefix": "[&6Village]"
},
"groups": [
"level 5"
],
"permissions": [
"bukkit.command.save.perform",
"bukkit.command.toggledownfall",
"worldportal.create",
"worldportal.remove",
"worldportal.save",
"worldportal.teleport"
]
},
"Level 3": {
"meta": {
"prefix": "[&3Level 3]"
},
"groups": [
"level 2"
],
"permissions": [
"bukkit.command.tell"
]
},
"Level 2": {
"meta": {
"prefix": "[&2Level 2]"
},
"groups": [
"level 1"
],
"permissions": [
"bukkit.command.me",
"bukkit.command.version"
]
},
"Nation Leader": {
"meta": {
"prefix": "[&9Nation]"
},
"groups": [
"town leader"
],
"permissions": [
"bukkit.command.ban.ip",
"bukkit.command.gamemode",
"bukkit.command.give",
"bukkit.command.kill",
"bukkit.command.op.give",
"bukkit.command.op.take",
"bukkit.command.reload",
"bukkit.command.save.disable",
"bukkit.command.save.enable",
"bukkit.command.save.perform",
"bukkit.command.say",
"bukkit.command.time.add",
"bukkit.command.time.set",
"bukkit.command.unban.ip",
"bukkit.command.whitelist.list",
"bukkit.command.whitelist.remove",
"bukkit.command.xp"
]
},
"Town Leader": {
"meta": {
"prefix": "[&7Town]"
},
"groups": [
"village leader"
],
"permissions": [
"bukkit.command.ban.player",
"bukkit.command.pardon",
"bukkit.command.time",
"bukkit.command.unban.player",
"bukkit.command.whitelist.add",
"bukkit.command.whitelist.reload"
]
}
}
}
-
View User Profile
-
Send Message
Posted Jun 9, 2012I had one of my groups.yml nice and organized and then on a server restart it just un-organized it. Why does it do this?
What I mean is that I had the ranks in order and it messed them up and put them in random orders.
-
View User Profile
-
Send Message
Posted Jun 8, 2012Is there a way to select a user non-specifically i am trying to setup commandsigns to promote someone to a group when they click the sign (its a class thing) but im not sure how to make it select the person hitting the sign. im using /exec to set it up.
-
View User Profile
-
Send Message
Posted Jun 8, 2012@ewized
It'll require a total recode of the bPermissions API and a rewrite of the GUI - but it is possible.
I'll see how demand is for it - and if I need it myself I might just do it.
Would a seperate plugin to sync up permissions for servers be better?
-
View User Profile
-
Send Message
Posted Jun 8, 2012Hey I was wondering if there will be MySQL support soon or a way to have the same permissions on different servers?
-
View User Profile
-
Send Message
Posted Jun 8, 2012@robxu9
Why not setup the global.yml file for that?
-
View User Profile
-
Send Message
Posted Jun 7, 2012Hmm... In mirrors.yml, can you add support for wildcard worlds?
Ex, if want worlds that begin with instance_ to have all the permissions of world "instance", can you have worlds like instance_2348743124 or instance_5823156234 all share the same permissions as "instance"?
-
View User Profile
-
Send Message
Posted Jun 7, 2012@godgodgodgo
./exec u:codename_B a:setgroup v:admin