Inactive [ADMN/DEV] Permissions 3.1.6 - The Plugin of Tomorrow [935]

Discussion in 'Inactive/Unsupported Plugins' started by rcjrrjcr, May 24, 2011.

Thread Status:
Not open for further replies.
  1. Offline


    Permissions 3.1.6 (Yeti)

    Latest Stable (3.1.6) : Full Zip | Main Jar Only | SQL Interface Jar Only

    Previous Versions:
    3.1.5 (JAR|SQL) | 3.1.4 (JAR|SQL) | 3.1.3 (JAR|SQL) | 3.1.2 (JAR|SQL) | 3.1.1 (JAR) | 3.1 (JAR) | More older versions

    Feel free to comment and give suggestions.


    • Revamp commands
    Known plugins that cause IllegalAccessError(s):

    • Help (not fixed yet)
    Temp Fix for IAEs (open)

    1. Open Help's JAR with 7zip.
    2. Find MANIFEST.MF (it can be in the root folder or in the META-INF folder, or both).
    3. Open the MANIFEST.MF file in a text editor
    4. Look for a line that starts with "Class-Path:".
    5. Delete "Permissions.jar" from that line.
    6. Save the manifest.
    7. 7zip will prompt you to save changes back into the archive. Accept.
    8. Restart server.

    Plugin Authors: How to hook into Permissions

    Due to @TheYeti being busy in RL for now, I have created a new thread for Permissions 3.x. TheYeti is still part of the Permissions team.

    Permissions... Reborn.
    This is a continuation of the work that was originally done by Nijikokun. All original credit goes to them as without their work this plugin would not have been possible. This plugin does not provide any commands or additional functionality beyond what is described in this post. That means that you need another plugin to provide colored names, chat prefixes, and op commands such as /give and /time.​

    The Permissions Team

    The team consists of myself @rcjrrjcr and @TheYeti currently with contributions from @Nijikokun as well on occasion. There are also several other members of the community who frequently assist with providing code changes, bug fixes, patches, support, feedback, and beta testing. Special thanks to @flames and the Dynmap & Wormhole X-Treme teams for the hosting of Permissions on their Jenkins server.

    What's new in 3.x?

    Taken from the GitHub page:
    1. In-game commands. For a long time, users have been pestering, nagging, demanding and/or screaming for an way to manage Permissions via commands. Now, in 3.0, in-game commands are available to manage permissions and groups.
    2. SQL storage. This allows web interfaces to manage Permissions by updating the SQL database Permissions uses.
    3. Promotion/demotion tracks. With a simple command, users can be promoted/demoted along a preconfigured track, allowing RP servers with ranks to promote the player along a class track and other possibilities.
    4. Multigroup.
    5. Weightage. Plugins are able to compare users via their weight, which is inherited from their groups. For example, SlapPlugin can check if Player A is higher-weighted than Player B when A tries to slap B (Not IRL, obviously).
    6. Improved world mirroring. Config files are now split into a group file and a user file. Also, by editing storageconfig.yml, you can configure the mirroring of entire worlds, or just its users/groups. You also do not have to create files for worlds that mirror another world. Also, two different worlds can use different storage types, like YAML and SQL.
    7. Global permissions. Instead of having to resort to cross-world group inheritance, now all worlds inherit groups and users from the global permissions file. Also, the inherited groups/users can be overridden via editing the specific world's file.
    Upgrading from 2.x to 3.x

    I have written a guide on GitHub. This demonstrates how to convert 2.x-style configs to 3.0. The YAML-to-SQL converter are still in testing, but it can be downloaded from here. It's written in Perl. @Zgred has created a web version of the script located here. @omgneeq is working on an Web UI for SQL databases (Sorry about the previous statement that he was making a converter.)​

    Install (open)
    For the admins

    In case you missed the link above, the Setup Guide on GitHub will help you quite a bit

    Samkio has updated his tutorial for P3:

    First thing that you will need to do is download the plugin. Place it in your plugins/ folder and unzip it. This should create the folder Permissions and a Permissions.jar file in your plugins folder. Next, go into Permissions/ and create a folder named the same as your world. So if your world name from is Foo you will need to create the folder plugins/Permissions/Foo. You MUST rename it to whatever your world's name is or it will not work.

    Note, if you have your server maps all saved into a single directory then the initial setup will be somewhat different. Say your maps are arranged in the main directory like so: bukkit/mapfolder/world1, bukkit/mapfolder/world2, etc. Then inside of the plugin/Permissions directory you will need to create a folder called mapfolder and inside of that put the directories containing users.yml and groups.yml in there.

    Next, you will need to go in and add yourself to the users, just replace the user that is in there with your name. Make any other modifications that you need to. While making modifications make sure that you do NOT use tabs. These will break the YAML format and cause issues. Instead, each indent should be four spaces. If you want people who aren't in the Admin group to be able to reload the permissions plugin you need to give them 'permissions.reload' permissions within the config file.

    Permissions gives server admins great control, mostly in-game reloading. More info about commands can be found here.

    FAQ (open)


    [Q] What is with the version numbers? I can't keep up, it seems like every time I look there is a new version!
    [A] I use the GNU versioning system for my version numbers. So what this means is the version number should be read as Major.Minor.Revision. So for version 2.5.2 this would mean it is the 2nd Major version, the 5th Minor release in this version, and the 2nd revision. I tend to release bug fixes and anything that doesn't add functionality or will not break things as revisions. So generally you should be safe with just watching the major & minor numbers and only getting the revision if it fixes a bug specific to you. Technically 2.5.2 should have been released as 2.6 as it did add functionality, but this was below even a minor change so I released it as a revision.

    [Q] I am getting an error that it can't pass BLOCK_PLACED or BLOCK _BREAK events to Permissions. Fix it!
    [A] That's not a question. The reason why it can't place these is probably because the syntax of your Permissions file is all whacked out, or it is a different world and you don't have a config file for that world.

    [Q] What am I suppose to name the config file?
    [A] You need to name it the same as your world. So if you look in at "level-name" you will see a world name there. Rename your config file to the same thing as that. Make sure you keep the .yml extension at the end.

    [Q] Permissions are broken. Why can no one use commands? Why am I not an admin?
    [A] First off, make sure that your formatting is correct. Look at the format that the default config file uses. Yours should look like that. Do NOT use tabs. Use 4 spaces (IE. " " <-- Four of those things.). Also, whichever group you give the permission '*' to, do not have that group inherit permissions from anyone else. That is called overloading and it will break things. Also, this.

    [Q] Which one am I suppose to download and unzip to install this?
    [A] Download the main package, not the JAR only. Unzip the ZIP file. The JAR only downloads are simply there for people who are UPGRADING and do not need the default config file.

    [Q] I have done all of this and this doesn't work! I'm going back to GroupManager!
    [A] Well, there is probably the problem. Make sure that you delete EssentialsGroupManager.jar and EssentialsGroupBridge.jar as these don't play well with Permissions and will cause headache.

    [Q] When are you going to add <blah> <feature/command> into this already? You suck! Do what I want NAU PL0X!
    [A] Feature requests should be posted on the GitHub tracker. Stupid suggestions like adding teleportation functionality and other less ludicrous stuff will be rejected.

    • 3.1.6
      • Major fixes.
      • Simplify tracks
    Changelog (open)

    • 3.1.5
      • Fix several minor bugs.
      • Autoconvert 2.x/GM format (only works if you split them into groups.yml and users.yml, but leave the rest untouched)
    • 3.1.4
      • Fix YAML locking bugs.
    • 3.1.3
      • Fix another SQL data and inheritance issue.
    • 3.1.2
      • Fix SQL data issues.
      • Added user/group name autocomplete
      • Separated SQL interface into separate plugin
    • 3.1.1
      • Fix prefix/suffix issues.
      • Added ON UPDATE CASCADE to the SQL foreign [/SIZE]
    • 3.1
      • Tons of fixes.
    • 3.0.6
      • Fix SQLite issues due to misimplementation of methods.
    • 3.0.5
      • Fix cache-related NPEs
      • Fixed quoted worlds (thanks again @Jeyge !)
    • 3.0.4
      • Fix LinkageError caused by ServiceManager not unloading the PermissionHandler class.
      • Added cache
      • Fix index not being incremented when promoting (thanks @Jeyge !)
    • 3.0.3
      • Fixed another getGroup bug.
    • 3.0.2
      • Fixed getGroup bug.
    • 3.0.1
      • Fixed some NPE bugs.
    • 3.0
      • Total overhaul of Permissions. Adds many new features (see What's new in 3.0?).
    • 2.7.4
      • Added overload of has() and permissions() for plugin devs
    • 2.7.3
      • Fixed negate node add/remove bug.
    • 2.7.2
      • Fix for small subtle bug introduced in last minor version.
    • 2.7.1
      • Commit by DThielke to fix several bugs with programmatic modifications of user permissions.
    • 2.7
      • Further commits by rcjrrjcr
        • Removed negatedNode checks
        • Temp fix for NULL issue
        • WorldConfigurationModification to save only modified configs
        • Fix for cache problems

    Credits (open)

    Nijikokun - Without their original work this plugin would not be possible.​
    All of the members of the community that regularly provide support in this thread for Permissions​
    Rigby, Kainzo, DThielke, GoMySQL, sk89q, RightLegRed - For hanging out with me in IRC, tons of testing, and pushing me to improve on the code constantly and make changes to make this plugin constantly better and better, and in general being entertaining.​
    Everyone else on here and in IRC who provides support, feedback, assistance, plugins that have continued to support and integrate this, and in general makes my life a bit easier, THANK YOU!​

    I would like to thank Joy , jamesg and omgneeq for staying in #permissions for long periods of time to test out 3.0, and help me find many coding mistakes I made, patiently waiting for the next build while I fixed the bugs. I appreciate SvenBrnn 's and GoMySQL(Geoff Winans on this forum) 's help that allow me to design and code the SQL interface, and the HeroCraft coding team for providing support and some priceless IRC quotes (Dgco). Also, I would like to thank Lycano for helping me in many different aspects. Last but not least, I would like to thank Nijikokun and TheYeti for developing P2, which was one of my core plugins when I was still a 14-year-old server admin that didn't understand Java, and was the base for 3.0. Without these people, 3.0 would never be possible.​

    If after reading through all of that you are still having issues do one of two things. If it is a provable bug, and you have things like screenshots or copies of startup, steps to reproduce, your craftbukkit build and the version this is running along with your config files then submit the bug on the issue tracker. If it is general help or support you are needing then post a reply to this thread and someone will try to help you.

    Old thread: Permissions v2.7.4
  2. Offline


    I must agree with @NinjaZidane, it becomes quite frustrating to see some plugins support only a few permission plugins while others support only one or two. We really need one permissions system. Not three or four. I would even support Bukkit enforcing their own permissions system.

    The switch from Permissions 3.1.x to PermissionsBukkit was a tad painful, but that was only because most of the plugins my server used did not support PermissionsBukkit at first and had a few issues with the Bridge.

    Now all the plugins I use (haven't dropped any in the time between the switch) work with PermissionsBukkit without the bridge. Heck I even removed the bridge plugin since I didn't need it.

    A lot of you may find it difficult but it truly is better to switch to it, the way I see it is. The harder something is the more you learn. The more plugins that add full support for PermissionsBukkit, the easier it'll be for those who have a hard time comprehending things.
  3. Offline


    Official permissions are pain in the a*.! Someone port this, please!
  4. Offline


    I also must agree with the two ninjas, one working perm plugin is better than a dozen broken.

    At first I went into an ALLCAPSRAGE in TS about the new system but then I saw that the benefit outweighed the pain in first setting it up and started.

    Currently the only plugin that has issues with PermissionsBukkit seems to be iConomy 5 & 6 but maybe I haven't set it up correctly.

    tl;dr: The new system is harder to setup but better in the End.

    With that said, let perms 3.x rest in peace and go for the new one, you won't regret it :)
  5. Offline


    For the record I am using iConomy 5.0.1 with PermissionsBukkit with no issue. iConomy 6 worked with it as well. :)

    Do like everyone else is. Learn how to use it. You have plenty of people on the Official PermissionsBukkit thread willing to help.
  6. Offline

    Tristan Addie

    Well I'm up for a challenge have a week off work hehehe :p
  7. Offline


    could you post the permission nodes you use? the ones I use(these) somehow don't work for me, it alway says: "you don't have permissions bla...." currently only ops can use them and I can't just give anyone ops.
  8. Offline


    Send me a PM with your Permissions file. I am heading to sleep now but I will take a look at it and see what I can do when I wake up. :)
  9. Offline


    Could always give bPermissions a shot too, since it's another decent superperms manager.
  10. Offline


    PLZZZ HELP! i have this problem that if i have really many permissions on 1 group, permissions disables itself, heres my groups.yml (right now its the "Default" group that has to many permissions....)


    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 2, 2019
  11. Offline


    I will need to see error log.
  12. Offline


    at gianttrees.Main.setupPermissions(
    at gianttrees.Main.onEnable(
    at org.bukkit.plugin.SimplePluginManager.enablePlugin(
    at org.bukkit.craftbukkit.CraftServer.loadPlugin(
    at org.bukkit.craftbukkit.CraftServer.enablePlugins(
    at net.minecraft.server.MinecraftServer.e(
    at net.minecraft.server.MinecraftServer.a(
    at net.minecraft.server.MinecraftServer.init(
    Caused by: java.lang.ClassNotFoundException: com.nijikokun.bukkit.Permissions.Permissions
    at$ Source)
    at Method)
    at Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    at java.lang.ClassLoader.loadClass(Unknown Source)
    ... 12 more
  13. Offline


    So, you say, when you use a plugin that makes something easy for an admin you're not "actually administrating" the server?
    Also as a "true administrator" it is nice to have things that are easy to configure - I mean, I started with a clean installation of Ubuntu, installed MySQL, Java, added more and more plugins nearly one year long, never used something like Essentials... And now, they say, okay, new Permissions API, old systems dies, let's make a new permissions plugin that doesn't know things like wildcards that were essential with the old system? No wildcards like derp.derp.*... think of it... If you want to give someone, let's say, every WorldEdit Navigation Node, you need to install the Permissions Bridge and then define every single node for the group; you can't just use worldedit.navigation.* as you'd have with this plugin. Also, it's very confusing with multiworld setup.

    Permissions 3 was by far more clear, easier to understand, faster and better documented.

    And... most plugins don't even support Superperms yet.
    The problem is, as a server admin you are forced to switch to a Permissions system with the official Bukkit API because all the new plugins slowly won't support the old system anymore. But still, as stated above, old, big, and essential plugins with TONS of nodes aren't ready for Superperms yet, and still, you have to configure everything again because something like a converter is not existing (and not really possible due to the lack of derp.derp.* wildcards without the plugin dev to define those nodes).
    And that's just a pain. For everybody it's no fun, for a "real admin who knows what's on it's server", too. Also for serious users, something easy is always nice.
    Just a little example - Photoshop, the application for professional users with graphic design, photo manipulation and so on. It has lots of functions that could be made with far more steps, too, like shadows. In Photoshop, you just double click the layer, click on shadow, done. Easy. Without this, you'd have to copy the layer, overlay black, render the layer, and blur it so it looks like a shadow.

    I am really happy that PermissionsEx exists. It seems to be a serious and good permissions system, with clear commands and native support for both, Superperms and the old system.

    My opinion.

    Sorry if I got you wrong in some points and also sorry for mistakes, English is not my native language.
    ACStache likes this.
  14. Offline


    now i found out that it dosent have to do with how many there permissions there is, it always says that the last (Last in the default group)permission is wrong... it says like [SEVERE] while scanning for the next token
    found character '\t' that cannot start any token
    in "<reader>", line 84, column 41:
    ... - 'citizens.healer.use.heal'

    2011-08-20 16:33:08 [SEVERE] at org.yaml.snakeyaml.scanner.ScannerImpl.fetchMoreTokens(
  15. Offline


    Ok post your groups.yml then.
  16. Offline


    I will when I have the time, but for now I have other Problems....and maybe solving them will solve my iconomy least i hope so :)
  17. Offline


    I'm a noob, why is permissions inactive. It was so easy to use, is there any other plugin that manages groups this simply? Please reply.
  18. Offline


  19. Offline


    Oh sorry I didn't see that :3 Did he tell anyone why he left or did he just stop deving it?
  20. Offline


    Hmmm maybe something irl.
  21. Offline


    Ok I get it :D Dm, anyway 3.1.6 seems to work with 1060 so it's all good. In your opinion, do you think that he will release a minecraft 1.8 version? Thanks :D
  22. Offline


    Can someone recommend a permissions plugin for me? I see theres a permissions file built into bukkit, but I guess everyone likes alternate ones? There are so many I dont know which one is the best. I currently use essentials, worldedit, worldguard, LWC, heroicdeath, iConomyChestShop. So I have been using Group manager through essentials which works out fine for now but havnted tested it with any other plugins so not sure if its only avaible for essential commands only.
  23. Offline


    Maybe, idk yet. Nothing has happened from 3.1.6 so yeah.
  24. Offline


    ive posted it since a while, it would be nice if you checked it out...... ty
    if you didnt get it ,here it is again
  25. Offline


    No idea whats going on there but it says somewhere around here:
  26. Offline


    really? i thought it was something wrong with
    - 'citizens.healer.use.heal'
  27. Offline


    I know what I could be, there is whitespace after 'citizens.healer.use.heal' make sure there is no spaces.
  28. Offline

    Connor Mahaffey

    Permissions is discontinued and if you are reading this, you should stop using it. Switch to a system that supports the new vanilla permissions such as:


    Here is a tutorial that focuses on setting up the new permissions with PermissionsBukkit:

    Over the coming months more and more plugins will only support the new permissions. I suggest switching as soon as you are able.
  29. Offline


    Is there a way to grant permissions to all groups and then put a minus with the permissions i dont want them to use after?
  30. Offline


    i removed the space and now theres a new error:
    [SEVERE] while parsing a block collection
    in "<reader>", line 94, column 13:
    - 'essentials.setwarp'
    expected <block end>, but found Scalar
    in "<reader>", line 98, column 16:
    - 'essentials.depth'

    2011-08-20 19:57:05 [SEVERE] at org.yaml.snakeyaml.parser.ParserImpl$ParseBlockSequenceEntry.produce(
    2011-08-20 19:57:05 [SEVERE] at org.yaml.snakeyaml.parser.ParserImpl.peekEvent(​
Thread Status:
Not open for further replies.

Share This Page