PermissionsBukkit

Table of Contents

PermissionsBukkit - the Official Default Groups Plugin
Current Version: v2.3 (beta v2.4)
Find PermissionsBukkit on the forums!

It's been a long time coming, but with the accomplishment of build 1000 Bukkit has finally accomplished a built-in Permissions system (codenamed Superperms). For more info on how they work, and how to integrate them with your plugin, see the official Permissions FAQ. Keep in mind that you should rarely, if ever, have to hook this plugin directly; instead keep things in the realm of checking player.hasPermission("yourplugin.node"). The FAQ thread has more info on how to use Superperms with things like chat prefixes/suffixes.

Features:

Storage of users and groups in plugins/PermissionsBukkit/config.yml.
Both users and groups can be assigned individual permissions and parent groups to inherit permissions from.
Support for global and per-world permissions.
Reload configuration from file without reloading the plugin.
Ability to check if a player has a specific permission node.
Ability to dump all permissions a player has and the plugins that set them.
Ability to print plugin, description, and default for a given permission node.
Ability to modify the permissions of groups and users and the groups of a user in-game.
Built-in antibuild via the "permissions.build" node (defaults to allowing anyone to build).

Downloads:
Current Beta Version:
PermissionsBukkit v2.4 beta (details)
Current Version:
PermissionsBukkit v2.3 (jar) (details)
Previous Beta Version (for older than 1.7.6):
PermissionsBukkit v2.2 beta (details)

Other Important Information:
Commands
Configuration
FAQ

Changelog:
For changelog information, known caveats, and other release notes, see the entries on the files page.

Plugin Metrics
PermissionsBukkit gathers some information about your usage via PluginMetrics. The information is available here, and you can disable metrics on your server by changing 'opt-out' to true in plugins/PluginMetrics/config.yml. You can view your own stats with the /perm about command.
PermissionsBukkit collects this information about your specific usage:

The number of groups, users, worlds, permissions, and permission roots (first parts) in your configuration.
Whether you use per-user permissions, per-world permissions, group inheritance, and API features.
Whether anti-build is enabled, assigned to the default group, and has a message.
Whether debug mode or custom permissions (permissions.yml file) are in use.
Whether the example user "ConspiracyWizard" is in your configuration (this is not a real person).

Additionally, some information is collected by PluginMetrics by default:

Java version
Operating system
Authentication mode (online/offline)
System architecture (32/64-bit) and core count
Game version
Server location

Comments

_ForgeUser7793149
- Join Date: 10/31/2011
- Posts: 18
- Member Details
#410 _ForgeUser7793149

View User Profile

Send Message

Posted Apr 10, 2012
BACKUP YOUR CONFIG FILE BEFORE EDITING

If you make a mistake and break the config file, then reload the plugin it completely wipes the config.

Rollback Post to Revision RollBack
_ForgeUser7629037
- Join Date: 9/30/2011
- Posts: 85
- Member Details
#409 _ForgeUser7629037

View User Profile

Send Message

Posted Apr 10, 2012
@FiddyCraft

It doesn't need to... Any player that is not in the config is automatically part of the 'default' group.

Rollback Post to Revision RollBack

_ForgeUser7531268

Join Date: 9/11/2011
Posts: 147
Member Details

#408 Posted Apr 10, 2012

can anyone tell me why players are not automatically being added to the default permissions?

