Permissions
Every permission node, its default, and what it grants.
Nodes are named zyauctions.<area>.<action>. Everything a normal player needs is on by
default; everything that changes another player's things is op-only.
Players never see a subcommand they cannot run — permission is checked before the command
tree is sent to the client, so /ah only suggests what that player is allowed to do.
Everyday use
| Node | Default | Grants |
|---|---|---|
zyauctions.use | everyone | Open the auction house with /ah. Without this the whole command is invisible. |
zyauctions.sell | everyone | Create listings with /ah sell and /ah auction. |
zyauctions.buy | everyone | Buy fixed-price listings. |
zyauctions.bid | everyone | Bid on auctions. |
zyauctions.collect | everyone | Open and claim from the collection bin. |
zyauctions.notify | everyone | Receive sale, outbid, expiry and collection-bin messages. Revoking it silences the plugin for that player without changing what actually happens to their items or money. |
Do not revoke zyauctions.collect as a punishment. Items a player has already won or had
returned live in their bin, and without this node they cannot get them back. Revoke
zyauctions.sell, zyauctions.buy and zyauctions.bid instead — those stop new
activity without stranding anything.
Listing limits
The number of listings a player may have at once starts at listings.max-per-player from
config.yml, and permissions raise it:
| Node | Default | Grants |
|---|---|---|
zyauctions.listings.<number> | — | Raises the cap to <number>. Not a real registered node — any number works, so zyauctions.listings.25 allows 25 listings. |
zyauctions.listings.unlimited | op | No cap at all. |
The highest number the player holds wins, and the configured value is the floor — a player
with zyauctions.listings.3 on a server configured for 5 still gets 5.
# Donors get 15 listings instead of the default 5
/lp group donor permission set zyauctions.listings.15 trueBypasses
| Node | Default | Grants |
|---|---|---|
zyauctions.bypass.fee | op | Pay no listing fee, whatever listings.fee says. |
zyauctions.bypass.tax | op | Receive the full sale price, whatever listings.tax-percent says. |
zyauctions.bypass.blacklist | op | List materials on listings.blacklist. |
The tax bypass is checked against the seller at the moment of sale, and only when they are online. An offline seller pays the normal tax even if they hold the bypass. If that matters to you, do not give the bypass to a group whose members sell while away.
Administration
| Node | Default | Grants |
|---|---|---|
zyauctions.admin | op | A parent node granting all three below. |
zyauctions.admin.reload | op | /ah reload. |
zyauctions.admin.remove | op | Remove anyone's listing by shift-right-clicking it in the browser. The item goes back to its seller's collection bin and any bid is refunded. |
zyauctions.admin.inspect | op | Reserved for viewing another player's listings and collection bin. Registered now so permission setups written today keep working; no command uses it in 1.0.0. |
Removing a listing is confirmed on a second screen and cannot be done by accident. The seller is told an admin removed it.
A worked setup
# Everyone: the defaults are already right, nothing to do.
# Trusted sellers: more listings, no listing fee
/lp group trusted permission set zyauctions.listings.20 true
/lp group trusted permission set zyauctions.bypass.fee true
# Moderators: can remove listings but not reload the plugin
/lp group moderator permission set zyauctions.admin.remove true
# Muted or restricted players: no new activity, but they keep their items
/lp user Steve permission set zyauctions.sell false
/lp user Steve permission set zyauctions.buy false
/lp user Steve permission set zyauctions.bid false