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!
Jenkins
Development builds of this project can now be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff, and are possibly buggy. Use them at your own risk.
Ever since I updated to the 2.12v Beta 3 bpermissions, I have to relog for my user perms to work with a plugin called MyPet.
" I have no idea why ........... It is happening in every single version for me... I am so confused ... Maybe it is permissions issue .. https://youtu.be/qrJaT-UOaR8 "
@rymate1234
I went through and changed all my ranks to lowercase and tracks as well and it seemed to work. Odd how it didn't work with caps but hey it is working now and that is what counts.
Thanks!
@EqlipseD
Yeah /promote seems to work as expected for me, moves the player through the groups on the track when executed.
Maybe try putting your track names in lowercase? For instance, rename "Time" to "time"
@rymate1234
So you are able to move a player through the track without a problem? When I do it on mine it only puts them on the first rank and won't move them to the next on any of the tracks.
Odd, not a big deal to me but it would have been convenient to just do /promote instead of the entire command.
@Alex81704
He wants to add a group to a player, not replace all the groups with one group. The idea with permissions tracks is you can assign people permissions to use a track without having to give them full bPermissions access
@EqlipseD
Try /world [your main world] /user [the user you want to toggle] /setgroup [the group]
Amazing update, seems to have fixed my lag issues so far,
Thanks so much rymate !
@EqlipseD
Right, I'll have to see why the multi track is broken then
EDIT: seems to work fine on my test server, not sure what the issue is :/
@MinecraftNotchinUnderwear
From the looks of you have your server in offline mode and have not changed the config setting for bPermissions to allows offline mode.
@rymate1234
In a single track it removes and previous ranks you may have in a different track and only adds the rank you were promoted to in that specific track and I need all the tracks said player has to remain in place because of the grouping that I have for ranks. I know you could do priority but I do not want Staff having access to other ranks they either did not earn or did not donate for and vice versa for other ranks.
@MinecraftNotchinUnderwear
If the plugin is red in /plugins then there must've been an error somewhere.
@EqlipseD
you're not the only person who hasn't used tracks - I haven't a clue why it isn't working. Can I ask why it needs to be multitrack rather than single track?
this is broken for me... no errors, its just red and /pl and doesn't work...
I am having a bit of an issue with tracks. I have never used them before so I could be using them wrong.
Currently I have 3 different tracks:
I have the config setup for mutli track but when I use the /promote command and promote myself in any track it never goes to the next rank in the track. It works fine in single track but I need it to work in multi track. I have tried everything I could possibly think of including adding 'default' in the start of each track it just never goes to the next rank in the track.
thanks will test it out !
@tcarey2015
No, it means that when you run /bp save it saves the files in a seperate thread. This means that saving will not lag out the server. Users will still get the rank as soon as you give it to them.
Beta 2 isn't the one that fixes your issue - Beta 3 is the one that fixes it.
Also with the 2nd version I still get lag when players log in ;(
v2.12 Beta 2 for 1.8.1 Nov 21, 2015
My files are large because I have been using your plugin for almost 3 years ...
Does this new update mean if i add a user to a new rank , they wont get the rank until I do /bp save?
Lol I just spent an hour today removing /bp save and adding it to a scheduled timer instead so it would lag less
@tcarey2015
The new build is available at http://dev.bukkit.org/bukkit-plugins/bpermissions/files/173-v2-12-beta-3/ - please test and see if it improves your lag issues :)
@tcarey2015
Good news is I reckon I have a fix, I'm testing it now and will release if it doesn't majorly break anything
File saving / loading still takes a long time, but it is now actually done in a seperate thread, whereas before although I was using the bukkit scheduler I wasn't running it async, meaning it ran on the main thread.
If the fix works, and doesn't have any unforeseen side effects, I'll push the update in the next hour or so.
Yeah ive resorted to only letting the server do /bp save once per 5 hours to stop lag now .. ;(
@tcarey2015
For a start - no, you're not using bPermissions incorrectly. Running /bp save when someone ranked up is how I managed my server back in the day.
I'll see if I can optimise the saving so it doesn't lag out the server so much. Thanks for providing the configs though, that'll help with debugging :)