# PermissionsBukkit configuration file
# 
# A permission node is a string like 'permissions.build', usually starting
# with the name of the plugin. Refer to a plugin's documentation for what
# permissions it cares about. Each node should be followed by true to grant
# that permission or false to revoke it, as in 'permissions.build: true'.
# Some plugins provide permission nodes that map to a group of permissions -
# for example, PermissionsBukkit has 'permissions.*', which automatically
# grants all admin permissions. You can also specify false for permissions
# of this type.
# 
# Users inherit permissions from the groups they are a part of. If a user is
# not specified here, or does not have a 'groups' node, they will be in the
# group 'default'. Permissions for individual users may also be specified by
# using a 'permissions' node with a list of permission nodes, which will
# override their group permissions. World permissions may be assigned to
# users with a 'worlds:' entry.
# 
# Groups can be assigned to players and all their permissions will also be
# assigned to those players. Groups can also inherit permissions from other
# groups. Like user permissions, groups may override the permissions of their
# parent group(s). Unlike users, groups do NOT automatically inherit from
# default. World permissions may be assigned to groups with a 'worlds:' entry.
users:
  Fiddy_percent:
    permissions:
      permissions.example: true
    groups:
    - Mayor
  TheDevlin:
    permissions:
      permissions.example: true
    groups:
    - Mayor
  police:
    groups:
    - ludo0777
  tempest717:
    groups:
    - Officer
  nuns:
    groups:
    - default
  mastaman88:
    groups:
    - Officer
  capt_pwnzedyou:
    groups:
    - default
  latinhurricane:
    groups:
    - default
  atsu91:
    groups:
    - default
  trevcat9:
    groups:
    - default
  martinkaca:
    groups:
    - default
  madichan:
    groups:
    - default
  sstevenlynch:
    groups:
    - default
  concernedape:
    groups:
    - default
  xnin7a:
    groups:
    - default
  generalmorg:
    groups:
    - default
  debbin:
    groups:
    - default
  xxboonexx:
    groups:
    - default
  thesorrowwhmo:
    groups:
    - default
  thesorrowhmo:
    groups:
    - default
  zephyrzx:
    groups:
    - default
  ritorin:
    groups:
    - default
  terran350:
    groups:
    - default
  sethen123:
    groups:
    - default
  qintuo:
    groups:
    - default
  broncos29:
    groups:
    - default
  dumbum:
    groups:
    - default
  '11196':
    groups:
    - default
  kruiserful:
    groups:
    - default
  crazy442:
    groups:
    - default
  mekchrious:
    groups:
    - default
  ferritofdoom:
    groups:
    - default
  bradleyjess:
    groups:
    - default
groups:
  Mayor:
    permissions:
      permissions.*: true
      cookme.reload: true
      cookme.help: true
      treasurechest.admin: true
      realshop.infinitesell: true
      cookme.enable.all: true
      cookme.enable.death: true
      cookme.enable.venom: true
      lwc.admin: true
      mobs.can_spawn_mobs: true
      admincmd.mob.*: true
      admincmd.player.spy: true
      admincmd.invisible.cansee: true
      admincmd.player.noafkkick: true
      admincmd.server.lockdown: true
      admincmd.player.god: true
      admincmd.player.fly.allowed: true
      admincmd.player.fakequit: true
      selfservice.admin: true
      mchat.prefix.Mayor: true
      mchat.prefix.Officer: false
      simpleprefix.Mayor: true
    inheritance:
    - Officer
  Officer:
    permissions:
      admincmd.player.kill.other: true
      admincmd.tp.to: true
      admincmd.tp.back: true
      admincmd.player.fireball: false
      admincmd.server.lockdown: true
      admincmd.server.extinguish: true
      admincmd.server.uptime: true
      admincmd.player.ip.other: true
      admincmd.player.mute: true
      admincmd.player.god: true
      admincmd.player.fly.allowed: true
      admincmd.player.fakequit: true
      admincmd.player.ban: true
      admincmd.player.freeze: true
      admincmd.player.invisible: true
      admincmd.player.whois: true
      admincmd.player.kick: true
      lwc.mod: true
      simpleprefix.Officer: true
      mchat.prefix.Farmer: false
      mchat.prefix.Officer: true
    inheritance:
    - default
  Farmer:
    inheritance:
    - default
  default:
    permissions:
      admincmd.player.msg: true
      admincmd.player.reply: true
      admincmd.player.afk: true
      admincmd.server.help: true
      admincmd.server.motd: true
      admincmd.server.news: true
      admincmd.player.list: true
      admincmd.player.kill: true
      admincmd.server.rules: true
      admincmd.player.roll: true
      admincmd.player.played: true
      admincmd.spawn.tp: true
      admincmd.tp.home: true
      selfservice.buy: true
      selfservice.rent: true
      appleseed.plant.*: true
      iConomy.user: true
      FirstSpawn.use: true
      appleseed.plant.apple: true
      appleseed.plant.glowstone_dust: true
      appleseed.plant.nether_stalk: true
      appleseed.plant.ender_pearl: true
      appleseed.wand: true
      permissions.build: true
      simpleprefix.Farmer: true
      mchat.prefix.Stranger: false
      mchat.prefix.Farmer: true
      seasons.weather: true
      lwc.protect: true
      Signshop.Signs.Sell: true
      Signshop.Signs.Buy: true
      realshop.shop: true
      realshop.marketitemsonly: true
      CommandRank.useSign: true
      nospawneggs.animal.*: true
      treasurechest.player: true
messages:
  build: '&cYou do not have permission to build here.'
debug: false

_ForgeUser7629037
- Join Date: 9/30/2011
- Posts: 85
- Member Details
#407 _ForgeUser7629037

