ShopPlugin

A flexible shop system for Minecraft servers with advanced features like NBT support, potions, and automatic restock system.









Features

• Flexible Shop Creation - Create unlimited shops with individual names
• Customizable Display Names - Shops can have beautiful, colored display names
• NBT Support - Items with custom names and enchantments
• Potion System - Easy creation of potion trades with all effects
• Automatic Restock - Trades become available again after configurable time
• Permission System - Control over shop access and management
• Persistent Storage - All shops are automatically saved
• Tab Completion - Full auto-completion for all commands

Installation

1. Download the shopplugin-*.jar file
2. Place it in your plugins/ folder
3. Restart the server
4. The plugin automatically creates the plugins/ShopPlugin/shops/ folder

Commands
Basic Commands (for all players)
/shop <shopname> - Opens a shop
/shop list - Shows all available shops
/shop info - Plugin information

Admin Commands (requires shopplugin.admin permission)
/shop create <shopname> [display_name] - Creates a new shop
/shop addtrade <shop> <input> <amount> <output> <amount> [max_uses] - Adds a trade
/shop addpotion <shop> <input> <amount> <potion_type> [max_uses] - Adds a potion trade
/shop addtradeadvanced <shop> <input> <amount> <output> <amount> [max_uses] [input_name] [output_name] [input_enchants] [output_enchants] [input_potion] [output_potion] - Advanced trade creation
/shop removetrade <shopname> <trade_index> - Removes a trade
/shop rename <shopname> <new_display_name> - Changes the display name
/shop trades <shopname> - Shows all trades in a shop
/shop remove <shopname> - Deletes a shop
/shop potions - Shows all available potion types
/shop restock <shopname> [hours] - Sets restock interval

Permissions
shopplugin.admin: true # Full access to all shop management functions
shopplugin.use.*: true # Access to all shops
shopplugin.use.<shopname>: true # Access to specific shop

Examples
Create a simple shop
/shop create general "§6General Shop"

Add basic trade
/shop addtrade general DIAMOND 1 DIAMOND_SWORD 1 10

Add potion trade
/shop addpotion general EMERALD 2 HEALING 5
/shop addpotion general GOLD_INGOT 1 HEALING:UPGRADED 3
/shop addpotion general DIAMOND 1 REGENERATION:EXTENDED 1

Add advanced trade with NBT
/shop addtradeadvanced general DIAMOND 1 DIAMOND_SWORD 1 10 "&bMagical Diamond" "&cFire Sword" "" "FIRE_ASPECT:2,SHARPNESS:5"

Set restock interval
/shop restock general 12 # Every 12 hours
/shop restock vip 6 # Every 6 hours

Potion Types
Available Base Potions:

• HEALING - Instant Health
• HARMING - Instant Damage
• REGENERATION - Regeneration
• POISON - Poison
• STRENGTH - Strength
• WEAKNESS - Weakness
• SPEED - Speed
• SLOWNESS - Slowness
• JUMP - Jump Boost
• FIRE_RESISTANCE - Fire Resistance
• WATER_BREATHING - Water Breathing
• INVISIBILITY - Invisibility
• NIGHT_VISION - Night Vision

Modifiers:

• :EXTENDED - Longer duration
• :UPGRADED - Stronger effect (Level II)

Examples:

• HEALING:UPGRADED - Healing II
• SPEED:EXTENDED - Speed with longer duration
• REGENERATION:UPGRADED - Regeneration II

Enchantments
Enchantments are specified in the format ENCHANTMENT:LEVEL, multiple separated by comma:

"SHARPNESS:5,FIRE_ASPECT:2,UNBREAKING:3"

Common Enchantments:

• SHARPNESS - Sharpness
• FIRE_ASPECT - Fire Aspect
• UNBREAKING - Unbreaking
• EFFICIENCY - Efficiency
• FORTUNE - Fortune
• SILK_TOUCH - Silk Touch
• PROTECTION - Protection
• THORNS - Thorns

Restock System
The plugin features an automatic restock system:

• Default Interval: 24 hours
• Customizable: Individually adjustable per shop
• Automatic: Trades are checked and restocked when opening the shop
• Persistent: Restock times are saved and survive server restarts

How it works:

1. When a trade reaches its maximum uses, it's marked as "sold out"
2. After the configured restock time expires, the trade becomes available again
3. The check occurs every time a player opens the shop

Configuration
Shops are automatically saved in plugins/ShopPlugin/shops/ as YAML files. Each shop has its own file with the following format:

display-name: "§6My Shop"
restock-hours: 24
trades:
- input-material: DIAMOND
input-amount: 1
output-material: DIAMOND_SWORD
output-amount: 1
max-uses: 10
output-display-name: "&cFire Sword"
output-enchantments: "FIRE_ASPECT:2,SHARPNESS:5"
restock-times:
0: 1640995200000

Troubleshooting
Shop won't open

• Check the permission shopplugin.use.<shopname> or shopplugin.use.*
• Make sure the shop exists with /shop list

Trades don't work

• Check material names (must be exact)
• Use /shop trades <shopname> to see all trades

Potions have no effects

• Make sure you use POTION, SPLASH_POTION or LINGERING_POTION as material
• Check the potion type with /shop potions

Support
For problems or questions:

1. Check server logs for error messages
2. Make sure all permissions are set correctly
3. Use /shop info to get plugin information