PlayerAuctions

PlayerAuctions is a modern and feature-rich auction house plugin for PaperMC servers. It provides a robust, intuitive, and scalable platform for players to buy and sell items, fully integrated with Vault-based economies and PlaceholderAPI.

✨ Features

• Modern GUI Interface:

  • Clean Design: Simple and intuitive auction house interface with color-coded items
  • Configurable Borders: Toggle decorative borders with customizable materials (default: black stained glass)
  • Smart Layout: Organized control panel with clear navigation buttons
  • Real-time Updates: Instant GUI refresh when auctions are bought, sold, or expired
  • Player Info Display: Shows player balance and current page in the center of the GUI

• Auction Management:

  • Instant Buy: Players can purchase items immediately at set prices
  • Listing Management: View and manage your active auction listings
  • Search System: Search for specific items using keywords
  • Sort Options: Sort auctions by newest, oldest, or price
  • Purchase History: Track your auction transaction history

• Command System:

  • Tab Completion: Full command suggestions with descriptions
  • Multiple Aliases: Use /ah, /auction, or /auctionhouse
  • Help System: Comprehensive help command with color-coded instructions
  • Permission-based: Granular permission system for different features

• Visual Enhancements:

  • Color Coding: Green/red indicators for affordable items
  • Time Indicators: Color-coded time remaining (green for long, red for urgent)
  • Clean Borders: Optional decorative borders for a polished look
  • Responsive Design: Items display properly with proper formatting

• Integration Support:

  • Vault Economy: Full integration with Vault-based economies
  • PlaceholderAPI: Support for displaying auction data externally
  • SQLite Database: Lightweight and reliable data storage
  • Multiple Economy Providers: Support for various economy plugins

🚀 Commands

Command	Description	Permission
/ah	Opens the main auction house GUI	playerauctions.use
/ah help	Shows all available commands with descriptions	playerauctions.use
/ah sell <price> [buy_now] [duration]	Lists the item in your hand for auction	playerauctions.sell
/ah search <keyword>	Searches for items matching the keyword	playerauctions.search
/ah notify <on/off>	Toggles your personal auction notifications	playerauctions.notify
/ah history [player]	Shows your or another player's auction history	playerauctions.history, playerauctions.history.others
/ah listings	Opens a GUI of your active listings	playerauctions.use
/ah myauctions	Alternative command for your listings	playerauctions.use
/ah reload	Reloads the plugin's configuration	playerauctions.reload

Command Aliases: All commands work with /ah, /auction, and /auctionhouse

⚙️ Permissions

Permission	Description	Default
playerauctions.use	Allows opening and using the main GUI	true
playerauctions.sell	Allows listing items for sale with /ah sell	true
playerauctions.cancel	Allows cancelling your own auctions (if they have no bids)	true
playerauctions.search	Allows using the /ah search command	true
playerauctions.categories	Allows using the /ah categories command	true
playerauctions.notify	Allows using /ah notify to toggle notifications	true
playerauctions.history	Allows viewing your own auction history	true
playerauctions.history.others	Allows viewing another player's auction history	op
playerauctions.reload	Allows reloading the plugin's configuration	op
playerauctions.admin	Grants access to all administrative features	op

🔧 Configuration (config.yml)

Key configuration options:

# PlayerAuctions Configuration

auction:
  max-auctions-per-player: 5
  auction-duration: 48h
  defaults:
    duration: 48h
  min-price: 1.0
  tax-percentage: 5
  notification-methods: [chat, actionbar, title, sound]

economy:
  preferred: VAULT
  fallback: VAULT
  sink:
    mode: NONE
    target: "server_treasury"

gui:
  title-main: "&6PlayerAuctions"
  title-my-listings: "&6My Listings"
  system: "INVENTORY_FRAMEWORK"
  size: 54
  items-per-page: 45
  border:
    enabled: true
    material: BLACK_STAINED_GLASS_PANE
    name: " "
    lore: []

mailbox:
  enabled: true
  retention-days: 30

GUI Border Configuration

The border system is fully customizable:

• enabled: Enable or disable the decorative border (default: true)
• material: Any valid Minecraft material (default: BLACK_STAINED_GLASS_PANE)
• name: Custom display name for border items
• lore: Custom lore lines for border items

🐛 Troubleshooting

Common Issues:

• Economy not found: Ensure Vault is installed and an economy plugin is active
• Permissions not working: Check your permission plugin configuration
• GUI not opening: Verify the player has playerauctions.use permission
• Border not showing: Check gui.border.enabled in config.yml

📄 License

This plugin is developed by MinekartaStudio. Please ensure you have the proper license to use this software on your server.

🤝 Support

For support, bug reports, or feature requests:

• Join our Discord server
• Create an issue on our GitHub repository
• Contact the development team