PermissionsOS
PermissionsOS is a very easy permissions plugin, it is very easy to install and configure and it has basic functions.
Configuration
permissions.yml
Configuration in PermissionsOS is as easy as pie. The basic permissions file goes:
groups: guest: default: true prefix: "&7[Guest] " suffix: "&7" permissions: - essentials.help member: prefix: "&1[Member]" suffix: "&f" inheritance: - guest permissions: - essentials.spawn
This is simple yet effective.
Group Name
This defines the name of your group or rank, e.g Member or Admin. This would be used when setting a users group, /permissions user [player] addgroup [group] e.g /permissions user basdv98 addgroup member - easy! Despite common belief, this has no effect on the prefix or suffix of the group.
default: [true/false]
This variable defines whether the group you are working with is the default group. What this means in basic English is that when a user first joins the server, they are automatically put into the group default without any use of commands. Be warned though, setting two default groups will result in the first of the default groups being used as default. Not adding default: to the configuration of a group will be seen as default: false, and if you do not have any default group, the first group in the configuration file will be used.
prefix: [prefix]
The prefix variable allows you to set a chat prefix for the group, which ties in with the chat plugin you are using. E.g:
[Member] Hawkeyezd: Hello basdv98, how are you?
[Admin] basdv98: I am very well thank you Hawkeyezd, you?
Taking this a step further means using colour codes. All codes can be found at http://www.minecraftforum.net/topic/1485009-bukkit-colour-codes/
Here is an example group using a prefix with colour codes.
legend: prefix: "&5[Legend] " suffix: "&f" inheritance: - guest permissions: - essentials.help
suffix: [suffix]
Suffix's allow you to post something after the message, quite often used for chat colors. E.g:
prefix: "&c[Admin] " suffix: "&7"
or if you want to add an extra bit of text,
suffix: " &7of Panem"
inheritance: [group]
When a group inherits another, all the permissions from the group it inherits are passed over onto the new group.
permissions: [permission node]
Permission nodes are included in all modern (or decent) plugins and integrate with permissions plugins to allow certain groups to do things and others to not. They usually look like
permissionsos.user.setgroup
permissionsos.user.removegroup
awesomeplugin.be.awesome
etc. You can find them on the plugin's page.
config.yml
chat: format: "&prefix&displayname&suffix: &message" update: autoupdate: true notify: console: true ops: true
chat -> format: [chat format]
In the config, you can set a chat format. You could use the following formatting codes:
&prefix = User's prefix.
&displayname = User's display name.
&suffix = User's suffix.
&message = Message sent by user.
update -> autoupdate: [true/false]
When set to true, the plugin will auto-update when a new version is released. (Note: This will be done when the plugin loads.)
update -> notify -> console: [true/false]
When set to true, it will notify the console of any updates of the plugin when it loads.
update -> notify -> ops: [true/false]
When set to true, it will notify of an update when ops join.
Commands & Permissions
Command | Permission | Description |
---|---|---|
/permissionsos, /permissions, /perms, /pos | permissionsos.* | All PermissionsOS commands. |
/permissionsos [help] | permissionsos.help | View the help of PermissionsOS. |
/permissionsos reload | permissionsos.reload | Reload the configuration files. |
/permissionsos user | permissionsos.user.* | All user commands. |
/permissionsos user <name> | permissionsos.user.view | View the permissions of the user. |
/permissionsos user <name> setgroup <group> | permissionsos.user.setgroup | Set a group to the user. |
/permissionsos user <name> addgroup <group> | permissionsos.user.addgroup | Add a group to the user. |
/permissionsos user <name> removegroup <group> | permissionsos.user.removegroup | Remove a group from the user. |
/permissionsos user <name> addperm <permission> | permissionsos.user.addperm | Add a permission node to the user. |
/permissionsos user <name> removeperm <permission> | permissionsos.user.removeperm | Remove a permission node from the user. |
/permissionsos group | permissionsos.group.* | All group commands. |
/permissionsos group <name> | permissionsos.group.create | Create a new group. |
/permissionsos group <name> | permissionsos.group.view | View the permissions of the group. |
/permissionsos group <name> setprefix <prefix> | permissionsos.group.setprefix | Set the prefix of the group. |
/permissionsos group <name> setsuffix <suffix> | permissionsos.group.setsuffix | Set the suffix of the group. |
/permissionsos group <name> addinh <group> | permissionsos.group.addinh | Add an inheritance to the group. |
/permissionsos group <name> removeinh <group> | permissionsos.group.removeinh | Remove an inheritance from the group. |
/permissionsos group <name> addperm <permission> | permissionsos.group.addperm | Add a permission node to the group. |
/permissionsos group <name> removeperm <permission> | permissionsos.group.removeperm | Remove a permission node from the group. |
Stats
This plugin uses Metrics. This feature sends information like server version, amount of players, authentication mode, and metrics version.
@DAVID8671
This plugin doesn't include an anti-build function, so you will need to have the permission node for the plugin that handles the building.
No one on my server can build please help! I need the permissions to build please tell me the permissions!!!
@_PULS_
This plugin just works on 1.8
Is there support for 1.8 soon? I'm sick and tired of GM.. :D
Does this plugin support colors in the chat format parameter in the configuration? Also, can you add a feature to convert data from PermissionsBukkit to this plugin's permission data?
@Scoat1
Wrong syntax: permissions: - 'groups:' - 'groups:'
@Piddlez1
Don't add true behind a permission node.
sadsa
1.7.10?
This plugin is the only permissions plugin with prefixes that works on my server. Really awesone plugin thank you!
This plugin is not working for me except for the prefix and suffix I have no perms when not oped but all them when i'm oped (as if this thing does nothing but restrict me more when i'm not oped... Can't use it for my server...). Here is my permissions file:
groups:
owner:
prefix: '&4[Owner] '
suffix: '&'
permissions:
- essentials.speed.bypass
inheritance:
- member
guest:
default: true
prefix: '&7[Guest] '
suffix: '&7'
permissions: []
inheritance: []
member:
prefix: '&1[Member] '
suffix: '&f'
inheritance:
- guest
permissions:
- 'groups:'
- 'groups:'
- essentials.deljail
- essentials.break
- essentials.speed
- essentials.fly
users:
e247be1a-fe9e-46c9-8885-5d13a940eacc:
groups:
- owner
ae2d2f81-d207-4290-99db-4dfe77e95375:
groups:
- guest
I also noticed a lot of others where having the same problem and not getting responded to. Please Fix The Error.
BTW Im Using 1.7.9 Vault, Essentials, and a ton of others...
Hi, first of all I just wanted to say thank you so much for this plugin! Second, I wonder how I can disable certain commands. Such as /plugins and /help with permission nodes. I know that you can in Essentials by putting a "-" before the permission node to disable that command. Is there a similar way in this plugin or if there's not, can you create one?
Thank you for your time
I've been at this for hours lol and I'm so tired idk what I'm doing wrong
groups:
guest:
default: true
prefix: '&7[Guest] '
suffix: '&7'
permissions:
- permissions.build true
inheritance: []
member:
prefix: '&9[Member] '
suffix: '&F'
permissions:
- permissions.build true
inheritance:
- guest
vip:
prefix: '&6[VIP] '
suffix: '&F'
permissions:
- permissions.build true
inheritance:
- member
moderator:
prefix: '&5[Mod] '
suffix: '&F'
permissions:
- permissions.build true
inheritance:
- vip
admin:
prefix: '&4[Admin] '
suffix: '&F'
permissions:
- permissions.build true
inheritance:
- moderator
users:
ad91384a-ebea-384f-acd2-dfba1889439b:
groups:
- guest
- admin
- member
- guest
permissions:
- permissions.build true
d14f8e4d-5e13-375e-95c1-1f4b2c27fd92:
groups:
- guest
that is the only permission I have on it for now but the problem is that everytime I place a block down on my server it says "You do not have permission to do that!"
http://gyazo.com/0699f462c82422a076ffe25cca559175 ..any solution to this problem, please let me know lol
Hello if anyone could help me that would be great. Im having the issue of players having access to alot of teleportation commands from essentials, even though ive not allowed them in PermissionsOS. Help?
Please make it hook with Vault,
Just so I know I'm not doing something wrong, essentials IS supported by PermissionsOS, correct?
@tezzas17
If you have essentials, make sure that OP color is set off, they will have priority over POS sometimes, if that is off, please verify that the rest of your plugins do not change name color. If you are pretty sure that this is a true error and you have made sure you are using the right color code, you can also report this as a ticket right next to download.
Is there a way to have display names as different colours, I have tried multiple ways but no matter what I try they are always Dark Red.
Would when doing in game commands, it not listing all the permissions for a specific rank be considered a glitch? http://puu.sh/bBLe0.jpg There is a picture if you want to get an example
No 1.7.10 version yet? Seems I am stuck with this while that is so http://puu.sh/bwop3.png