Permissions

Gavel's permissions, including the numeric ones that set listing limits, tax rates and durations per rank.

Gavel v1.0.0Paper · Folia supported1.21 – 1.21.x

Most player permissions default to true, so a fresh install works out of the box. The interesting ones are the numeric permissions, which is how you sell ranks.

Base permissions

Permission	Default	Grants
`gavel.use`	`true`	Open and browse the auction house
`gavel.sell`	`true`	List items for sale
`gavel.bid`	`true`	Bid on auctions
`gavel.offer`	`true`	Make offers on buy-it-now listings
`gavel.watch`	`true`	Use the watchlist and price alerts
`gavel.featured`	`true`	Pay to feature a listing
`gavel.price`	`true`	Use the price checker
`gavel.admin`	`op`	Full administrative access

Admin children

gavel.admin includes all of these; grant them individually for a junior staff rank.

Permission	Grants
`gavel.admin.remove`	`/aha remove`
`gavel.admin.reload`	`/aha reload`
`gavel.admin.restore`	`/aha give`
`gavel.admin.inspect`	`/aha listings`, `/aha stats`
`gavel.admin.integrity`	Receive market integrity flag notifications
`gavel.admin.grandauction`	`/aha grandauction`, `/aha stopauction`

Numeric permissions

These take a number in the node itself. Gavel checks highest first, so a player with two of them gets the better one — you never have to unset the lower rank's node.

Listing limits

BASH

lp group default permission set gavel.limit.5 truelp group vip permission set gavel.limit.15 truelp group mvp permission set gavel.limit.30 true

Without any gavel.limit.<n>, the player falls back to auction.listing-limits.default (5).

Sales tax

BASH

lp group vip permission set gavel.tax.2 true    # 2% instead of the default 5%lp group mvp permission set gavel.tax.0 true    # tax free

gavel.tax.<percent> overrides auction.sales-tax-percent for that player.

Tax-free ranks are a real economy decision

The sales tax is usually your main currency sink. Selling gavel.tax.0 to everybody removes it. A reduced rate (2–3%) sells just as well and keeps the sink working.

Listing durations

BASH

lp group default permission set gavel.duration.24 truelp group vip permission set gavel.duration.72 truelp group mvp permission set gavel.duration.* true

A player may only pick durations they hold the permission for, out of the list in auction.durations. The sell menu preselects the first one they are allowed.

Watchlist slots

BASH

lp group vip permission set gavel.watch.15 true

gavel.watch.<n> raises watchlist.max-per-player for that rank.

A worked rank ladder

	Default	VIP	MVP
Listings	`gavel.limit.5`	`gavel.limit.15`	`gavel.limit.30`
Sales tax	5% (config)	`gavel.tax.3`	`gavel.tax.2`
Max duration	`gavel.duration.24`	`gavel.duration.48`	`gavel.duration.72`
Watchlist	5 (config)	`gavel.watch.10`	`gavel.watch.20`
Featured	`gavel.featured`	`gavel.featured`	`gavel.featured`

That ladder sells well because every step is a real convenience gain, and none of it lets a rank buy an advantage over another player in the market itself.