QuickDeal

Modern AuctionHouse & Marketplace Plugin for Minecraft Servers

🛒 Marketplace GUI • 💰 Drag & Drop Selling • ⭐ Seller Ratings • 💾 Auto Backup • ⚙️ Fully Customizable

---

📌 About QuickDeal

QuickDeal is a modern AuctionHouse plugin designed to make server trading cleaner, safer, and easier to manage.

Instead of opening directly into a basic auction list, QuickDeal gives players a clean marketplace-style experience with a dashboard, drag & drop selling, player profiles, seller ratings, transaction history, expired item recovery, and admin tools.

QuickDeal is suitable for survival, SMP, economy, roleplay, and community servers that need a better trading system with a professional and customizable GUI.

---

✨ Features

• 🏪 Modern marketplace-style dashboard
• 🛒 Browse item marketplace
• 💰 Safe drag & drop item selling
• 🔢 Amount selector and price editor
• 💬 Chat-based custom price input
• ✅ Buy and sell confirmation menus
• 💸 Tax preview and final earning display
• ⭐ Seller rating and trust system
• 👤 Player market profiles with skin heads
• 🏆 Top seller leaderboard
• 📜 Purchase and sales history
• 📦 Expired item recovery
• 🎒 Pending claims for full inventories
• 🔔 Configurable broadcasts and notifications
• 🛠️ Admin control panel
• 🧾 Transaction logs
• 💾 Auto backup system
• 🎨 Fully customizable GUI
• 🌐 English and Indonesian language support
• 🔌 Vault economy bridge support
• 📊 PlaceholderAPI support
• 🗄️ SQLite and MySQL/MariaDB storage support
• 🖥️ Premium startup console with ASCII banner

---

💰 Drag & Drop Selling

QuickDeal includes a safe and interactive GUI-based selling system.

Players can drag an item into the sell slot, adjust the item amount, set the price using GUI buttons, or type a custom price through chat input. The sell menu also shows tax preview and final earnings before the listing is confirmed.

Items are safely returned when selling is cancelled, the GUI is closed, the player quits, the plugin reloads, or the plugin is disabled. If the inventory is full, the item can be saved into pending claims.

---

🛒 Marketplace Dashboard

QuickDeal opens with a dashboard instead of a basic listing page.

Players can access:

• Browse Marketplace
• Sell Item
• My Listings
• Expired Items
• Purchase History
• Sales History
• Player Profile
• Seller Leaderboard
• Rating Menu
• Help Center

---

⭐ Seller Ratings

After a successful purchase, buyers can rate sellers.

Ratings help players identify trusted sellers and improve the marketplace experience. High-rated sellers can stand out more and build trust with other players.

---

🛡️ Safe Transactions

QuickDeal is designed to reduce item loss and duplication risks.

Safety features include:

• Transaction validation
• Listing state checks
• Cancel protection
• Inventory full protection
• Pending claims
• Anti-dupe checks
• Safe item return system

---

🔔 Notifications & Broadcasts

QuickDeal includes configurable player notifications and marketplace broadcasts.

Server owners can enable or disable listing broadcasts, purchase notifications, seller alerts, offline seller messages, actionbar messages, sounds, and expensive item announcements through the configuration files.

---

⚙️ Fully Customizable

Server owners can customize almost everything:

• GUI titles
• GUI size
• Button slots
• Materials
• Item names
• Lore
• Sounds
• Messages
• Categories
• Taxes
• Limits
• Backup settings
• Notifications
• Startup console

---

🎮 Commands

Player Commands

/ah
/ah browse
/ah sell
/ah sell <price>
/ah listings
/ah expired
/ah sold
/ah history
/ah profile
/ah profile <player>
/ah leaderboard
/ah rating
/ah claims
/ah help

Aliases:

/quickdeal
/auctionhouse
/auction
/qd
/deal

Admin Commands

/qda
/qda reload
/qda backup create
/qda backup list
/qda backup restore <file>
/qda listings
/qda listings <player>
/qda remove <listingId>
/qda logs
/qda logs <player>
/qda debug
/qda storage status
/qda economy status
/qda testdata <amount>

---

🔐 Permissions

Basic permissions:

quickdeal.use
quickdeal.open
quickdeal.sell
quickdeal.buy
quickdeal.cancel
quickdeal.history
quickdeal.profile
quickdeal.rating
quickdeal.leaderboard
quickdeal.claims
quickdeal.admin

---

📦 Requirements

Requirement	Version
Minecraft	1.21+
Java	21+
Server Software	Paper / Spigot
Economy	Vault-compatible economy plugin recommended

Paper is recommended for the best experience.

---

🔌 Supported Integrations

• Vault
• PlaceholderAPI
• PlayerPoints
• TokenManager
• CoinsEngine
• ItemsAdder
• Oraxen
• MMOItems

Integrations are optional and depend on your server setup.

---

🗂️ Configuration

QuickDeal generates its files inside:

plugins/QuickDeal/

Example structure:

plugins/QuickDeal/
├── config.yml
├── categories.yml
├── sounds.yml
├── price-limits.yml
├── item-rules.yml
├── webhooks.yml
├── database/
├── backups/
├── messages/
│   ├── english.yml
│   └── indonesia.yml
└── gui/
    ├── dashboard.yml
    ├── browse.yml
    ├── sell_item.yml
    ├── confirm_listing.yml
    ├── buy_confirm.yml
    ├── profile.yml
    ├── leaderboard.yml
    ├── rating.yml
    └── admin_dashboard.yml

---

🧩 Support

Found a bug or have a suggestion?

Please open an issue on the GitHub repository and include:

• QuickDeal version
• Server version
• Java version
• Economy plugin
• Error logs
• Steps to reproduce

---

📄 Notes

QuickDeal is built to provide a modern, clean, and safe marketplace experience for Minecraft servers while still being easy to configure and manage.