Content generated with AI — it may contain mistakes.

ExyliaArmorTrims/ReferenceUpdated in v1.5.1

Permissions

Every ExyliaArmorTrims permission, how to sell patterns and materials by rank, and how to make the wardrobe or crate a VIP perk.

Page 11 of 212 min read

Players can open the menu, the wardrobe, the crate and the shop with no setup. Patterns and materials are locked until a permission, a crate unlock or a purchase hands them over. Use LuckPerms (or any permission plugin) to hand them out.

All permissions#

PermissionWho has itWhat it allows
exyliaarmortrims.command.armortrimEveryoneUse /armortrim and its subcommands.
exyliaarmortrims.wardrobeEveryoneUse the 3D wardrobe. Without it /armortrim opens the classic menu.
exyliaarmortrims.buyEveryoneBuy patterns and materials in the shop.
exyliaarmortrims.crateEveryoneOpen the crate: its menu button, /armortrim crate and bound crate blocks.
exyliaarmortrims.crate.multi.<n>Nobody until grantedOpen up to <n> crates in one go (the highest held wins, seven at most).
exyliaarmortrims.adminAdmins (op)Use /armortrimsadmin: trims, crates, keys and wardrobes.
exyliaarmortrims.pattern.<id>Admins (op)Own one pattern (the id is its key in trims.yml).
exyliaarmortrims.pattern.*Admins (op)Own every pattern.
exyliaarmortrims.material.<id>Admins (op)Own one material (the id is its key in trims.yml).
exyliaarmortrims.material.*Admins (op)Own every material.

A feature refused by its node answers with feature-locked from messages.yml. Taking a trim off never needs a permission.

Sell patterns and materials#

A trim is a pattern plus a material, and the player owns each half separately. The ids are lowercase and are the keys of trims.yml, for example sentry and netherite. A trim is worn once the player owns both halves.

exyliaarmortrims.pattern.* works even though the patterns are not listed in plugin.yml one by one: the plugin asks for the node and, failing that, for the wildcard at its level.

# A couple of halves for everybody
/lp group default permission set exyliaarmortrims.pattern.sentry true
/lp group default permission set exyliaarmortrims.material.iron true
 
# The top rank, with every combination
/lp group mvp permission set exyliaarmortrims.pattern.* true
/lp group mvp permission set exyliaarmortrims.material.* true

Make a feature a rank perk#

Every player feature is held by everybody by default. To turn one into a perk, deny it to the default group and grant it to the rank.

# The 3D wardrobe as a VIP perk (everybody else gets the classic menu)
/lp group default permission set exyliaarmortrims.wardrobe false
/lp group vip permission set exyliaarmortrims.wardrobe true
 
# VIPs open up to five crates at once
/lp group vip permission set exyliaarmortrims.crate.multi.5 true

exyliaarmortrims.crate.multi.<n> is a number per rank: the highest one a player holds wins. Without one, crate.max-at-once from config.yml applies, and the screen fits seven at most.

Permissions and unlocks#

A permission is one way to own a half; a crate unlock or a shop purchase is the other. Whatever a crate, a purchase or /armortrimsadmin unlocks grant unlocked is owned with no permission at all, and stays owned after a rank runs out. The menu, the wardrobe, hide-without-permission and the API all ask both.

When a permission goes away#

Nothing is deleted. What changes is what is seen:

WhereEffect
The menu and the wardrobeAlways ask. A half the player does not own is drawn locked, or for sale when the shop prices it.
Trim itemsNever ask. Holding one is the proof of ownership.
hide-without-permission: trueArmor already carrying a trim the wearer does not own is shown bare.

The value stays on the armor and in the player's row, so the look comes back whole the day the rank does. Commands never look at ownership.

Preset nodes are gone

exyliaarmortrims.trim.<preset>, its per-piece variants and exyliaarmortrims.custom belonged to the presets removed in 1.5.0 and are no longer read. See Trims.

Something missing on this page? Tell us on Discord