PlaceholderAPI Integration
Real-Time Data for Your Scoreboards & Holograms
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
DynamicShopGUI features native support for PlaceholderAPI.
Display real-time shop data such as dynamic prices and stock levels directly in
scoreboards, holograms, chat, tab lists, and custom menus.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
REQUIREMENTS & SYNTAX
- Requirement: PlaceholderAPI must be installed.
- Auto-Register: No extra download needed. The expansion registers automatically on startup.
The base identifier for all placeholders is dynamicshop.
Code (Text):
%dynamicshop_<type>_<material>%
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
PLACEHOLDER LIST
Replace <ITEM> with any valid material name (e.g., DIAMOND).
| Placeholder |
Description |
Output Example |
| %dynamicshop_price_buy_<ITEM>% |
Displays the current buy price. |
200.50 |
| %dynamicshop_price_sell_<ITEM>% |
Displays the current sell price. |
140.35 |
| %dynamicshop_stock_<ITEM>% |
Displays the current stock available. |
450 |
| %dynamicshop_max_stock_<ITEM>% |
Displays the maximum stock capacity. |
1000 |
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
USAGE EXAMPLES
1. Diamond Economy Stats (Scoreboard)
Buy Price: %dynamicshop_price_buy_DIAMOND%
Sell Price: %dynamicshop_price_sell_DIAMOND%
Stock: %dynamicshop_stock_DIAMOND% / %dynamicshop_max_stock_DIAMOND%
2. Chat Announcement
"Wheat is trading at $%dynamicshop_price_buy_WHEAT%! Only %dynamicshop_stock_WHEAT% left!"
3. High-Value Alert (Hologram)
Netherite Value: $%dynamicshop_price_sell_NETHERITE_INGOT%
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
⚠️ IMPORTANT NOTES
- Real-Time Updates: Data is fetched directly from the live database. Prices reflect Supply & Demand changes immediately.
- Case Insensitive: You can use DIAMOND, diamond, or Diamond.
- Smart Formatting: The plugin handles variations like diamond_pickaxe or diamond pickaxe automatically.
- Invalid Items: If an item is not configured in the shop, the placeholder will return "N/A".