Skip to main content

Shop Notification Manifest

Format shop transactions announced on Discord

How a shop transaction reads once it reaches Discord. The destination is deliberately absent: it belongs to the shop, which names it on its own definition. This entry only says how the message looks, so one presentation can serve every shop and each shop still posts to its own channel. Without this entry nothing is sent, whatever the shops declare.

Fields

FieldTypeDefaultDescription
shopIdsList<String>emptyShop ids this format applies to. Empty = every shop that names a destination.
announceBuysBooleantrueAnnounce purchases
announceSellsBooleantrueAnnounce sales
minimumPriceDouble0.0Announce nothing below this amount of money, so bulk trading does not flood the channel
titleTemplateString{player} {action} {amount}x {item}Title of the embed. Placeholders: {player},{shop},{item},{amount},{price},{action}PlaceholdersMulti-line
contentTemplateString—Optional message content sent alongside the embed. Same placeholders as the title.PlaceholdersMulti-line
buyVerbStringboughtWording substituted for {action} on a purchase
sellVerbStringsoldWording substituted for {action} on a sale
colorString#55ff55Hex color applied to the embed sidebar (e.g. #55ff55)
fieldsList<ShopNotificationField>—Fields added to the embed body
ShopNotificationField (2)
FieldTypeDefaultDescription
valueString{player}Value shown in the Discord embed field (placeholders supported)
inlineBooleantrueDisplay this field on the same line when possible

How to use it​

This entry only describes how a transaction looks. The channel comes from the shop: set notificationWebhookId on the Shop Definition to the ID of a Webhook Definition. Without this entry, nothing is announced.

  • shopIds limits the format to some shops (empty means all). The first entry that covers the shop is used.
  • announceBuys, announceSells and minimumPrice filter what is posted.
  • Templates accept {player}, {shop}, {item}, {amount}, {price} and {action}, where {action} is buyVerb or sellVerb.