GetPerms
The server must be running Java 8!
Bugs/problems/feature requests? Please file an issue at the Github repository.
Introduction
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:
- permission_nodes.txt - A list of permissions without the descriptions for easy copy/paste
- permission_nodes_desc.txt - A list of permissions with the descriptions for reference, grouped by plugin
Downloads
v1.1.16 (latest) @ dev.bukkit.org
v1.1.16 (latest) @ github.com
Latest developmental build @ github.com 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.
Installation
- Download the plugin here
- 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.
Commands
For all commands, /gp can be used as an alias (like /gp regen)
| Command | Description | Permission |
|---|---|---|
| /getperms reload | Reload the configuration file for GetPerms | getperms.reload |
| /getperms regen | (Re)generate the files containing the permission nodes lists | getperms.regen |
| /getperms update | Run the update task | getperms.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
| Permission | Description | Default |
|---|---|---|
| getperms.* | Allows player access to all GetPerms commands | op |
| getperms.reload | Allows player to reload the GetPerms config file | op |
| getperms.regen | Allows player to regenerate permission list files | op |
| getperms.update | Allows player to run the update task | op |
Temporary Plugin Permission Database
- Essentials (permission_nodes.txt | permission_nodes_desc.txt)
- WorldGuard (permission_nodes.txt | permission_nodes_desc.txt)
You can find more information about this database here. You can request to add plugins to the database here.
Reports
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 mcstats.org

GetPerms by Smiley43210 is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.
-
View User Profile
-
Send Message
Posted Jan 23, 2021Got this working on a 1.6.4 tekkit server. Thank for the old great plugin man. Wish i found this at the start of my server issues :D
-
View User Profile
-
Send Message
Posted Jan 12, 2016@osky2918
Thanks for mentioning it! However, I have actually already fixed it in the next version, which will be released soon.
-
View User Profile
-
Send Message
Posted Jan 3, 2016-deleted-
-
View User Profile
-
Send Message
Posted May 6, 2013An update has been released for CB 1.5.1-R0.2! See the changelog for details. This may fix a few issues.
-
View User Profile
-
Send Message
Posted May 5, 2013@x_clucky
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.
-
View User Profile
-
Send Message
Posted Mar 15, 2013This little thing here:
Is pissing me off.... It prevents my server from starting up, even though the config says not to download it:
Remove it now... This is as annoying as programs making you install yahoo toolbar, nobody wants this...
-
View User Profile
-
Send Message
Posted Oct 14, 2012Would 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.call - commandbook.warp.teleport - commandbook.motd - commandbook.clear - commandbook.whereami.* - commandbook.whereami - commandbook.msg - commandbook.say.me - 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'
-
View User Profile
-
Send Message
Posted Sep 29, 2012@ProKoolio
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
A plugins.txt file is generated in GetPerm's config folder
-
View User Profile
-
Send Message
Posted Sep 15, 2012Is 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
-
View User Profile
-
Send Message
Posted Aug 27, 2012Is It also possible to have a list of the server's plugins generated?
-
View User Profile
-
Send Message
Posted Aug 20, 2012@xH3LLRAIZ3Rx
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.
-
View User Profile
-
Send Message
Posted Aug 19, 2012@Smiley43210
You Need to fix something im not showing the perms for essentials
-
View User Profile
-
Send Message
Posted Jun 10, 2012If they aren't provided in the plugin.yml, yes.
-
View User Profile
-
Send Message
Posted May 30, 2012Will the database feature be able to grab permissions from commandbook and similar plugins?
-
View User Profile
-
Send Message
Posted May 13, 2012@amsedal
Hmm, I dont think its currently possible to report which plugin is handling a command. I'll look into it.
-
View User Profile
-
Send Message
Posted May 13, 2012Howa bout a plugin that tracks what mod a command your entering comes from .. I trying to track /spawn and find out what mod handles it do I can add the right permissions....
-
View User Profile
-
Send Message
Posted May 11, 2012@fredghostkyle1
I already DO use the Bukkit method that grabs i from the plugin.jar... As stated above 2 paragraphs below the header Installation, it reads:
"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."
What I'm stating there is that not all plugin authors place every permission node in their plugins' plugin.yml file. For those that do not put every permission node in the file, I am creating a database.
Let me know if you have anything else. :) And if its a bug or request, make a ticket for it :P
-
View User Profile
-
Send Message
Posted May 10, 2012looks great, thanks for fixing the bug i found, i still think there is a way to get all of the perms. stored in the <plugin name>.jar? i would think. let me know (MUST REPLY to this post for me to see it)! thanks
- fredghostkyle!
-
View User Profile
-
Send Message
Posted May 10, 2012@noahdutch
Thanks for the feedback! :D
-
View User Profile
-
Send Message
Posted May 10, 2012I love it! Great idea!