✨ Features

Sell Wand System

• Custom Wand Items: Configurable name, lore, material, and enchantments
• NBT-Based Identification: Unique wands that can't be duplicated
• Durability System: Limited uses per wand with configurable amounts
• Tier-Based Multipliers: Different sell multipliers for each tier

Upgrade System

• Multi-Tier Progression: Upgrade from Tier 1 to higher tiers
• Flexible Costs: Upgrade using money (Vault) or XP levels
• GUI Interface: Beautiful upgrade menu with visual feedback
• Progressive Benefits: Higher tiers = better multipliers, more uses, lower cooldowns

⏰ Cooldown Management

• Per-Player Cooldowns: Prevent spam usage
• Tier-Based Cooldowns: Higher tiers have shorter cooldowns
• Admin Bypass: Admins can bypass cooldowns
• Visual Feedback: Time remaining displayed to players

Booster System

• Personal Boosters: Individual player multiplier boosts
• Global Boosters: Server-wide multiplier boosts
• Temporary Duration: Configurable boost duration
• Stacking Support: Multiple boosters can be active

Economy Integration

• Vault Support: Compatible with all major economy plugins
• Custom Price Lists: Define item prices in config
• Automatic Calculation: Smart price calculation with multipliers
• Currency Formatting: Configurable currency symbols and decimals

Logging & Analytics

• Comprehensive Logging: Track all sales, upgrades, and booster usage
• File & Console Logging: Dual logging support
• Detailed Records: Player, amount, location, and item data
• Log Rotation: Automatic log file management

Effects & Feedback

• Sound Effects: Configurable sounds for different actions
• Particle Effects: Visual feedback with particle systems
• Title & Action Bar: Rich text notifications
• Success/Error Feedback: Clear visual and audio cues

️ Installation

1. Download the latest release from the releases page
2. Place the JAR file in your server's
   Code (Text):

   plugins
   folder
3. Install Vault and an economy plugin
4. Restart your server
5. Configure the plugin using the generated config files

Commands

Command	Description	Permission	Aliases
/sellwand	Main command and help	azsellwandplus.use	/sw, /azsellwand
/sellwand give <player> <tier> [amount]	Give sell wand to player	azsellwandplus.give
/sellwand upgrade [player]	Open upgrade GUI	azsellwandplus.upgrade
/sellwand booster <type> <multiplier> <duration>	Apply booster	azsellwandplus.booster
/sellwand reload	Reload configuration	azsellwandplus.admin

Permissions

Permission	Description	Default
azsellwandplus.use	Use sell wands	true
azsellwandplus.give	Give sell wands to players	op
azsellwandplus.upgrade	Upgrade sell wands	true
azsellwandplus.booster	Apply boosters	op
azsellwandplus.admin	All permissions + bypass cooldowns	op

⚙️ Configuration

Main Config (

Code (Text):

config.yml

)

The main configuration file contains:

• Wand Settings: Name, lore, material, enchantments
• Tier Configuration: Multipliers, uses, cooldowns, upgrade costs
• Booster Settings: Duration, multipliers, limits
• Effect Settings: Sounds, particles, titles
• Item Prices: Fallback prices for materials
• Economy Settings: Vault integration, currency formatting
• Logging Settings: File and console logging options

Messages (

Code (Text):

messages.yml

)

Customizable messages for:

• General plugin messages
• Sell wand interactions
• Upgrade system feedback
• Booster notifications
• Error messages
• Command help

GUI Configuration (

Code (Text):

gui/upgrade.yml

)

Upgrade menu customization:

• GUI title and size
• Item materials and names
• Lore templates
• Sound and particle effects
• Animation settings

Usage Examples

Basic Usage

1. Get a sell wand:
   Code (Text):

   /sellwand give <player> 1
2. Right-click a chest with the wand to sell all contents
3. Upgrade your wand:
   Code (Text):

   /sellwand upgrade
4. Apply boosters:
   Code (Text):

   /sellwand booster personal 2.0 10

Admin Commands
Placeholders

The plugin supports various placeholders in messages and lore:

• Code (Text):

  %tier%
  - Wand tier
• Code (Text):

  %multiplier%
  - Sell multiplier
• Code (Text):

  %uses%
  - Remaining uses
• Code (Text):

  %amount%
  - Sale amount
• Code (Text):

  %player%
  - Player name
• Code (Text):

  %time%
  - Time remaining

Compatibility

• Minecraft: 1.20+
• Server Software: Spigot, Paper, Purpur
• Java: 17+
• Dependencies: Vault (required)
• Economy Plugins: All Vault-compatible economy plugins

Support

For support, bug reports, or feature requests:

• Join our Discord server

License

This project is licensed under the MIT License - see the LICENSE file for details.

Credits

• Author: GamingHuzai