ShopGUI+ DynaShop (Addon)

# ShopGUI+ DynaShop - Dynamic Economy Addon *Transform your server's economy from static to fully dynamic! Prices fluctuate based on supply and demand, creating a realistic and engaging economic experience for your players.* *Works with (https://www.spigotmc.org/resources/6515/) version 1.78.0 and above (requires API version 3.0.0)* ## ✨ Main Features - **Dynamic Pricing System**: Prices change based on buying/selling activity - **Stock Management**: Limited stock affecting prices in real-time - **Recipe-Based Pricing**: Auto-calculate prices from crafting recipes - **Web Dashboard**: Real-time price trends, market analysis and forecasting - **Tax System**: Apply configurable taxes to transactions - **Inflation System**: Simulate real economic conditions with time-based inflation - **Transaction Limits**: Set daily/weekly/monthly limits per player and item - **Advanced Placeholders**: Display dynamic prices, stock levels, limits, and more - **Performance-Optimized**: Configurable caching system for minimal server impact - **Multi-Version Support**: Compatible with 1.16 through 1.21+ ## DynaShop Types DynaShop offers five flexible modes to suit your server's needs: | Mode | Description | |------|-------------| | **DYNAMIC** | The price changes with each purchase or sale. Set min and max price boundaries. | | **STOCK** | Prices vary based on available stock. The less stock there is, the higher the price. | | **STATIC_STOCK** | Fixed prices with stock management (limited quantity). | | **RECIPE** | Automatically calculate prices based on the sum of ingredient costs (supports SHAPED, SHAPELESS, and FURNACE recipes). | | **LINK** | Items inherit prices and stock from other items for synchronized economies. | ## Web Dashboard DynaShop includes a powerful web interface for monitoring your economy: - **Price Evolution Charts**: View buy/sell price history over time - **Volume Analysis**: Monitor transaction volumes and trends - **Technical Indicators**: RSI, MACD, Bollinger Bands, and moving averages - **Price Forecasting**: AI-powered price predictions based on historical data - **Support & Resistance Levels**: Automatically identify key price points - **Trading Signals**: Get notified of potential market opportunities - **Multilingual Support**: Available in English, French, German, Spanish, Italian and more - **Dark/Light Modes**: Customizable interface for your preference > See (https://dynashop.satyria.fr/) ## Economic Simulation Features ### Tax System Collect taxes on every transaction with configurable rates: ```yaml tax: enabled: true mode: "system" # "player", "system", or "remove" receiver: "ServerBank" buy-rate: 5.0 # 5% tax on purchases sell-rate: 2.0 # 2% tax on sales ``` ### Inflation System Create a realistic economy with prices that evolve over time: ```yaml inflation: enabled: true base-rate: 0.5 # Base inflation rate per day # Configure different rates for various item categories categories: food: 0.3 # Food items inflate more slowly minerals: 0.8 # Minerals inflate faster ``` ## Commands & Permissions - **/dynashop reload** - Reload the plugin configuration (Permission: dynashop.reload) - **/dynashop limit ** - Manage transaction limits (Permission: dynashop.admin.limit) - **/dynashop inflation ** - Control inflation (Permission: dynashop.admin.inflation) ## Placeholders (to use in the ShopGUI+ config file) *Works in shop, amount selection & bulk selection menus* - **%dynashop_current_buyPrice%** - Raw buy price - **%dynashop_current_sellPrice%** - Raw sell price - **%dynashop_current_buyMinPrice%** - Minimum buy price - **%dynashop_current_buyMaxPrice%** - Maximum buy price - **%dynashop_current_sellMinPrice%** - Minimum sell price - **%dynashop_current_sellMaxPrice%** - Maximum sell price - **%dynashop_current_buy%** - Formatted buy price with min/max - **%dynashop_current_sell%** - Formatted sell price with min/max - **%dynashop_current_stock%** - Current stock level - **%dynashop_current_maxstock%** - Maximum stock level - **%dynashop_current_stock_ratio%** - Stock ratio (current/max) - **%dynashop_current_colored_stock_ratio%** - Colored stock ratio - **%dynashop_current_buy_limit%** - Remaining buy limit - **%dynashop_current_sell_limit%** - Remaining sell limit - **%dynashop_current_buy_reset_time%** - Time until buy limit resets - **%dynashop_current_sell_reset_time%** - Time until sell limit resets ## ⚙️ Easy Configuration Set up items with just a few lines in your ShopGUI+ shop config: ```yaml diamond: type: item item: material: DIAMOND quantity: 1 typeDynaShop: DYNAMIC buyPrice: 1000 buyDynamic: min: 800 max: 1200 growth: 1.01 decay: 0.99 sellPrice: 900 sellDynamic: min: 700 max: 1100 growth: 1.01 decay: 0.99 slot: 0 page: 1 ``` ## Dependencies **Required:** - **(https://www.sp