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
Admin Permissions
Installation
- Download the latest NusaCore Shop plugin JAR file
- Place the JAR file in your server's plugins folder
- Restart your server or run /reload confirm
- Edit the configuration files in the plugins/NusaCore folder as needed
- Run /nsc reload to apply your changes
Configuration
config.yml
Code (Text):
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
Code (Text):
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
Code (Text):
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
- 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
- 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+
- Vault (optional but recommended)