View User Profile

Send Message

Posted Apr 9, 2012
@InsidiousDesign

Actually you are wrong about the indention.. At first i thought 4 spaces indention was wrong too. I fixed a lot of peoples configs back at the forum page and got ALL of them working. (except for 1 who refused to show his config as he is 100% sure it is not the problem, i don't agree with that though...) The last one however.. was literally over 9000 lines long with 4 spaces of indention each level. So before changing the indention on 9000 lines i tried to fix any other errors first. And it turned out (luckily) that it was working with 4 spaces indention too.

Last edited by _ForgeUser7629037: Apr 9, 2012

Rollback Post to Revision RollBack
Themonkey180
- Join Date: 11/10/2011
- Posts: 23
- Member Details
#406 Themonkey180

View User Profile

Send Message

Posted Apr 9, 2012
2012-04-09 21:56:43 [WARNING] [PermissionsBukkit] In group admin: bukkit.command.unban.ip is non-boolean (+3 more). How do I use this kind of Permissions. If it is non-Boolean.

Rollback Post to Revision RollBack
_ForgeUser6898239
- Join Date: 5/26/2011
- Posts: 323
- Member Details
#405 _ForgeUser6898239

View User Profile

Send Message

Posted Apr 9, 2012
Ok i changed to Group Manager.

Rollback Post to Revision RollBack
_ForgeUser7631822
- Join Date: 10/1/2011
- Posts: 41
- Member Details
#404 _ForgeUser7631822

View User Profile

Send Message

Posted Apr 8, 2012
1.2.5 :D

Rollback Post to Revision RollBack
_ForgeUser8653369
- Join Date: 3/27/2012
- Posts: 5
- Member Details
#403 _ForgeUser8653369

View User Profile

Send Message

Posted Apr 8, 2012
@beastzone

Yes, this is a bug. I just stopped using factions for this reason, and its really unneeded

Rollback Post to Revision RollBack
_ForgeUser6929054
- Join Date: 5/30/2011
- Posts: 112
- Member Details
#402 _ForgeUser6929054

View User Profile

Send Message

Posted Apr 8, 2012
for some reason when someone makes a faction it does this weird thing...i have simple prefix:

Rollback Post to Revision RollBack
_ForgeUser7506326
- Join Date: 9/6/2011
- Posts: 93
- Member Details
#401 _ForgeUser7506326

View User Profile

Send Message

Posted Apr 7, 2012
Im already switching over to bPermissions. This Author doesnt have a team to manage it so it will die out.

Rollback Post to Revision RollBack

_ForgeUser8653369

Join Date: 3/27/2012
Posts: 5
Member Details

#400 Posted Apr 7, 2012

To everyone I seem to have found a fix. For every plugin, you must use their plugin.* node. You must use only two spaces instead of 4 for indents. You must name your starting group (Default group) to default. Prefix's must come from a 3rd party plugin (another plugin, i.e.- simpleprefix which gives you a node to add to the permissions). To promote a player you use /permissions player addgroup <player name> <group> THEN ALSO /permissions player removegroup <player name> <old group>. There must be NO blank lines in your config.yml. There must be no YML mistakes, double, triple and quadruple check. I hope this answers all of the questions that I have found so far because everything is working perfectly on my server. Best of luck -Wil

# PermissionsBukkit configuration file
# 
# A permission node is a string like 'permissions.build', usually starting
# with the name of the plugin. Refer to a plugin's documentation for what
# permissions it cares about. Each node should be followed by true to grant
# that permission or false to revoke it, as in 'permissions.build: true'.
# Some plugins provide permission nodes that map to a group of permissions -
# for example, PermissionsBukkit has 'permissions.*', which automatically
# grants all admin permissions. You can also specify false for permissions
# of this type.
# 
# Users inherit permissions from the groups they are a part of. If a user is
# not specified here, or does not have a 'groups' node, they will be in the
# group 'default'. Permissions for individual users may also be specified by
# using a 'permissions' node with a list of permission nodes, which will
# override their group permissions. World permissions may be assigned to
# users with a 'worlds:' entry.
# 
# Groups can be assigned to players and all their permissions will also be
# assigned to those players. Groups can also inherit permissions from other
# groups. Like user permissions, groups may override the permissions of their
# parent group(s). Unlike users, groups do NOT automatically inherit from
# default. World permissions may be assigned to groups with a 'worlds:' entry.
users:
  djoutbased:
    groups:
    - default
  XxShadowz:
    groups:
    - admin
  ztg123:
    groups:
    - mod
  xxchicken:
    groups:
    - member
  aloum:
    groups:
    - trusted
  coooy:
    groups:
    - member
  guest:
    groups: []
groups:
  default:
    permissions:
      permissions.build: false
      simpleprefix.default: true
      essentials.warp.tutorial: true
      essentials.warp: true
      essentials.spawn: true
      essentials.rules: true
      essentials.motd: true
      essentials.list: true
      essentials.helpop: true
      essentials.help: true
      essentials.realname: true
  member:
    permissions:
      permissions.build: true
      bukkit.broadcast.user: true
      essentials.home: true
      essentials.sethome: true
      essentials.afk: true
      essentials.help: true
      essentials.kit: true
      essentials.list: true
      essentials.mail: true
      essentials.mail.send: true
      essentials.me: true
      essentials.motd: true
      essentials.msg: true
      essentials.near: true
      essentials.realname: true
      essentials.rules: true
      essentials.spawn: true
      essentials.whois: true
      essentials.compass: true
      essentials.depth: true
      essentials.ignore: true
      essentials.kit.tools: true
      essentials.ping: true
      essentials.suicide: true
      essentials.time: true
      essentials.tpa: true
      essentials.tpaccept: true
      essentials.tpahere: true
      essentials.tpdeny: true
      essentials.warp.list: true
      lockette.user.*: true
      lockette.user.create.*: true
      lockette.user.create.brewingstand: true
      lockette.user.create.chest: true
      lockette.user.create.custom: true
      lockette.user.create.dispenser: true
      lockette.user.create.door: true
      lockette.user.create.furnace: true
      lockette.user.create.trapdoor: true
      simpleprefix.member: true
      simpleprefix.default: false
      dt.travel: true
      essentials.warp.reclaim: true
    inheritance:
    - default
  trusted:
    permissions:
      permissions.build: true
      simpleprefix.trusted: true
      simpleprefix.member: false
    inheritance:
    - member
  admin:
    permissions:
      permissions.*: true
      bukkit.*: true
      factions.*: true
      lockette.*: true
      vanish.*: true
      worldedit.*: true
      worldguard.*: true
      essentials.*: true
      simpleprefix.commands.*: true
      multiworld.*: true
      voxelport.*: true
      simpleprefix.admin: true
      simpleprefix.mod: false
      -essentials.backup: true
      -essentials.essentials: true
      -essentials.setspawn: true
      -essentials.reloadall: true
    inheritance:
    - mod
  mod:
    permissions:
      bukkit.command.ban: true
      bukkit.command.banip: true
      bukkit.command.banplayer: true
      bukkit.command.kick: true
      factions.kick: true
      factions.kick.any: true
      factions.kit.mod: true
      factions.mod: true
      factions.mod.any: true
      group.moderator: true
      simpleprefix.mod: true
      simpleprefix.trusted: false
      essentials.tp.*: true
      essentials.warp.*: true
      essentials.ban: true
      essentials.ban.notify: true
      essentials.banip: true
      essentials.broadcast: true
      essentials.clearinventory: true
      essentials.delwarp: true
      essentials.eco.loan: true
      essentials.ext: true
      essentials.getpos: true
      essentials.helpop.recieve: true
      essentials.home.others: true
      essentials.invsee: true
      essentials.jails: true
      essentials.jump: true
      essentials.kick: true
      essentials.kick.notify: true
      essentials.kill: true
      essentials.mute: true
      essentials.nick.others: true
      essentials.realname: true
      essentials.setwarp: true
      essentials.spawner: true
      essentials.thunder: true
      essentials.time: true
      essentials.time.set: true
      essentials.ptime: true
      essentials.ptime.others: true
      essentials.togglejail: true
      essentials.top: true
      essentials.tp: true
      essentials.tphere: true
      essentials.tppos: true
      essentials.tptoggle: true
      essentials.unban: true
      essentials.unbanip: true
      essentials.weather: true
      essentials.whois: true
      essentials.world: true
    worlds:
      creative:
        coolplugin.item: true
    inheritance:
    - trusted
messages:
  build: '&cYou do not have permission to build here.'
debug: false

_ForgeUser6898239
- Join Date: 5/26/2011
- Posts: 323
- Member Details
#399 _ForgeUser6898239

View User Profile

Send Message

Posted Apr 7, 2012
Bump this new thread i made to fix the permissionsbukkit plugin :)

