Permissions Reference 🔑 ​
Tub's Status Plugin uses the following permission nodes to control access to its commands and features. You'll need a Bukkit-compatible permissions plugin (e.g., LuckPerms) to assign these.
The Default
values indicate who has the permission without explicit assignment:
true
: All players.op
: Only server operators.false
or not listed: No one by default; must be granted.
Player Permissions ​
StatusPlugin.setStatus
​- Description: Allows a player to set and remove their own status using
/status <message>
and/status remove
. - Default:
true
- Description: Allows a player to set and remove their own status using
StatusPlugin.group.set
​- Description: Allows a player to use the
/status <groupname>
command to set their status from predefined groups, ifgroupMode
is enabled inconfig.yml
. This is the base permission for using group functionality. Specific group access may require additional permissions (see below). - Default:
true
- Description: Allows a player to use the
StatusPlugin.group.set.<groupname>
​- Description: Allows a player to select the specific status group named
<groupname>
(where<groupname>
is a key fromstatusGroups
inconfig.yml
). This permission is typically used if the group inconfig.yml
does not have its ownpermissions
list defined. - Example:
StatusPlugin.group.set.vip_group
- Default:
false
(Must be granted by an admin if not covered by a group's specificpermissions
list inconfig.yml
) - Note: If a group in
config.yml
has a non-emptypermissions: [...]
list, players need one of those custom permissions instead of this node for that specific group. If thepermissions
list is empty or absent, this node (or generalStatusPlugin.group.set
if this node isn't granted) is effectively checked. See Configuration Guide for details.
- Description: Allows a player to select the specific status group named
StatusPlugin.placeholders
​- Description: Allows players to use PlaceholderAPI placeholders (from other plugins) within their own status message. Also enables the display of LuckPerms prefixes/suffixes if
%LP_prefix%
or%LP_suffix%
are used in their status. - Default:
op
- Description: Allows players to use PlaceholderAPI placeholders (from other plugins) within their own status message. Also enables the display of LuckPerms prefixes/suffixes if
Formatting Permissions ​
These permissions control which formatting codes players can use in their status messages.
StatusPlugin.formatting.color
​- Description: Allows the use of color codes (
&0-&9
,&a-&f
). - Default:
op
- Description: Allows the use of color codes (
StatusPlugin.formatting.bold
​- Description: Allows the use of the bold code (
&l
). - Default:
op
- Description: Allows the use of the bold code (
StatusPlugin.formatting.italic
​- Description: Allows the use of the italic code (
&o
). - Default:
op
- Description: Allows the use of the italic code (
StatusPlugin.formatting.underline
​- Description: Allows the use of the underline code (
&n
). - Default:
op
- Description: Allows the use of the underline code (
StatusPlugin.formatting.strikethrough
​- Description: Allows the use of the strikethrough code (
&m
). - Default:
op
- Description: Allows the use of the strikethrough code (
StatusPlugin.formatting.magic
​- Description: Allows the use of the obfuscated/magic code (
&k
). - Default:
op
- Description: Allows the use of the obfuscated/magic code (
Admin Permissions ​
StatusPlugin.admin.setStatus
​- Description: Allows setting and removing the status (custom or group) of other players using
/status <player> <status|groupname>
or/tsp setstatus <player> <status|groupname>
and/status remove <player>
or/tsp remove <player>
. - Default:
op
- Description: Allows setting and removing the status (custom or group) of other players using
StatusPlugin.admin.reload
​- Description: Allows reloading the plugin's configuration and status data using
/tsp reload
. - Default:
op
- Description: Allows reloading the plugin's configuration and status data using
StatusPlugin.admin.setMaxlength
​- Description: Allows setting the maximum character length for statuses using
/tsp setmaxlength <length>
. - Default:
op
- Description: Allows setting the maximum character length for statuses using
StatusPlugin.admin.resetMaxlength
​- Description: Allows resetting the maximum status length to its default value using
/tsp resetmaxlength
. - Default:
op
- Description: Allows resetting the maximum status length to its default value using
StatusPlugin.admin
​- Description: Players with this permission will receive in-game notifications about critical/high urgency plugin updates if
checkUpdate: true
is enabled inconfig.yml
. - Default:
op
- Description: Players with this permission will receive in-game notifications about critical/high urgency plugin updates if