Placeholders

%playershops_recapNotification%

Boolean

The context player's away-recap notification preference (PSPlayerData#recapEnabled, synced via AstralSync). Requires a Player context — resolves to null if the evaluation context isn't a player at all, and to false if the player has no synced PSPlayerData yet. Toggled by toggle-playershops-recap.

%shop_id%

UUID

Primary key.

%shop_owner%

MinecraftPlayerPlaceholder

Network-aware handle on the owner, keyed by ownerId — chain _uuid, _name, _online, _head (a player-head ItemStack), _loaded. Works for offline owners.

%shop_ownerName%

String

Owner's player name, captured at shop creation — not live-updated on a later name change.

%shop_price%

int

Price per single item.

%shop_material%

String

Base Material name captured at creation (itemStack.getType().name()) — reflects only the raw block/item type, never a custom item's identity. Use %shop_item% for the full item.

%shop_type%

ShopType

BUY or SELL (raw enum).

%shop_typeFormatted%

Component

The BUY_TYPE/SELL_TYPE message for the shop's ShopType.

%shop_item%

ItemStackPlaceholder

The full traded item, deserialized from stored bytes. Chains into the standard item sub-keys — material, name, hover-name, lore, amount, custom-model-data, durability, enchantments (see Equipment sub-keys).

%shop_location%

LocationPlaceholder

The shop's container location — chain _x, _y, _z, _world_* (see Location and world sub-keys).

%shop_townShared%

Boolean

Whether any town member with USE_PLAYER_SHOPS may trade at the shop, not just the owner.

%shop_townEconomy%

Boolean

Whether the shop's proceeds route through a town's economy account rather than the owner's personal balance — true when economyAccount is non-null.

%entry_id%

UUID

The originating shop's id. Always null in the shipped recap flow — TransactionService#fetchRecapsByPlayer re-groups the per-shop/per-type SQL rows by ItemStack across all of the owner's shops before building the dialog list, discarding the per-shop id in the process.

%entry_item%

ItemStackPlaceholder

The traded item — the key the rows were grouped by.

%entry_type%

ShopType

BUY or SELL for this group. If the owner runs both a BUY and a SELL shop trading the same item within the window, the rows still merge into one entry — this reflects whichever raw row happened to sort first, not necessarily both types.

%entry_typeFormatted%

Component

The BUY_TYPE/SELL_TYPE message for the entry's %entry_type%.

%entry_count%

int

Total quantity traded for this item across the window (summed across all matching shops).

%entry_earnings%

double

Total coin value for this item across the window (summed across all matching shops).

%transaction_id%

UUID

Primary key.

%transaction_buyer%

MinecraftPlayerPlaceholder

Network-aware handle on the buyer, keyed by buyerId — chain _uuid, _name, _online, _head, _loaded (same as %shop_owner%).

%transaction_amount%

int

Quantity traded.

%transaction_price%

double

Total coin value of the transaction (already unit price × quantity).

%transaction_date%

TimePlaceholder

When the transaction was recorded. Chain _remaining (ms until, as a raw long), _remaining-format (human-readable), _format (HH:mm:ss dd/MM/yyyy), _format-duration, _format-date (dd/MM/yyyy); a bare %transaction_date% resolves to the raw LocalDateTime.

%stats_dailyEarnings%

double

Sum of total_price over transactions from the last 24 hours.

%stats_weeklyEarnings%

double

Sum of total_price over transactions from the last 7 days.

%stats_dailyTransactions%

int

Count of transactions from the last 24 hours.

%stats_weeklyTransactions%

int

Count of transactions from the last 7 days.

%stats_dailyAmount%

int

Sum of quantity (items traded, not transaction count) over the last 24 hours.

%stats_weeklyAmount%

int

Sum of quantity over the last 7 days.

BUY

Items currently available in the container to buy, live-counted with ContainerUtils#countItems; the OUT_OF_STOCK message when the count is 0.

SELL

Empty slots left in the container to sell into, via ContainerUtils#countEmptySlots; the FULL message when the count is 0.

playershops_*

%playershops_*%

Anywhere with a Player evaluation context.

shop_*

%shop_*%

The shop's wall sign.

shop_*

%parameters_shop_*%

playershops-main, playershops-history, playershops-buy, playershops-sell menus.

stats_*

%parameters_stats_*%

playershops-main menu.

transaction_*

%parameter_transaction_*%

transactions layout inside playershops-history.

entry_*

%parameter_entry_*%

entries layout inside playershops-daily-recap/playershops-absent-recap.

%stock%

%stock%

The wall sign renderer only (formatted, stock-or-message form).