http://forums.bukkit.org/threads/permissionsbukkit-the-official-default-groups-plugin.69282/

Last edited by _ForgeUser6898239: Apr 7, 2012

Rollback Post to Revision RollBack
Themonkey180
- Join Date: 11/10/2011
- Posts: 23
- Member Details
#397 Themonkey180

View User Profile

Send Message

Posted Apr 5, 2012
2012-04-05 20:42:11 [INFO] [PermissionsBukkit] Enabling PermissionsBukkit v1.6 2012-04-05 20:42:11 [SEVERE] [PermissionsBukkit] Unable to load configuration! 2012-04-05 20:42:11 [INFO] [PermissionsBukkit] Enabled successfully, 0 players registered 2012-04-05 20:42:11 [INFO] [Vault][Permission] PermissionsBukkit hooked. 2012-04-05 20:42:11 [INFO] [Vault][Chat] iChat hooked.

anyone know why this is happening.

Rollback Post to Revision RollBack
_ForgeUser7479062
- Join Date: 9/1/2011
- Posts: 47
- Member Details
#396 _ForgeUser7479062

View User Profile

Send Message

Posted Apr 5, 2012
@Kryplefyte

DwD, would be gladly to pay someone as well to keep this plugin active.

Rollback Post to Revision RollBack
_ForgeUser7117891
- Join Date: 7/1/2011
- Posts: 24
- Member Details
#395 _ForgeUser7117891

