Bug fixes and general improvements are in the works!

Ever had to get permission nodes for plugins on your server, but found that you either had to look for it on their website or individually look in plugin.yml? Or maybe you found a list of nodes, but it had the description next to it so you couldn't just copy and paste them all at one time? Well, this plugin is for you! GetPerms is a plugin that will pull permission nodes from each plugin on your server! This plugin will output them in two files:

  1. permission_nodes.txt - A list of permissions without the descriptions for easy copy/paste
  2. permission_nodes_desc.txt - A list of permissions with the descriptions for reference, grouped by plugin

Bugs/problems/feature requests? Report at the TICKETS area.

Current version: 1.1.13 May be pending approval!

Download mirrors
All versions
Current version (1.1.13) @
Latest developmental build @ NOTE: The jarfile located here is a developmental build, so things aren't tested and bugs are likely to be present

View the complete changelog here.

1. Download the plugin
2. Move the jar file to '/plugins' inside the server root directory

To start, you must download and install this plugin. To have the plugin generate the files, start your server, and wait for the server to finish fully starting up (look for 'Done! _ seconds'). Now, just wait until you see a message stating that GetPerms has finished generating files. Now you can either stop your server if you don't need it running, or you can leave it running. Now, locate the GetPerms folder inside of the plugins folder (located at plugins/GetPerms/). In this folder, you should see two new files: permission_nodes.txt and permission_nodes_desc.txt. More information about each file can be located here.

Plugins must be in the 'plugins/' folder in order for GetPerms to grab the permission nodes from it. Also, GetPerms can only retrieve nodes that are in '[plugin_name].jar/plugin.yml' due to Bukkit's current methods. Not all plugins provide all permissions in plugin.yml, so there may be some missing. Essentials is an example of this.

Bugs/problems/feature requests? Report at the TICKETS area.

For all commands, /gp can be used as an alias (like /gp regen)
/getperms regen - (Re)generate the files containing the permission nodes lists
/getperms reload - Reload the configuration file for GetPerms

/getperms regen is especially useful if autoGen is set to false.
NOTE: If disableOnFinish is set to true, these commands will not work once the plugin disables itself.

Permission nodes:
getperms.regen - Allows player to regenerate permission list files
getperms.reload - Allows player to reload the GetPerms config file

Bugs/problems/feature requests? Report at the TICKETS area.

This is my first plugin! Requests for another plugin? Want me to update an outdated/abandoned plugin? Request it here.

I will be adding a database of permissions that cannot be retrieved from plugin.yml for widely used plugins (such as Essentials). You can find more information here.



  • Add database of unretrievable permissions for retrieval (info here)
  • Add a way for plugin to retrieve entries from database
  • Add a search command to search plugins for a specific permission node
  • Add a way to be able to import a permission node table (Such as with essentials) as a text file and convert it

Feature completion progress:
Add entries to database: 24%
Database retrieval: 6%

Bugs/problems/feature requests? Report at the TICKETS area.

You can request to add plugins to the database here.
Want a plugin to be made? Go here!

Remember, please report any bugs/feature requests in the TICKETS area. The comment section is for everything but bugs and feature requests. This plugin now generates comments in the config.yml! The TICKETS area. TICKETS.

The GetPerms repository can be found here.


