DynamicShop

---

✨ What's New in v2.5.0

• NEW: (Soft Limit) Pricing Curve Madx Stock
• NEW: (Hard Limit) Storage Hard Limit
• NEW: In-Game Editor Integration
• NEW: Web Admin Integration Type /shopadmin webadmin
• NEW: Option to allow Shortage decay. (shortage is gained when an item sits at <=0 stock). Now sitting at positive stock can decay that shortage.
• Improved: More shopadmin gui options
• Fixed: Percent Increase not properly displaying in gui.

---

---

✨ What's New in v2.0

• NEW: Real-time Web Dashboard (built-in)
• NEW: Command Shops — sell commands as items!
• NEW: messages.yml — customize 100% of messages
• NEW: Requires ProtocolLib (better click detection)
• NEW: PlaceholderAPI support
• NEW: Supports ItemAdder, MMOItems, Oraxen, NBT items
• Improved: Faster search GUI
• Improved: Category UI
• Improved: Dynamic price scaling
• Improved: Logging & transaction safety

---

🌐 Web Dashboard

Real-time analytics, transaction logs, top items, volume tracking, category stats.

---

🛒 Shop GUI

---

🚀 Features

Expand Full Features

🔁 Dynamic Pricing Engine

• Prices rise when players buy
• Prices drop when players sell
• Shortage + surplus multipliers
• Time-based stabilization
• Fully configurable

🌍 Global Stock Tracking

• Tracks server-wide supply
• Supports negative stock (rare item surge pricing)
• Auto-saves

🎨 Modern GUI

• Category selector
• Clean sub-menus
• Buy / Sell / Shift-Bulk
• Realtime price display

🔐 Permission Shop
Add a permission as an item in the shop:

/shopadmin add perm <cost> <permission>

Displays using the item/block you hold.

🧰 Server-Shop (Custom Items + Commands)

Add ANY item or command:

/shopadmin add server-shop 500 my_spawn command essentials:spawn {player}

Supports:

• Commands
• Custom model data
• NBT items
• ItemAdder, Oraxen, MMOItems
• PlaceholderAPI placeholders

💬 messages.yml — Full Customization

• Translate everything
• Custom GUI titles
• Custom lore & lines
• Custom error messages

📊 Web Stats Dashboard

• Live transactions
• Category distribution
• Top players
• Top traded items
• JSON API

⚙ Configuration

• Extensive base price list
• Category auto-sorting
• Tax, multipliers, limits
• Disable any item

⚡ Performance

• Zero-lag architecture
• No heavy repeating tasks
• Async logging

---

⌨ Commands & Permissions

Commands

/shop                          - Open shop
/shop <category>               - Open a category
/shop sell <price>             - Sells held item in PlayerShop for defined price
/shopsearch <query>            - Search items

/shopadmin                     - Opens admin GUI
/shopadmin add perm <cost> <permission>
/shopadmin add server-shop <cost>
/shopadmin add server-shop <cost> <id> command <command>

Permissions

shop.use               – Open the shop, buy/sell (default true)
shop.admin             – Full admin access
shop.playershop.sell   – Ability to use PlayerShop

---

📦 Requirements

• ProtocolLib – REQUIRED
• Vault – REQUIRED for economy
• PlaceholderAPI – OPTIONAL

---

🔌 PlaceholderAPI Placeholders

DynamicShop 2.1.0 includes full native support for PlaceholderAPI.
Placeholders auto-register.

PAPI

==================== GLOBAL OVERVIEW ====================
%dynamicshop_total_transactions%
%dynamicshop_items_bought%
%dynamicshop_items_sold%
%dynamicshop_total_money_exchanged%

==================== RECENT & TOP ACTIVITY ====================
%dynamicshop_recent_transaction%
%dynamicshop_most_traded_item%

==================== PLAYER STATISTICS ====================
Format: %dynamicshop_player_<name>_<stat>%

Stats:
purchases | sales | money_spent | money_earned | net

Examples:
%dynamicshop_player_selfservice0_purchases%
%dynamicshop_player_selfservice0_sales%
%dynamicshop_player_selfservice0_money_spent%
%dynamicshop_player_selfservice0_money_earned%
%dynamicshop_player_selfservice0_net%

==================== ITEM STATISTICS ====================
Format: %dynamicshop_item_<stat>_<ITEM>%

Stats:
displayname
times_bought
times_sold
times_bought_quantity
times_sold_quantity
net_flow

Examples:
%dynamicshop_item_displayname_DIAMOND%
%dynamicshop_item_times_bought_DIAMOND%
%dynamicshop_item_times_sold_IRON_INGOT%
%dynamicshop_item_times_bought_quantity_OAK_LOG%
%dynamicshop_item_times_sold_quantity_DIRT%
%dynamicshop_item_net_flow_EMERALD%

==================== ITEM PRICING / STOCK ====================
%dynamicshop_price_<ITEM>%
%dynamicshop_sellprice_<ITEM>%
%dynamicshop_stock_<ITEM>%

Examples:
%dynamicshop_price_DIAMOND%
%dynamicshop_sellprice_OAK_LOG%
%dynamicshop_stock_GOLD_INGOT%

---

📥 Installation

1. Drop plugin into /plugins
2. Install ProtocolLib & Vault
3. Restart server
4. Configure config.yml & messages.yml

---

⬇ Download

✔ Compatible with Spigot & Paper 1.20 – 1.21

• Discord: https://discord.gg/7fRV2uQFgn
• GitHub: https://github.com/selfservice0/DynamicShop/releases
• Wiki https://github.com/selfservice0/DynamicShop/wiki