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.
<<reply 698258="">>
Ok will make a ticket.
@jhs232
@amsedal
Please post as a ticket with the console log.
ditto .. failed to load for me also.. trying to find out why.....
Says "Failed to load plugin in /plugins: GetPerms.jar Any help?
Thanks a ton for this plugin! Sadly it will not show up on your metrics, since I only use it on my local server, before updating it on my real server.
@adidaboss
Ty :). And if you can, spread the word about it!
great plugin .. recommend to all server admins:) saved me a LOT of time
@StefannafetS
Ok Ill notify you if it changes :D
Im making a program that reads the file and then you will be able to select the minimum group for a node. With that information it will be possible to make a YML file of it. Could you PM me when the layout of the nodesull.txt changes?
@Memorex39
Oh, you've noticed my "go to tickets area" thing, ay? :p Thanks for reporting those problems and continued support! :D
@Smiley43210
Okay, made you a buncha tickets, don't get mad :))
@Memorex39
Sorry, I forgot to update the context :P
That "latest build here" link is for the latest DEV build. So it may not work. Every file uploaded to dev.bukkit is a recommended build; these should always work unless otherwise stated. Marked 1.0.6 as broken. Working on a fix.
EDIT: 1.0.7 has been uploaded. Should be approved soon.
Thanks for the feedback!
Lol, well I finally figured it out. 2 out of 3 of the download links I tried did not have a GetPerms version that worked.
The GetPerms v1.0.6 link under Recent files, doesn't work.
-----
Latest build here. (doesn't/didn't work)
You can always get the latest build there, regardless if the current file is awaiting approval or not.
------
This does work.
Current version: 1.0.5
http://dev.bukkit.org/server-mods/getperms/files/10-get-perms-v1-0-5/
BTW, I think your plugin is very useful, I really detest all the permissions/nodes scattered all over hell and back. This may not catch them all but hopefully its a good start.
Tried it with CB 1.2.3-R01.jar and latest CB dev build #20467 (Java 1.6 v31 and 1.7) 13:19:41 [INFO] This server is running CraftBukkit version git-Bukkit-1.1-R6-56- ga6bfd98-b2047jnks (MC: 1.2.3) (Implementing API version 1.2.3-R0.2-SNAPSHOT) 13:19:42 [SEVERE] Could not load 'plugins\GetPerms.jar' in folder 'plugins' org.bukkit.plugin.InvalidPluginException: java.lang.NullPointerException at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.j ava:148) at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager. java:287) at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager .java:211) at org.bukkit.craftbukkit.CraftServer.loadPlugins(CraftServer.java:207) at org.bukkit.craftbukkit.CraftServer.<init>(CraftServer.java:183) at net.minecraft.server.ServerConfigurationManager.<init>(ServerConfigur ationManager.java:56) at net.minecraft.server.MinecraftServer.init(MinecraftServer.java:156) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:425) at net.minecraft.server.ThreadServerApplication.run(SourceFile:490) Caused by: java.lang.NullPointerException at com.github.GetPerms.GetPerms.ConfigHandler.<init>(ConfigHandler.java: 26) at com.github.GetPerms.GetPerms.GetPerms.<init>(GetPerms.java:32) at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
at sun.reflect.NativeConstructorAccessorImpl.newInstance(Unknown Source)
at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(Unknown Sou rce) at java.lang.reflect.Constructor.newInstance(Unknown Source) at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.j ava:144) ... 8 more
--------- Kind of a noob with this, so my bad if I have something wrong in my setup.I've pushed a temporary fix to GitHub, no sense try and upload it to dev.bukkit, for version 0.0.7 which I submitted 36 hours ago has still not yet been approved... :/
Edit: It's funny, because even though it still needs approval, I can link you directly to it. http://dev.bukkit.org/server-mods/getperms/files/4-get-perms-v0-0-7/
@PhoenixDIE
Thanks for the report! Working on it...
Couple of questions: Are you running the server on a Windows platform? It works fine on my Mac...
Inside of your plugins folder, was a folder generated named GetPerms?
Did you enable debugMode in the config to get the java stack trace?
Oddly, I submitted the 0.0.7 file on Bukkit a while ago. Its still not approved...
Don't forget, try to remember to post bugs/reports/feature requests in the tickes area.
hello, just ran the new version from your link and got this error, seems to work still but its having issues downloading something.
2012-02-22 19:01:41 [INFO] [GetPerms] Loading GetPerms v0.0.7.
2012-02-22 19:01:41 [INFO] [GetPerms] Downloading changelog and readme...
2012-02-22 19:01:41 [SEVERE] java.io.FileNotFoundException: plugins\GetPerms\Changelog.txt (The system cannot find the path specified)
2012-02-22 19:01:41 [SEVERE] at java.io.FileOutputStream.open(Native Method)
2012-02-22 19:01:41 [SEVERE] at java.io.FileOutputStream.<init>(Unknown Source)
2012-02-22 19:01:41 [SEVERE] at java.io.FileOutputStream.<init>(Unknown Source)
2012-02-22 19:01:41 [SEVERE] at com.github.GetPerms.GetPerms.GetPerms.dlFile(GetPerms.java:209)
2012-02-22 19:01:41 [SEVERE] at com.github.GetPerms.GetPerms.GetPerms.onEnable(GetPerms.java:50)
2012-02-22 19:01:41 [SEVERE] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:230)
2012-02-22 19:01:41 [SEVERE] at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:1057)
2012-02-22 19:01:41 [SEVERE] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:380)
2012-02-22 19:01:41 [SEVERE] at org.bukkit.craftbukkit.CraftServer.loadPlugin(CraftServer.java:199)
2012-02-22 19:01:41 [SEVERE] at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:182)
2012-02-22 19:01:41 [SEVERE] at net.minecraft.server.MinecraftServer.t(MinecraftServer.java:357)
2012-02-22 19:01:41 [SEVERE] at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:344)
2012-02-22 19:01:41 [SEVERE] at net.minecraft.server.MinecraftServer.init(MinecraftServer.java:175)
2012-02-22 19:01:41 [SEVERE] at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:408)
2012-02-22 19:01:41 [SEVERE] at net.minecraft.server.ThreadServerApplication.run(SourceFile:465)
2012-02-22 19:01:41 [WARNING] [GetPerms] Error downloading readme and changelog!
2012-02-22 19:01:41 [INFO] [GetPerms] Downloading changelog and readme...
2012-02-22 19:01:42 [SEVERE] java.io.FileNotFoundException: plugins\GetPerms\Changelog.txt (The system cannot find the path specified)
2012-02-22 19:01:42 [SEVERE] at java.io.FileOutputStream.open(Native Method)
2012-02-22 19:01:42 [SEVERE] at java.io.FileOutputStream.<init>(Unknown Source)
2012-02-22 19:01:42 [SEVERE] at java.io.FileOutputStream.<init>(Unknown Source)
2012-02-22 19:01:42 [SEVERE] at com.github.GetPerms.GetPerms.GetPerms.dlFile(GetPerms.java:209)
2012-02-22 19:01:42 [SEVERE] at com.github.GetPerms.GetPerms.GetPerms.onEnable(GetPerms.java:70)
2012-02-22 19:01:42 [SEVERE] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:230)
2012-02-22 19:01:42 [SEVERE] at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:1057)
2012-02-22 19:01:42 [SEVERE] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:380)
2012-02-22 19:01:42 [SEVERE] at org.bukkit.craftbukkit.CraftServer.loadPlugin(CraftServer.java:199)
2012-02-22 19:01:42 [SEVERE] at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:182)
2012-02-22 19:01:42 [SEVERE] at net.minecraft.server.MinecraftServer.t(MinecraftServer.java:357)
2012-02-22 19:01:42 [SEVERE] at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:344)
2012-02-22 19:01:42 [SEVERE] at net.minecraft.server.MinecraftServer.init(MinecraftServer.java:175)
2012-02-22 19:01:42 [SEVERE] at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:408)
2012-02-22 19:01:42 [SEVERE] at net.minecraft.server.ThreadServerApplication.run(SourceFile:465)
2012-02-22 19:01:42 [WARNING] [GetPerms] Error downloading readme and changelog!
2012-02-22 19:01:42 [INFO] [GetPerms] GetPerms 0.0.7 enabled!
2012-02-22 19:01:42 [INFO] [GetPerms] GetPerms is the work of Smiley43210, with the help of
2012-02-22 19:01:42 [INFO] [GetPerms] Tahkeh, wwsean08, desmin88, and many others. Thanks!
2012-02-22 19:01:42 [INFO] [GetPerms] Checking for updates...
2012-02-22 19:01:42 [INFO] [GetPerms] Newest version of GetPerms is located in
2012-02-22 19:01:42 [INFO] [GetPerms] 'server_root_dir/update/GetPerms.jar'.
2012-02-22 19:01:42 [INFO] [GetPerms] Retrieved plugin list!
2012-02-22 19:01:42 [INFO] [GetPerms] Retrieving permission nodes...
2012-02-22 19:01:42 [INFO] [GetPerms] Compiled permission nodes into 'pnodes.txt' and
2012-02-22 19:01:42 [INFO] [GetPerms] 'pnodesfull.txt' in the server root folder.
2012-02-22 19:01:42 [INFO] [GetPerms] Unloading GetPerms v0.0.7.
2012-02-22 19:01:42 [INFO] [GetPerms] GetPerms 0.0.7 unloaded
Let me know if this helps.
Ok, I'm starting the database. Adding CommandBook and Essentials...
This plugin's database retrieval system will likely show up in either 0.0.8 or 0.0.9, if not 0.1.0.
More info about the database here.
@Smiley43210
CommandBook has an empty plugin.yml thanks to their (in my opinion stupid) new module system.
Ok. I'll be adding new features soon, including a database of permissions from plugins that GetPerms cannot retrieve permissions from.