EconomyPlugin

A comprehensive economy plugin for Minecraft servers with Vault integration and built-in placeholder system.

Features

• Price System: Configurable prices for all Minecraft items
• Worth Command: Check the value of items (/worth)
• Sell Commands: Multiple ways to sell items (/sell, /sellall, /sellgui)
• Buy Command: Purchase items with server currency (/buy)
• Auction House: Basic auction house framework (/actionhouse, /ah)
• GUI Interface: User-friendly sell GUI with drag-and-drop support
• Vault Integration: Works with any Vault-compatible economy plugin
• Built-in Placeholders: Custom placeholder system without external dependencies

Commands

/worth [item|hand]

• Check the worth of an item or item in hand
• Shows price for single item and full stack
• Example: /worth diamond or /worth hand

/sell [hand|all|item]

• Sell items without GUI
• /sell - Sell item in hand
• /sell hand - Sell item in hand
• /sell all - Sell all sellable items
• /sell diamond - Sell all diamonds in inventory

/sellall [item]

• Sell all sellable items in inventory
• /sellall - Sell everything sellable
• /sellall diamond - Sell only diamonds

/sellgui

• Open graphical sell interface
• Drag and drop items to sell
• Automatic processing and item returns

/buy <item> [amount]

• Purchase items from server
• /buy diamond 64 - Buy 64 diamonds
• Shows total cost and confirms purchase

/actionhouse or /ah

• Access auction house system
• Currently shows placeholder with command list
• Framework for future expansion

Built-in Placeholders

Our plugin includes its own placeholder system - no external plugins needed!

Available Placeholders:

• %economy_balance% - Player's current balance (e.g., "1000.50")
• %economy_balance_formatted% - Formatted balance (e.g., "$1,000.50")
• %economy_worth_hand% - Worth of item in hand (e.g., "500.00")
• %economy_worth_hand_formatted% - Formatted worth of item in hand (e.g., "$500.00")
• %economy_currency_symbol% - Currency symbol ("$")
• %economy_player_name% - Player's name
• %economy_sellable_count% - Total count of sellable items in inventory
• %economy_total_sellable_worth% - Total worth of all sellable items
• %economy_total_sellable_worth_formatted% - Formatted total worth of all sellable items

Usage Examples:

• Chat Format: Players can type "I have %economy_balance_formatted%!"
• Scoreboards: Use placeholders in scoreboard plugins
• Custom Messages: Integrate with other plugins that support placeholder replacement

Installation

1. Install a Vault-compatible economy plugin (EssentialsX, iConomy, etc.)
2. Install Vault plugin
3. Place EconomyPlugin.jar in your plugins folder
4. Restart server

Configuration

prices.yml

Contains all item prices. Format:

prices:
  DIAMOND: 500.0
  GOLD_INGOT: 100.0
  IRON_INGOT: 50.0

plugin.yml

Standard plugin configuration with commands and permissions.

Permissions

• economy.worth - Use /worth command
• economy.sell - Use /sell command
• economy.sellall - Use /sellall command
• economy.sellgui - Use /sellgui command
• economy.buy - Use /buy command
• economy.actionhouse - Use /actionhouse command
• economy.admin - Admin commands
• economy.* - All economy permissions

Building

mvn clean package

The built JAR will be in the target/ directory.

Dependencies

• Spigot/Paper 1.19+
• Vault API
• Java 8+

No external placeholder dependencies required!

Features in Detail

Price System

• Comprehensive price list for all Minecraft items
• Easy to modify via prices.yml
• Support for custom items and materials

Sell GUI

• 54-slot inventory interface
• Visual buttons for selling and closing
• Automatic item return for non-sellable items
• Drag-and-drop support

Economy Integration

• Full Vault API integration
• Support for any economy plugin
• Balance checking and transactions

Custom Placeholder System

• Built-in placeholder replacement engine
• Chat integration for automatic placeholder processing
• No external dependencies required
• Easy to extend with new placeholders

Error Handling

• Comprehensive error messages
• Invalid item handling
• Insufficient funds checking
• Inventory space validation

Future Development

• Full auction house implementation
• Player-to-player trading
• Dynamic pricing system
• Shop NPCs
• Economy statistics and analytics
• More placeholder expansions

Support

For issues and feature requests, please use the GitHub issues page.