🏪 DynamicShop

A fully dynamic, economy-driven shop system where prices evolve based on player activity, supply, and demand.

✨ Overview

DynamicShop transforms the standard Minecraft shop experience into a living economy system where every action matters.

Prices are no longer static — they fluctuate in real time based on:

• player buying & selling activity
• item stock levels
• server-wide economic pressure
• configurable market dynamics

Designed for performance, flexibility, and full customization.

📈 Key Features

💰 Dynamic Economy System

• Real-time price changes per item
• Supply & demand-based calculations
• Elastic market simulation
• Optional random market variation for realism

🛒 Advanced Shop GUI

• Fully GUI-based interface
• Category system (Blocks, Ores, Food, Tools, etc.)
• Slot-based item placement (fully configurable)
• Pagination support
• Clean, modern layout

📦 Stock-Based Market

• Each item has individual stock
• Buying reduces stock → increases price
• Selling increases stock → decreases price
• Optional stock regeneration system

⚙️ Fully Configurable System

Everything is editable via config:

• item prices
• stock limits
• GUI layout (slots per item/category)
• categories
• fees & cooldowns
• update intervals
• market behavior

No hardcoded shop structure.

💸 Economy Integration (Vault Support)

DynamicShop integrates with:

• EssentialsX Economy
• CMI Economy
• any Vault-compatible economy plugin

All transactions use Vault API — no internal currency system.

⏱️ Cooldowns & Transaction Limits

• Per-player cooldown system
• Configurable buy/sell limits
• Prevents spam trading and abuse

📊 Market Simulation Engine

• Elasticity-based price model
• Volume decay system
• Market inertia (smooth price changes)
• Anti-exploit protection against manipulation

🔔 Discord Webhook Support

Track server economy activity in real time:

• price increases / decreases
• player buy events
• player sell events

Fully configurable Discord embeds.

🎮 GUI System

• 54-slot main shop inventory
• Category navigation menus
• Configurable item placement via slot system
• Clean item display with:
  • current price
  • stock level
  • trend indicators

🔐 Permissions

• dynamicshop.use – access shop
• dynamicshop.admin – manage plugin
• dynamicshop.bypass.cooldown – ignore cooldowns
• dynamicshop.bypass.fee – ignore transaction fees

⌨️ Commands

• /shop – open DynamicShop GUI
• /dynamicshop reload – reload configuration

⚡ Performance

• Optimized caching system
• Async-safe data saving
• Minimal main-thread operations
• Designed for high-player servers

🧠 Design Goal

DynamicShop is built to simulate a realistic, evolving economy system, where players directly influence market conditions through their actions.

No static pricing. No predictable economy. Just a living market.

🧩 Perfect For

• Survival servers
• Economy servers
• Semi-RPG servers
• Hardcore progression servers

📌 Requirements

• Minecraft 1.20+
• Paper/Spigot/Bukkit
• Vault (for economy support)

❤️ Support

If you need help or want to suggest features, feel free to reach out.