Commands

Commands may be typed in console or in game. When entering commands in console omit the slash. i.e. perm give Codisimus minecraft.command.tp

• Administration Commands:

  /perm give <Player> <Node> [true|false] - Give a Player the specified permission node

  /perm give Codisimus minecraft.command.tp - Gives Codisimus the minecraft.command.tp permission node

  /perm give Codisimus minecraft.command.tp false - Sets the minecraft.command.tp permission node to false which ensures it is not inherited

  /perm take <Player> <Node> - Take the specified permmission node from a Player

  /perm take Codisimus minecraft.command.tp - Removes the minecraft.command.tp permission node for Codisimus

Permissions

Permission nodes may be given to Players or permission groups using any permissions plugin such as CodsPerms.

permissions.manage - Needed to set permissions

Explicitly allows for use of the /perm command

Use Cases

• Giving permission nodes to a specific Player

  Permission nodes are available from most Bukkit plugins and even for some vanilla Minecraft commands. You may find the need to give a Player on your server a permission node. For example, the Minecraft command /give is used to generate items and give them to a specific Player. This command could obviously be abused, therefore Players who are not OP (operator) cannot use the command. The /give command also has the permission node minecraft.command.give. The permission node can be given to an individual player using the /perm give command. Therefore the player will be able to generate items but won't be able to execute other commands such as one that stops the server completely.

• Grouping permission nodes together/Giving a Player multiple permission nodes at once

  You can easily give a Player a permission node as explained above. However, it could be tiresome to repeatedly give multiple permission node to multiple Players. Instead you can group several permission nodes into a single node by using Bukkit's permission.yml file. This single node can be given to Players as described above.

• Assigning staff roles on a server

  Most Minecraft servers will have a staff. This staff involves roles such as Admin, Moderator, Builder, Developer, etc. You can group permission nodes together before giving them to Players as explained above. You could make a group nodes such as staff.admin, staff.mod, etc. Then you simply give your staff member a single node to assign the role. A Player can even be assigned multiple roles in this way.

• Create group inheritance

  If you have multiple permission groups as explained above, you may want to create some inheritance rather than adding the permission nodes to multiple groups. In the screnario above you can give the staff.mod permission node to the staff.admin permission group. That way the Admin group will inherit all of the permissions that the Moderator group has.

Tutorials

• Creating a permission group

  Tutorial to come...

• Creating staff roles with inheritence

  Tutorial to come...

• Using MySQL for database support

  Tutorial to come...

• Reading and modifying YAML data file

  Tutorial to come...

• Programatically check if Player is in a group

  Tutorial to come...

FAQ

• Where are permission groups like I see in all other permission plugins

  Other plugins have groups because they were created before the Bukkit API supported permissions. The Bukkit Permission API purposely does not support permission groups because they are not needed. Instead of adding Players to groups, you can group permission nodes together and give the parent node to the Players instead. For more information see Grouping permission nodes together within the Use Cases tab. Most plugins do not support checking if a Player is in a specific group. However, they do support normal permission nodes which is what CodsPerms uses as groups. Therefore, not having explicit permission groups make your other plugins more compatible with each other.

• Why can't I use a wildcard, such as pluginname.*, to assign multiple permission nodes?

  The Bukkit API does not support the wildcard node as explained here. It is up to the plugin developer to group their permission nodes. For this same reason, I do not support wildcards in my plugin.

• What does it mean to set a permission node to false

  With the Bukkit API, You can give a permission node to a Player and you can also take it away. All popular permissions plugins support this. However, Bukkit also allows for setting a permission node to false which few permissions plugins support. Setting a node to false means that the Player will not have that specific permission. This is needed if the permission node would typically be inherited or if it is given to all Players by default. An example of this would be the /me command which is available to everyone by default. You can take away permission to use this command by setting the minecraft.command.me node to false.