Permissions
Every ExyliaChatCosmetics permission, how to give a player a tag or a whole tab, and the numbers a rank can raise.
A fresh install works without any permission setup: everybody can open /cc, whisper and show their item, and only operators get /cca. Cosmetics are the other way round: nobody owns anything until you give it.
Give a permission with LuckPerms#
/lp group vip permission set exyliachatcosmetics.tag.item.mvp true
/lp group vip permission set exyliachatcosmetics.chat_color.category.premium true
/lp group vip permission set exyliachatcosmetics.loadouts.5 trueThe first line gives the mvp tag to the vip group. The second gives every chat colour in the premium tab. The third lets the rank keep five loadouts.
exyliachatcosmetics.* owns every cosmetic of every type. A group with * or this node makes grants, expiry and purchases pointless.
All permissions#
The <type>, <id> and <n> rows are patterns: replace them with the real value. Nodes written like this are not declared in plugin.yml, so they default to operators only, which is what keeps cosmetics locked.
| Permission | Who has it | What it allows |
|---|---|---|
exyliachatcosmetics.command.cosmetics | Everyone | Open /cc and every player command and menu. |
exyliachatcosmetics.customtag.create | Everyone | Write custom tags. A create token pays for each. |
exyliachatcosmetics.customcolor.create | Everyone | Mix custom chat colours. A create token pays for each. |
exyliachatcosmetics.customnick.create | Everyone | Mix custom nick colours. A create token pays for each. |
exyliachatcosmetics.customrank.create | Everyone | Mix custom rank colours. A create token pays for each. |
exyliachatcosmetics.loadouts | Everyone | Save, apply and overwrite loadouts. Deleting one never needs this. |
exyliachatcosmetics.presets | Everyone | Browse and put on presets. |
exyliachatcosmetics.admin | Admins (op) | Every /cca admin command and the staff screens. |
exyliachatcosmetics.chat.command.msg | Everyone | Use /msg. |
exyliachatcosmetics.chat.command.reply | Everyone | Use /reply. |
exyliachatcosmetics.chat.command.ignore | Everyone | Use /ignore. |
exyliachatcosmetics.chat.command.ignoreall | Everyone | Use /ignoreall. |
exyliachatcosmetics.chat.command.channel | Everyone | Use /channel. |
exyliachatcosmetics.chat.command.spymsg | Admins (op) | Use /spymsg. |
exyliachatcosmetics.chat.command.mutechat | Admins (op) | Use /mutechat. |
exyliachatcosmetics.chat.command.clearchat | Admins (op) | Use /clearchat. |
exyliachatcosmetics.chat.command.broadcast | Admins (op) | Use /broadcast. |
exyliachatcosmetics.chat.mentions | Everyone | Mention other players by name. |
exyliachatcosmetics.chat.render.item | Everyone | Show the held item with [item]. |
exyliachatcosmetics.chat.render.inv | Everyone | Show the inventory with [inv]. |
exyliachatcosmetics.chat.render.ec | Everyone | Show the ender chest with [ec]. |
exyliachatcosmetics.chat.links | Admins (op) | Links the player writes are drawn clickable. |
exyliachatcosmetics.chat.format | Admins (op) | Own colour codes survive the chat sanitiser. |
exyliachatcosmetics.chat.staff | Admins (op) | Counts as staff: private messages to them cannot be ignored. |
exyliachatcosmetics.chat.staff.alerts | Admins (op) | Hear the filter's alerts. |
exyliachatcosmetics.chat.staff.filtered | Admins (op) | Read a blocked message anyway. |
exyliachatcosmetics.chat.bypass.ignore | Admins (op) | Private messages reach players who ignore you. |
exyliachatcosmetics.chat.bypass.mute | Admins (op) | Talk while the chat is muted. |
exyliachatcosmetics.chat.bypass.clearchat | Admins (op) | Keep your chat when staff clear it. |
exyliachatcosmetics.chat.bypass.* | Admins (op) | Skip every chat filter check. |
exyliachatcosmetics.chat.bypass.<check> | Admins (op) | Skip one filter check: cooldown, flood, caps or any check named in the filter. |
exyliachatcosmetics.chat.emoji.* | Admins (op) | Use every gated emoji. |
exyliachatcosmetics.chat.emoji.<name> | Admins (op) | Use one gated emoji, unless the emoji names its own permission. |
exyliachatcosmetics.chat.channel.<id> | Admins (op) | Talk and read in a channel whose file asks for this permission. |
exyliachatcosmetics.chat.format.<name> | Admins (op) | Get a chat format whose file asks for this permission. |
exyliachatcosmetics.<type>.item.<id> | Admins (op) | Own one cosmetic, for example exyliachatcosmetics.tag.item.mvp. |
exyliachatcosmetics.<type>.item.* | Admins (op) | Own every cosmetic of a type. |
exyliachatcosmetics.<type>.category.<category> | Admins (op) | Own every cosmetic of one category (one tab). |
exyliachatcosmetics.<type>.category.* | Admins (op) | Own every category of a type. |
exyliachatcosmetics.<type>.* | Admins (op) | Own everything of a type. |
exyliachatcosmetics.* | Admins (op) | Own every cosmetic of every type. Never give it to a default group. |
exyliachatcosmetics.loadouts.<n> | Admins (op) | How many loadouts may stay saved. Highest wins; default is loadouts.limit. |
exyliachatcosmetics.customtag.length.<n> | Admins (op) | Longest custom tag. Highest wins; default is custom-tags.max-length. |
exyliachatcosmetics.customcolor.stops.<n> | Admins (op) | Colours in a custom gradient. Highest wins; default is custom-colors.max-stops. |
exyliachatcosmetics.chat.cooldown.<n> | Admins (op) | Whole seconds between messages. Lowest wins; default is the filter's cooldown.seconds. |
How ownership nodes work#
The types are preset, tag, nick_color, rank_color, chat_color, shadow_color, font and modifier. A shadow is owned as shadow_color wherever it is worn; nick_shadow and rank_shadow only say where it is put.
A preset node gives the preset itself and nothing inside it. Wearing a preset puts on the pieces the player already owns, so grant the pieces together with the preset.
Custom tags and colours belong to whoever made them and have no node. An entry marked permission: false in its file ignores these nodes and is owned only through grants. Rank colours are the exception: they are owned by being in one of the LuckPerms groups the entry lists, so a player in vip can wear the VIP colour without any node.
Technical details
The chat module also reads exyliachatcosmetics.chat.channel.<id> and exyliachatcosmetics.chat.format.<name> when a channel or format file sets a permission, and exyliachatcosmetics.chat.emoji.<name> for gated emojis. Numeric nodes pick a winner among those a player holds: the highest for loadouts, customtag.length and customcolor.stops, the lowest for chat.cooldown.
Something missing on this page? Tell us on Discord