PermissionsBukkit

PermissionsBukkit - the Official Default Groups Plugin
Current Version: v2.0 (beta v2.2)
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 Version:
PermissionsBukkit v2.0 (jar) (details)
Beta Version:
PermissionsBukkit v2.2 beta (details)
Old Versions:
PermissionsBukkit v1.6 (jar) (details)

http://i.imgur.com/NOZPK.png

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

Other Important Information:
Commands
Configuration
FAQ

Changelog:

Thursday 6 February 2013 (2.2)

  • Big performance improvements to situations where permissions are calculated (player join, player change world, /perm command use).
  • Fixed anti-build message not showing up.
  • Better preserve order of permission settings.
  • Fixed potential problems with permission refreshing happening to a wrong player with a similar name.
  • Added more helpful handling of invalid configuration files.
  • Fixed some error spam in metrics if configuration was invalid.
  • Added /perm dump -file command to create a text file listing permission info.

Saturday 25 May 2013 (2.1)

  • Added tab-completion - hit tab to bring up a list of possibilities on almost all `/perm` command arguments
  • Added crash prevention and a warning for groups that inherit themselves
  • Added information on how many logged-in users (including console) have a permission to the `/perm info` command
  • Marginally improved performance of the included antibuild
  • More advanced plugin metrics added to MCStats

Friday 7 September 2012 (2.0)

  • Fixed a case-sensitivity issue with setting per-world permissions that could cause some permissions to fail to apply.
  • Added /perm setrank <player> <group> subcommand (alias rank) with per-group permissions (permissions.setrank and permissions.setrank.<group>)
  • Added plugin metrics via http://mcstats.org/plugin/PermissionsBukkit (disableable in plugins/PluginMetrics/config.yml)

Wednesday 29 February 2012 (1.6)

  • Fixed some massive issues that were caused due to having uploaded a buggy, in-development version instead of 1.5.
  • Note: If your configuration was messed up as a result of this issue, the new build should gradually correct it as needed.

Saturday 25 February 2012 (1.5)

  • Revamped to be compatible with R5.
  • Fixed issues with permissions not carrying properly on world change.
  • Many internal improvements for performance and stability.
  • SuperpermsBridge: in honor of R5 removing deprecated code, SuperpermsBridge is officially gone!

Monday 18 July 2011 (1.1/1.2)

  • Fix BukkitContrib incompatibility issues.
  • Improved the output of the /perm check command.
  • Fixed issues when 'users:' is not specified in the config file.
  • Fixed the /permissions reload command.
  • SuperpermsBridge: improve wildcard handling; in addition to 'superpermbridge.*' and 'superpermbridge.pluginname', now supported are 'superpermbridge.plugin.*', 'superpermbridge.plugin.subnode.*', and so on.

Monday 18 July 2011 (1.0/1.1)

  • SuperpermsBridge: adding the special 'superpermbridge.*' and 'superpermbridge.pluginname' nodes (see #2 in the FAQ for details).

Sunday 17 July 2011 (1.0/1.0)

  • Initial release of PermissionsBukkit v1.0 and SuperpermsBridge v1.0.

http://api.mcstats.org/signature/PermissionsBukkit.png

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of nonox97 nonox97 Apr 09, 2012 at 04:11 UTC - 0 likes

    1.2.5 :D

    On ne fait pas chier ceux qui font chier.

  • Avatar of InsidiousDesign InsidiousDesign Apr 09, 2012 at 00:37 UTC - 0 likes

    @beastzone: Go

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

  • Avatar of beastzone beastzone Apr 08, 2012 at 21:40 UTC - 0 likes

    for some reason when someone makes a faction it does this weird thing...i have simple prefix:

    factions and prefix mix up

    • faction_and_prefix_error.PNG
      picture of faction and prefix ...
    command /HELP!!!!:
    	trigger:
    		message "Msg Beastzone With Your Problem =)"
    	#Anytime You need
    		message "http://dev.bukkit.org/profiles/beastzone/"
    

    Skript Fest

  • Avatar of Redstorm3265 Redstorm3265 Apr 08, 2012 at 02:47 UTC - 0 likes

    Im already switching over to bPermissions. This Author doesnt have a team to manage it so it will die out.

  • Avatar of InsidiousDesign InsidiousDesign Apr 08, 2012 at 00:21 UTC - 0 likes

    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
    
  • Avatar of Switch0r Switch0r Apr 07, 2012 at 11:37 UTC - 0 likes

    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 Apr 07, 2012 by Switch0r

    http://www.multicraft.creativeteamspeak.com/index.php?r=status/418.png

  • Avatar of Themonkey180 Themonkey180 Apr 06, 2012 at 00:44 UTC - 1 like

    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.

  • Avatar of dwdminecraft dwdminecraft Apr 05, 2012 at 22:46 UTC - 0 likes

    @Kryplefyte: Go

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

    BFAK:madmac,35254,9cf26f15ff67c7a8669c6745ae0f12ad61f24e3b61457507b3b0856b77f6bd0a

  • Avatar of sanoj96 sanoj96 Apr 05, 2012 at 14:01 UTC - 0 likes
    why can my mods set them self to Owners ??? or is it a command/permission ? i nead to remove or add ?
    Qualitygaming [24/7] [multi-world] [Economy] [Jobs] [ranks]
    View Qualitygaming [24/7] [multi-world] [Economy] [Jobs] [ranks]
    Last edited Apr 05, 2012 by sanoj96
  • Avatar of Kryplefyte Kryplefyte Apr 05, 2012 at 13:30 UTC - 1 like

    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.

    Survival PVP server. www.kryplekraft.com

I'm a poll!

  1. Choice:

  1. Results
  2. 29 comments

Facts

Date created
Aug 25, 2011
Categories
Last update
Feb 07, 2014
Development stage
Release
Language
  • enUS
License
MIT License
Curse link
PermissionsBukkit
Downloads
765,199
Recent files

Authors