NusaCore - Dynamic Economy & Shop System

NusaCore Shop - Dynamic Economy Shop System for Minecraft Servers
NusaCore Shop is a comprehensive shop plugin for Minecraft servers that provides a dynamic economy system with inflation/deflation based on supply and demand. This plugin offers a user-friendly GUI interface, multiple categories, item quantity selection, and a sophisticated economic model that makes server economies more realistic and engaging.

Features
Dynamic Economy

• Real Supply & Demand: Prices automatically adjust based on item stock levels
• Inflation & Deflation: Item prices rise when stocks are low and fall when abundant
• Random Fluctuations: Optional small random price changes to simulate market volatility
• Price Limits: Configurable maximum inflation and deflation percentages

User-Friendly Shopping

• Categorized Items: Organize shop items into intuitive categories
• Multi-Page Support: Navigate large shops with pagination
• Quantity Selection: Buy or sell multiple items with a simple interface
• Price Information: See buy and sell prices for each item

⚙️ Admin Features

• Easy Configuration: Simple YAML configuration files
• In-Game Management: Admin commands for price control and market monitoring
• Transaction Logs: Track player purchases and sales
• Market Reports: Broadcast significant price changes to players

Integration

• Vault Support: Compatible with all economy plugins that support Vault
• Fallback Economy: Built-in economy system if Vault is not available

Commands
Player Commands

• /shop - Opens the main shop menu
• /toko - Alias for /shop

Admin Commands

• /shopadmin reload - Reloads the shop configuration
• /shopadmin setprice <item> <buy> <sell> - Manually sets item prices
• /shopadmin info <item> - Shows detailed item information
• /shopadmin update - Updates item stock and prices immediately

Economy Admin Commands

• /nsc reload - Reloads the entire plugin
• /nsc inflation update - Forces an inflation update (adjusts all prices)
• /nsc inflation status - Shows current inflation status and settings

Permissions
Player Permissions

• nusacore.shop.use - Allows use of the shop menu
• nusacore.shop.buy - Allows buying items from the shop
• nusacore.shop.sell - Allows selling items to the shop

Admin Permissions

• nusacore.shop.admin - Access to shop admin commands
• nusacore.admin.reload - Permission to reload the plugin
• nusacore.admin.inflation - Permission to manage inflation

Installation

1. Download the latest NusaCore Shop plugin JAR file
2. Place the JAR file in your server's plugins folder
3. Restart your server or run /reload confirm
4. Edit the configuration files in the plugins/NusaCore folder as needed
5. Run /nsc reload to apply your changes

Configuration
config.yml

general:
verbose-logging: false  # Set to true for detailed logs
 
economy:
  use-vault: true  # Use Vault for economy if available
  starting-balance: 1000.0  # Starting balance for new players

inflation:
  enabled: true  # Enable dynamic pricing
  update-interval: 30  # Update prices every X minutes
  random-fluctuations: true  # Apply small random price changes
  max-random-percent: 5.0  # Maximum random price change percentage
  announce-changes: true  # Announce significant price changes
  broadcast-changes: true  # Broadcast general market updates

storage:
  save-interval: 15  # Save data every X minutes

items.yml

settings:
  price-update-interval: 60  # Minutes between price updates
  max-inflation-percent: 100.0  # Maximum inflation percentage
  max-deflation-percent: 50.0  # Maximum deflation percentage

categories:
  blocks:
    name: Building Blocks
    description: Various blocks for building
    icon: BRICKS
    items:
      - stone
      - oak_planks
      - bricks
 
  tools:
    name: Tools & Weapons
    description: Equipment for survival
    icon: DIAMOND_PICKAXE
    items:
      - iron_pickaxe
      - diamond_sword

items:
  stone:
    name: Stone
    material: STONE
    buy-price: 5.0
    sell-price: 2.5
    min-stock: 100
    max-stock: 1000
    current-stock: 500
    dynamic-pricing: true
 
  iron_pickaxe:
    name: Iron Pickaxe
    material: IRON_PICKAXE
    buy-price: 250.0
    sell-price: 100.0
    min-stock: 10
    max-stock: 50
    current-stock: 25
    dynamic-pricing: true

Examples
Simple Shop Setup

categories:[/B][/B][/B]
[B][B][B]  food:
    name: Food Items
    description: Edible items
    icon: APPLE
    items:
      - apple
      - bread
      - cooked_beef

items:
  apple:
    name: Apple
    material: APPLE
    buy-price: 10.0
    sell-price: 5.0
    min-stock: 50
    max-stock: 200
    current-stock: 100
    dynamic-pricing: true
 
  bread:
    name: Bread
    material: BREAD
    buy-price: 15.0
    sell-price: 7.0
    min-stock: 50
    max-stock: 200
    current-stock: 100
    dynamic-pricing: true

  cooked_beef:
    name: Steak
    material: COOKED_BEEF
    buy-price: 25.0
    sell-price: 12.0
    min-stock: 40
    max-stock: 150
    current-stock: 80
    dynamic-pricing: true

How Dynamic Pricing Works

1. 
   
   
   • Each item has a base buy price and sell price
   • Items also have minimum and maximum stock levels
   • When stock is low (near minimum), prices increase
   • When stock is high (near maximum), prices decrease
   • Players buying items decreases stock and gradually increases prices
   • Players selling items increases stock and gradually decreases prices
   • This creates a realistic supply and demand economy

Tips for Server Owners

1. 
   
   
   • Balance Initial Prices: Set reasonable starting prices to prevent inflation
   • Configure Stock Limits: Adjust min-stock and max-stock based on item rarity
   • Monitor Economy: Use /nsc inflation status to check on market changes
   • Adjust Settings: Fine-tune inflation percentages if prices change too rapidly
   • Add Categories Gradually: Start with essential items and add more over time

Requirements

• 
  
  
  • Minecraft Server running Spigot/Paper 1.16+
  • Java 17 or higher
  • Vault (optional but recommended)
  • An economy plugin like EssentialsX (if using Vault)