🔧Built-in Placeholder
By default, placeholder displayed in GUI will only refreshed when player open the menu or click the button. If you want to auto update placeholder value, you need enable menu.shop.update option in config.yml file. Remeber: this can even cost x20 plugin performance than normal when open the GUI. This is NOT a good choice to enable this.
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
Message File
{next}
Display Countdown Time for Product Reset Refresh Time
Message File PREMIUM
{buy-price}
Display Buy Price.
Display Item Add Lore PlaceholderAPI Support
{sell-price}
Display Sell Price
Display Item Add Lore PlaceholderAPI Support
{buy-times-player}
Display player's buy times.
Display Item Add Lore
PlaceholderAPI Support
amount option
{buy-limit-player}
Display player's buy limits.
Display Item Add Lore PlaceholderAPI Support
{buy-refresh-player}
Display player's product reset refresh time.
Display Item Add Lore PlaceholderAPI Support
{buy-next-player}
Display countdown time for product reset refresh time.
Display Item Add Lore PlaceholderAPI Support PREMIUM
{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.
{last-buy-player}
Display the time interval between the last purchase of this item by a single player, in seconds. If the player has not purchased this item or the buy time has been reset, it will return 0.
PlaceholderAPI Support
amount option
PREMIUM
{last-sell-player}
Display the time interval between the last sell of this item by a single player, in seconds. If the player has not sold this item or the sell time has been reset, it will return 0.
PlaceholderAPI Support
amount option
PREMIUM
{last-buy-server}
Display the time interval between the last purchase of this item by global server, in seconds. If no one has not purchased this item before or the buy time has been reset, it will return 0.
PlaceholderAPI Support
amount option
PREMIUM
{last-sell-server}
Display the time interval between the last sell of this item by global server, in seconds. If no one sold this item before or the sell time has been reset, it will return 0.
PlaceholderAPI Support
amount option
PREMIUM
{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
{random-next_<ID>}
View countdown time for 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