Placeholders

Built-in Placeholders List

Placeholder	Display Info	Where can use
{shop}	Display Shop ID (filename).	Message File Actions
{shop-name}	Display Shop Display Name.	Shop Menu Actions
{shop-menu}	Display Shop Menu ID.	Actions
{product}	Display Product ID.	Message File
{amount}	Display shop or sell amount.	Message File Actions Price placeholder option
{status}	Show whether now price is greatter or less than base price. Only use for dynamic price.	Price placeholder option
{item}	Display Purchased Items Name.	Message File
{menu}	Display Menu ID.	Message File
{price}	Display Buy/Sell price.	Message File
{limit}	Display Buy/Sell limits.	Message File
{times}	Display Buy/Sell times.	Message File
{refresh}	Display Product Reset Refresh Time or Cooldown Refresh Time.	Message File
{buy-price}	See above.	Display Item Add Lore PlaceholderAPI Support
{sell-price}	See above.	Display Item Add Lore PlaceholderAPI Support
{buy-times-player}	See above.	Display Item Add Lore PlaceholderAPI Support amount option
{buy-limit-player}	See above.	Display Item Add Lore PlaceholderAPI Support
{buy-refresh-player}	See above.	Display Item Add Lore PlaceholderAPI Support
{buy-cooldown-player}	See above.	Display Item Add Lore PlaceholderAPI Support
{sell-xxx}	See above. xxx is same as buy, like {sell-limit-playe}	See above.
{xxx-server}	See above. xxx is same as player, like {buy-limit-server}	See above.
{buy-click}	View Buy Price Status	Display Item Add Lore
{sell-click}	View Sell Price Status	Display Item Add Lore
{item-name}	Display product display name	Display Item Add Lore PlaceholderAPI Support
{random_<ID>}	Query random placeholder's first picked element. For more info about random placeholder, please view Random page.	Anywhere in plugin PREMIUM
{random_<ID>;;<Number>}	Quert random placeholder specife number of picked element, if this number of picked element does not exist, we will quert the last picked element. You can set max amount of picked element by element-amount option in random placeholder.	Anywhere in plugin PREMIUM
{random-times_<ID>}	View random placeholder refresh time.	Anywhere in plugin PREMIUM
{discount_<ID>}	Use discount placeholder. For more info, please view Discount page.	Anywhere in plugin PREMIUM
{compare_<number1>_<number2}	Compare 2 numbers. Result format can be changed in config.yml file.	Anywhere in plugin PREMIUM
{math_<mathStr>}	Calculate the math string you put. Like {math_10+50} will print 60. Require you enable math.enabled option in config.yml file. You can set result scale at placeholder.math.scale option.	Anywhere in plugin

PlaceholderAPI Support

All built-in placeholders above that has PlaceholderAPI Support tag can be used in PlaceholderAPI expansion:

Use %ultimateshop_<shopID>_<productID>_<builtInPlaceholder>% to display built-in placeholder outsite of the plugin!

For example:

%ultimateshop_example_A_{buy-limit-player}%

Start from 2.5.6 version, you don't need put {} symbol into builtInPlaceholder arg, new format example, if you want to use this placeholderapi in our plugin, you have to use this new format becuase we will auto parse built-in placeholder into the value, this new format can avoid this:

%ultimateshop_example_A_buy-limit-player%

For random and discount placeholder, you don't need specife the shop and the product, just put the placeholder after ultimateshop. For example:

%ultimateshop_{random-times_rotate}%

This don't support remove {} symbol.

New Line Symbol

Use ;; symbol if you want to start a new line, this is very useful for some people want to display price in multi lines.

placeholder:
  price:
    split-symbol-any: ';;' # <--- Changed this in config.yml
    split-symbol-all: ';;' # <--- Changed this in config.yml
    unknown: "Unknown"