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.
Got 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
@osky2918
Thanks for mentioning it! However, I have actually already fixed it in the next version, which will be released soon.
-deleted-
An update has been released for CB 1.5.1-R0.2! See the changelog for details. This may fix a few issues.
@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.
This 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...
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.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'
@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
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
Is It also possible to have a list of the server's plugins generated?
@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.
@Smiley43210
You Need to fix something im not showing the perms for essentials
If they aren't provided in the plugin.yml, yes.
Will the database feature be able to grab permissions from commandbook and similar plugins?
@amsedal
Hmm, I dont think its currently possible to report which plugin is handling a command. I'll look into it.
Howa 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....
@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
looks 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!
@noahdutch
Thanks for the feedback! :D
I love it! Great idea!