messages.yml Reference

Every player-facing string lives in plugins/AstralAuctionHouse/messages.yml. Values are MiniMessage and resolve the AstralCore variable tags (<info>, <success>, <warning>, <error>).

Keys

Sell

Key	When
`BLACKLISTED_ITEM`	Item material is in `blacklisted-materials`.
`INVALID_PRICE`	Price is not in `[1, 1_000_000_000]`.
`SELL_FAILED`	Generic listing failure.
`SELL_FAILED_LISTING_LIMIT`	Player already has `maximumListings(player)` active listings.
`SELL_FAILED_INSUFFICIENT_FUNDS`	The sell-tax exceeds the seller's balance.
`SELL_SUCCESS`	Listing created.

Buy

Key	When
`BUY_FAILED`	Generic buy failure.
`BUY_FAILED_INSUFFICIENT_FUNDS`	Buyer cannot afford the listing.
`BUY_FAILED_ITEM_NOT_FOUND`	The item disappeared before the transaction completed.
`BUY_FAILED_UNAVAILABLE`	Status is not `LISTED` at the moment of purchase.
`BUY_FAILED_OWN_ITEM`	Buyer is the seller.
`EXPIRED_ITEM`	Item is expired (cannot be bought).
`BUY_SUCCESS`	Buyer notification.
`BUY_SUCCESS_SELLER`	Seller notification when a listing is bought.

Cancel

Key	When
`CANCEL_SUCCESS`	Cancellation succeeded.
`CANCEL_FAILED`	Generic cancel failure.
`CANCEL_FAILED_NOT_FOUND`	Item not found in cache or DB.
`CANCEL_FAILED_NOT_OWNER`	Caller is not the seller.
`CANCEL_FAILED_NOT_CANCELLABLE`	Item is not in a cancellable state.

Claim (recovering expired items)

Key	When
`CLAIM_SUCCESS`	Expired item returned to the seller.
`CLAIM_FAILED`	Generic claim failure.
`CLAIM_FAILED_NOT_FOUND`	Item is missing.
`CLAIM_FAILED_NOT_CLAIMABLE`	Status is not `EXPIRED`.

Averaging

Key	When
`NOT_AVERAGABLE`	The item has no `itemKey` — no average is possible.
`NO_AVERAGE_AVAILABLE`	Fewer than 3 sales of this `itemKey` in the last 90 days.
`AVERAGE`	Displays the weighted unit price.

Admin

Key	When
`RELOADING`	`/ah reload` started.
`RELOAD_SUCCESS`	Configuration reloaded.
`RELOAD_FAILED`	Reload threw — check console.

Generic

Key	When
`DISABLED_WORLD`	Player is in a world where the auction house is disabled (currently driven by `commands-enabled-groups`).
`EMPTY_HAND`	`/ah sell` with nothing in the main hand.
`AH_NO_PERMISSION`	Failed `auctionhouse.*` permission check.
`ITEM_NOT_FOUND`	Generic lookup miss.
`UNEXPECTED_ERROR`	Catch-all.

Variables

The most common placeholders used inside templates:

Variable	Source
`%player_name%`, `%player_uuid%`	AstralCore player namespace.
`%item_name%`, `%item_formatted-price%`, `%item_amount%`	`AuctionItem` placeholder.
`%transaction_buyer%`, `%transaction_seller%`, `%transaction_price%`	`AuctionTransaction` placeholder.
`%category_id%`	`AuctionCategory` placeholder.

See Developer API for the full placeholder catalogue.

Last modified: 25 July 2026