View User Profile

Send Message

Posted Apr 5, 2012
why can my mods set them self to Owners ??? or is it a command/permission ? i nead to remove or add ? //www.planetminecraft.com/server/qualitygaming/" rel="noopener nofollow" target="_blank">http://www.planetminecraft.com/server/qualitygaming/" title="Qualitygaming [24/7] [multi-world] [Economy] [Jobs] [ranks] Minecraft Server">
//www.planetminecraft.com/files/resource_media/screenshot/1212/2012-03-25_220535_1800162_thumb.jpg" rel="noopener nofollow" target="_blank">http://www.planetminecraft.com/files/resource_media/screenshot/1212/2012-03-25_220535_1800162_thumb.jpg" alt="Qualitygaming [24/7] [multi-world] [Economy] [Jobs] [ranks]"/>
View Qualitygaming [24/7] [multi-world] [Economy] [Jobs] [ranks]

Last edited by _ForgeUser7117891: Apr 5, 2012

Rollback Post to Revision RollBack
_ForgeUser7388274
- Join Date: 8/15/2011
- Posts: 11
- Member Details
#394 _ForgeUser7388274

View User Profile

Send Message

Posted Apr 5, 2012
I would pay money to have this working again. just wiped my freaking config file.

Hopefully there is an official 1.2.4 out soon.

Rollback Post to Revision RollBack
_ForgeUser8633813
- Join Date: 3/24/2012
- Posts: 26
- Member Details
#393 _ForgeUser8633813

View User Profile

Send Message

Posted Apr 5, 2012
Everytime i do "/permissions group players user" it can't find the group "user" and them when i do "/permissions group list" it says "an internal error occured."

Rollback Post to Revision RollBack
_ForgeUser7104783
- Join Date: 6/30/2011
- Posts: 1
- Member Details
#392 _ForgeUser7104783

View User Profile

Send Message

Posted Apr 4, 2012
Hey guys,

I have just downloaded the source code for PermissionsBukkit and found the problem of why all your servers wont load the configurations.

I am currently looking into how to fix this for you guys. Please be patient though, I am doing this off my own back.

I CAN'T PROMISE ANYTHING

Thanks

Kyle

Rollback Post to Revision RollBack
khamseen
- Join Date: 5/21/2011
- Posts: 24
- Member Details
#391 khamseen

View User Profile

Send Message

Posted Apr 4, 2012
@snowy007

Because people don't seem to have the thought process required to test something before complaining.

Rollback Post to Revision RollBack
_ForgeUser7629037
- Join Date: 9/30/2011
- Posts: 85
- Member Details
#390 _ForgeUser7629037

View User Profile

Send Message

Posted Apr 4, 2012
Why do people keep saying that this plugin is dead?
It works perfectly fine for me on 1.2.4-R1.0

And remember that before 1.2 this plugin hadn't been updated for like 7 months or something either. Now that 1.2 broke every single plugin he updated it so it would work again. It is obviously NOT dead. He is just not adding any more features. He just makes sure it keeps working the way it is supposed to.
And since it is still working there is no need for him to update it.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

31046
Created

Aug 24, 2011
Last Released File

Mar 1, 2016
Total Downloads

905,978
License

MIT License

Bukkit

PermissionsBukkit

Bukkit Plugins