🔧Built-in Placeholder
Built-in Placeholders List
{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>}
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>}
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.
Last updated