The server must be running Java 8!

Bugs/problems/feature requests? Please file an issue at the Github repository.


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


v1.1.16 (latest) @
v1.1.16 (latest) @
Latest developmental build @ NOTE: The jarfile located here is a development build, so things aren't tested and bugs are likely to be present

View the complete changelog here.


  1. Download the plugin here
  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 permissions folder inside of the plugins folder (located at plugins/GetPerms/permissions/). In this folder, you should see at least 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'. 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? Please file an issue at the Github repository.


For all commands, /gp can be used as an alias (like /gp regen)

/getperms reloadReload the configuration file for GetPermsgetperms.reload
/getperms regen(Re)generate the files containing the permission nodes listsgetperms.regen
/getperms updateRun the update taskgetperms.update

If autoGen and regenerateOnPluginChange are both set to false in the config, one will need to use /getperms regen in order to generate the files.
NOTE: If disableOnFinish is set to true, these commands will not work once the plugin disables itself.

Permission nodes

getperms.*Allows player access to all GetPerms commandsop
getperms.reloadAllows player to reload the GetPerms config fileop
getperms.regenAllows player to regenerate permission list filesop
getperms.updateAllows player to run the update taskop

Temporary Plugin Permission Database

You can find more information about this database here. You can request to add plugins to the database here.


Bugs/problems/feature requests? Please file an issue at the Github repository.

Possible Todo

  • Add database of unretrievable permissions for retrieval (info here)
  • 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

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

View metrics data for GetPerms on
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 Jan 12, 2016 at 09:03 UTC - 0 likes

    @osky2918: Go

    Thanks for mentioning it! However, I have actually already fixed it in the next version, which will be released soon.

  • Avatar of osky2918 osky2918 Jan 04, 2016 at 01:37 UTC - 0 likes

    v1.1.15 has the wrong config file: cfgV: "1.1.14" So the plugin thinks there is an update and tries to download "the newest version" every time the plugin load.

    I've change the config file (as you shouldn't) with no progress.

    Edit: Yes, I've replaced the file and checked permissions.

    Last edited Jan 04, 2016 by osky2918

    I´m an editor (I edit my post like three times before I leave it)

    Throw me a PM if you want me to translate Your plugin into the Swedish language! (Jag översätter plugins till svenska!)


  • 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


Date created
Feb 17, 2012
Last update
Jan 22, 2016
Development stage
  • enUS
Attribution-NonCommercial-ShareAlike 3.0 Unported
Curse link
Recent files