Feel like helping out? Consider donating!
GetPerms by Smiley43210 is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.

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

  • Avatar of Smiley43210 Smiley43210 May 06, 2013 at 11:22 UTC - 0 likes

    An update has been released for CB 1.5.1-R0.2! See the changelog for details. This may fix a few issues.

  • Avatar of Smiley43210 Smiley43210 May 06, 2013 at 00:33 UTC - 0 likes

    @x_clucky: Go

    Back from a looong break from Bukkit! Hm....let me check it out. Expect an update!

    Oh, and I think if you enabled debug mode, you would have seen why. Look at the version in the config, and the version stated in the startup message. In the config, it says 1.1.4. The startup message says 1.1.6. Not sure as to why it didn't update the config automatically though. Changing the version in the config should cease the problem for now. My bad.

    Last edited May 06, 2013 by Smiley43210
  • Avatar of x_clucky x_clucky Mar 15, 2013 at 17:04 UTC - 0 likes

    This little thing here:

    2013-03-15 13:00:23 [INFO] [GetPerms] Enabling GetPerms v1.1.6
    2013-03-15 13:00:23 [INFO] [GetPerms] This plugin is not sending usage stats.
    2013-03-15 13:00:23 [INFO] [GetPerms] This plugin supports PermissionsEx, which will be used if detected.
    2013-03-15 13:00:23 [INFO] [GetPerms] PEx detected! Using as permissions plugin!
    2013-03-15 13:00:23 [INFO] [GetPerms] Downloading changelog and readme...

    Is pissing me off.... It prevents my server from starting up, even though the config says not to download it:

    #GetPerms config file.
    #Config version. DO NOT CHANGE! Changing may cause undesirable results!
    cfgV: "1.1.4"
    #Is it the first run?
    #DO NOT CHANGE! Even if it's still true after you run it, don't change it.
    #Used to manage certain actions at startup.
    firstRun: false
    #Should the plugin send usage stats to
    sendStats: false
    #Display output on startup/shutdown/generation? Does not display error messages or
    #debug messages even if debug is enabled. Will still display 'GetPerms vX.X.X enabled!'
    silentMode: false
    #Weather or not to automatically generate the permissions files on startup.
    autoGen: true
    #When true, if any plugin is removed, added, or updated, the permission files will be regenerated.
    regenerateOnPluginChange: true
    #Weather or not to check for updates.
    autoUpdate: false
    #Should the newest GetPerms.jar be downloaded?
    autoDownload: false
    #Disable the plugin once it finishes?
    #When true, the commands to regenerate the permissions files will not work!
    disableOnFinish: false
    #Download the latest dev build? May have bugs and errors.
    #If set to false, will only download the latest recommended build.
    devBuilds: false
    #Debug if needed for errors/bugs/info.
    debugMode: false

    Remove it now... This is as annoying as programs making you install yahoo toolbar, nobody wants this...

  • Avatar of KillerGothone KillerGothone Oct 14, 2012 at 14:58 UTC - 0 likes

    Would this work with permissonsex type of config like

    groups: options: rank: '1000' default: default: true permissions: - commandbook.who - commandbook.away - commandbook.warp.list - commandbook.return - - commandbook.warp.teleport - commandbook.motd - commandbook.clear - commandbook.whereami.* - commandbook.whereami - commandbook.msg - - commandbook.spawn - commandbook.kit.list - commandbook.kit.kits.snack - commandbook.kit.kits.starter - commandbook.kit.kits.dtools - commandbook.rules - commandbook.home.teleport - commandbook.home.set - modifyworld.* prefix: '&7' suffix: '&f'

  • Avatar of Smiley43210 Smiley43210 Sep 30, 2012 at 05:22 UTC - 0 likes

    @ProKoolio: Go

    As of right now, Essentials is generated in a separate file, EssentialsPnodes.txt and EssentialsPnodesfull.txt. They will eventually be merged with pnodes.txt and pnodesfull.txt

    @jeffjones33: Go

    A plugins.txt file is generated in GetPerm's config folder

  • Avatar of ProKoolio ProKoolio Sep 15, 2012 at 14:03 UTC - 0 likes

    Is it just me or can none see any of the permission nodes for Essentials, World Edit and World guard and various other plugins? i see pretty much all of the others except these

  • Avatar of jeffjones33 jeffjones33 Aug 27, 2012 at 09:02 UTC - 0 likes

    Is It also possible to have a list of the server's plugins generated?

    Last edited Aug 27, 2012 by jeffjones33
  • Avatar of Smiley43210 Smiley43210 Aug 20, 2012 at 09:23 UTC - 0 likes

    @xH3LLRAIZ3Rx: Go

    Please look for a file called EssentialsPnodes.txt and EssentialsPnodesfull.txt in the root server directory as the permission nodes aren't directly supplied by the Essentials.jar file. These are in separate files because they are pulled from a database that I have.

    If the aforementioned files are not found, please post a ticket with details so that I may accurately and quickly find the problem. Of course, if you don't have very many details, post a ticket anyway and try to answer as many questions as possible.

    Last edited Aug 20, 2012 by Smiley43210
  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx Aug 19, 2012 at 20:06 UTC - 0 likes

    @Smiley43210: Go

    You Need to fix something im not showing the perms for essentials

  • Avatar of Smiley43210 Smiley43210 Jun 11, 2012 at 06:54 UTC - 0 likes

    If they aren't provided in the plugin.yml, yes.


Date created
Feb 17, 2012
Last update
Nov 24, 2015
Development stage
  • enUS
Attribution-NonCommercial-ShareAlike 3.0 Unported
Curse link
Recent files



Optional dependency