| Placeholder | Description | Returns |
| %theauctionhouse_total_auctions% | Total number of active auction listings across the server. | Integer (e.g. 42) |
| %theauctionhouse_tracked_items% | Total number of unique tracked item IDs currently stored by the tracking system. | Integer (e.g. 1287) |
| %theauctionhouse_tracking_events% | Total number of tracking events recorded across all tracked items. | Integer (e.g. 50492) |
| %theauctionhouse_player_listed% | Number of active auction listings created by the player using this placeholder. | Integer (e.g. 3) — requires player context |
| %theauctionhouse_player_mailbox_count% | Number of items currently waiting in the player's Auction House mailbox. | Integer (e.g. 1) — requires player context |
| Permission | Description | Default |
| theauctionhouse.ah.use | Use the Auction House. | true |
| theauctionhouse.ah.sell | Sell items on the Auction House. | true |
| theauctionhouse.ah.expired | Access your expired listings. | true |
| theauctionhouse.ah.mail | Access your AH mailbox. | true |
| theauctionhouse.track.inspect | Inspect tracked items. | op |
| theauctionhouse.track.history | View tracked item history. | op |
| theauctionhouse.track.find | Find a tracked item by UUID. | op |
| theauctionhouse.track.stats | View tracking system stats. | op |
| theauctionhouse.track.reload | Reload tracking configuration. | op |
| theauctionhouse.dupe.alert | Receive anti-dupe staff broadcasts and open the dupe review GUI. | op |
| Entry Point | Description |
|
Code (Text):
TheAuctionHousePlugin#getApi()
|
Returns the main
Code (Text):
TheAuctionHouseAPI
|
|
Code (Text):
TheAuctionHouseAPI
|
Central API: auctions, tracking, price history, and economy manager. |
|
Code (Text):
AuctionEconomy
|
Interface for custom currencies used by The Auction House. |
|
Code (Text):
AuctionEconomyManager
|
Register / manage economies and choose the primary one. |
|
Code (Text):
AuctionHouseTrackingApi
|
Low-level item tracking + anti-dupe events. |
|
Code (Text):
ItemTracker
|
Access to tracked IDs and event history. |
|
Code (Text):
PriceHistoryManager
|
Record and inspect sale prices over time. |
| Class / Method | Description |
|
Code (Text):
AuctionEconomy
|
Implement this in your own plugin to expose a custom currency (tokens, gems, etc.). |
|
Code (Text):
String getId()
|
Unique ID for this economy (e.g.
Code (Text):
"vault"
Code (Text):
"tokens"
|
|
Code (Text):
String getDisplayName()
|
Human-readable name shown in logs / GUIs. |
|
Code (Text):
int getPriority()
|
Priority hint when auto-selecting a primary economy. Higher = more preferred. |
|
Code (Text):
boolean isEnabled()
|
Whether this economy is currently usable. |
|
Code (Text):
double getBalance(OfflinePlayer)
|
Return the player’s balance in this currency. |
|
Code (Text):
boolean hasBalance(OfflinePlayer, double)
|
Utility check: does the player have at least X. |
|
Code (Text):
EconomyResult withdraw(OfflinePlayer, double, String)
| [td>Withdraw funds from a player. Return success/fail with optional message.[/td]
|
|
Code (Text):
EconomyResult deposit(OfflinePlayer, double, String)
|
Deposit funds to a player. |
|
Code (Text):
String format(double)
|
Format amounts for chat / GUIs. |
| Method | Description |
|
Code (Text):
TheAuctionHouseAPI#getEconomyManager()
|
Obtain the
Code (Text):
AuctionEconomyManager
|
|
Code (Text):
registerEconomy(AuctionEconomy)
|
Register or replace a custom economy implementation. |
|
Code (Text):
unregisterEconomy(String id)
|
Unregister a previously registered economy. |
|
Code (Text):
getEconomy(String id)
|
Get a registered economy by ID. |
|
Code (Text):
getEconomies()
|
Get all registered economies. |
|
Code (Text):
setPrimaryEconomy(String id)
|
Set which economy AH should treat as the primary one. |
|
Code (Text):
getPrimaryEconomy()
|
Get the currently selected primary economy. |
|
Code (Text):
autoSelectPrimaryIfMissing()
|
Auto-pick the highest-priority enabled economy when none is set. |
| Method | Description |
|
Code (Text):
getTrackingApi()
|
Access
Code (Text):
AuctionHouseTrackingApi
|
|
Code (Text):
ensureTracked(ItemStack)
|
Apply a signed tracking ID to an item (if missing). |
|
Code (Text):
isTracked(ItemStack)
|
Checks if the item already has a valid tracking ID + signature. |
|
Code (Text):
getTrackedId(ItemStack)
|
Get the tracked UUID of the item. |
|
Code (Text):
getItemHistory(UUID)
|
Get a list of all recorded
Code (Text):
ItemEvent
|
|
Code (Text):
getAllTrackedIds()
|
Get every known tracked UUID on this server. |