Calytic Permissions
How to use authorization commands to manage permissions
- Introduction
- Players
- Groups
- Grant a permission to an entire group
- Revoke a permission from a group
- Adding a player to an existing group
- Removing a player from an existing group
- Adding an entirely new group
- Removing an existing group
- Setting the title or rank of a group
- Setting the parent group of another group
- Showing a group's members and permissions
- Showing all groups or permissions
- Using wildcards
- Prefix
Introduction
Permissions allows server owners to give players unique abilities and benefits on their servers using authorization commands.
The commands below should not be confused with uMod Agent commands and are only available in a running game server terminal. Some games might allow access to the server terminal from tools (e.g. RCON) or even from within the game itself.
Players
Grant a permission to an individual player
umod.grant player Wulf epicstuff.use
Note
It is better to create a group, grant permissions to a group and add the player to an existing group, not granting every permission to every player.Revoke a permission from an individual player
umod.revoke player Wulf epicstuff.use
Show a player's permissions
umod.show player Wulf
Showing which player or group has a permission
Sometimes this command is helpful when tracking down who has a permission.
umod.show perm epicstuff.use
Groups
A group represents of a collection of players who all share the same permissions.
Adding and removing players to and from groups represents the easiest and most flexible way to manage staff and player abilities (such as flight, noclip, super speed, etc). Permissions should generally not be granted to players directly.
Grant a permission to an entire group
umod.grant group admin epicstuff.use
Revoke a permission from a group
umod.revoke group admin epicstuff.use
Adding a player to an existing group
Adding a player to a group will give them all of the permissions assigned to that group.
umod.playergroup add Wulf admin
Removing a player from an existing group
Removing a player from a group will remove from them all of the permissions assigned to that group.
umod.playergroup remove Wulf admin
Adding an entirely new group
umod.group add vip
umod.group add vip VIP 0
Removing an existing group
umod.group remove vip
Setting the title or rank of a group
The group title is usually a short description of a group, sometimes used for chat titles. The rank is a number which sorts a group based on its importance.
umod.group set vip "[VIP Member]"
umod.group set vip "[VIP Member]" 1
Setting the parent group of another group
A group will inherit all permissions from its parent group.
umod.group parent admin default
Showing a group's members and permissions
umod.show group admin
Showing all groups or permissions
To show all of the permission groups, simple use the command below.
umod.show groups
The show all of the registered permissions from plugins and uMod, use the command below.
umod.show perms
Using wildcards
A wildcard is something that covers multiple things at once time. For permissions, this is the * symbol. You can use the wildcard (*) to grant multiple permissions at one time. This can be done with all permissions or per plugin based on prefix.
umod.grant group admin *
umod.grant user Wulf umod.*
Prefix
The same commands are also available with the u. prefix (ex. u.grant).