AuctionHouse

Advanced Auction House System for PowerNukkitX

Modern, GUI-first auction experience for Bedrock servers
🔍 Search • 📊 Sorting • 📦 Storage • 💸 Taxes • 💾 Persistence

Download • Features • Configuration

---

🌟 Overview

AuctionHouse is a full-featured auction system built exclusively for PowerNukkitX. It uses the PowerNukkitX Form API to deliver a smooth GUI-first experience for Bedrock servers.

Players can list items, browse listings with filters and search, buy items safely with tax support, and claim items from storage when sales complete or expire.

🧩 Gameplay Flow

1. 🧾 List an item with /ah sell <price>
2. 🛍️ Browse auctions with search/sorting in the GUI
3. ✅ Confirm purchase and receive the item in storage
4. 📦 Claim items from storage anytime

✨ Features

• 🧭 GUI-first workflow (Dashboard, Auction List, Storage)
• 🔎 Search with flexible query matching
• 📈 Sorting modes (highest/lowest price, newest/oldest)
• ⏳ Listing expiration with automatic return to storage
• 💰 Tax system for sales
• 💾 Persistent data (auctions and storage saved to disk)
• 🛡️ Permission-based listing limits with group overrides
• 🔗 LlamaEconomy integration
• ♻️ Safe reload for config/menus/messages

📷 Screenshots

⚙️ Requirements

• PowerNukkitX server
• LlamaEconomy (required)

🚀 Installation

1. Download the latest jar from the releases page.
2. Place it into your server's plugins folder.
3. Start the server once to generate config files.
4. Configure config.yml, menus.yml, and messages.yml as needed.

🎮 Commands & Permissions

Command	Description	Permission	Default
/ah	Open the main menu	auctionhouse.use	true
/ah sell <price>	List the item in hand	auctionhouse.sell	true
/ah reload	Reload config/menus/messages	auctionhouse.admin	op
/ah help	Help menu	auctionhouse.use	true
/ah about	Plugin info	auctionhouse.use	true

🔐 Permission-based Limits

• auctionhouse.limit.<group> uses listing-limits in config.yml
• auctionhouse.admin is always unlimited

🧾 Data Files

• data.yml → active auction listings
• storage.yml → player storage items
• config.yml → main settings
• menus.yml → GUI text
• messages.yml → chat and log text

🛠️ Configuration

config.yml (main settings):

prefix: "§6AuctionHouse §f> "

command:
  description: "Opens the AuctionHouse menu"
  usage: "/ah [sell <price>|reload|help]"
  aliases:
    - "auction"
    - "ihale"
  permission: "auctionhouse.use"
  subcommands:
    sell:
      - "sell"
      - "sat"
    reload:
      - "reload"
      - "yenile"
    help:
      - "help"
      - "yardim"

settings:
  min-price: 10.0
  max-price: 1000000.0
  max-listings-per-player: 10
  listing-duration-hours: 24
  tax-percent: 5.0
  check-interval-ticks: 1200

listing-limits:
  default: 10
  vip: 20
  mvip: 30

menus.yml controls GUI text and placeholders. messages.yml controls chat and log messages.

🤝 Support

• GitHub: https://github.com/ClexaGod/AuctionHouse
• Developer: https://github.com/ClexaGod
• PowerNukkitX Discord: https://discord.gg/dAFPfxRqkX

📜 License

This project is licensed under the Apache License 2.0.

---

Made by ClexaGod for the PowerNukkitX community.