TokioAuction v1.0

TokioAuction | Premium & Lightweight Auction House
Welcome to TokioAuction, the ultimate premium and lightweight auction house solution designed specifically for modern Minecraft servers. Built for Spigot and Paper 1.21+ environments, TokioAuction provides a seamless, lag-free player trading experience. Whether you are running a survival, skyblock, or factions server, TokioAuction integrates perfectly with your Vault economy to allow players to buy, sell, and browse items with ease.

Unlike heavy, bloated alternatives, TokioAuction relies on fully asynchronous database operations (supporting both SQLite and MySQL), ensuring zero TPS impact on your server. Elevate your community's economy with our unique DiscordSRV integration, allowing players to purchase in-game items directly from your Discord server!

---

Core Features

• Modern, Clean GUI: Players are greeted with a beautifully designed 54-slot paginated auction house menu. The interface features an elegant black and gray glass border, logically organized navigation buttons, and detailed item tooltips displaying the seller's name, price, and exact expiration time.
• Intuitive Buying & Selling: Trading is effortless. Players simply hold an item and type /ah sell <price> to list it globally. Buyers can browse the active listings and purchase items instantly with a single click.
• Secure Collection Bin: Never worry about lost items again. If an auction expires, is manually cancelled by the seller, or is purchased while the buyer's inventory is full, the item is safely routed to a personal, secure Collection Bin.
• Personal Listing Management: Players have full control over their economy presence. The "My Listings" menu allows users to view all their currently active auctions and cancel them at any time with a simple right-click.
• Advanced Item Blocking: Maintain a balanced economy by blacklisting specific items. Server administrators can easily prevent the sale of specific materials, items with custom names, or items containing specific lore lines.
• Fully Configurable Experience: Tailor TokioAuction to perfectly match your server's theme. Every single GUI title, chat message, button material, lore line, sound effect, and color code can be customized within the config.yml.
• Zero Lag & Async Database: Built with performance in mind. TokioAuction works right out of the box with SQLite. For larger networks, easily switch to MySQL utilizing full HikariCP connection pooling. All database operations are completely asynchronous, guaranteeing zero TPS drops.

---

Innovative Discord Integration
Take your server's economy cross-platform! TokioAuction features a powerful integration with DiscordSRV.

• Live Auction Feed: Every time a player lists a new item in-game, TokioAuction automatically generates and posts a rich embed to your designated Discord channel.
• Detailed Previews: The Discord embed beautifully displays the item's name, applied enchantments, the seller's username, the listing price, and an item thumbnail.
• Interactive "Buy" Button: We've attached an interactive "Buy Item" button directly to the Discord embed. Players who have linked their Minecraft accounts to Discord (via /discord link) can purchase the item right from their Discord app!
• Auto-Cleanup: When an item is sold, expires, or is cancelled in-game, the Discord embed is automatically deleted to keep your channel clean and accurate.

---

Commands & Permissions

Player Commands:

• /ah — Open the main Auction House interface.
• /ah sell <price> — List the item you are currently holding.
• /ah listings — Open the GUI to manage your active listings.
• /ah collection — Open your personal Collection Bin to retrieve items.

Admin Commands:

• /ah reload — Reload the configuration files without restarting the server.

(Aliases: /auction, /auctionhouse)

Permissions:

• tokio.auction.use — Allows opening the auction house (Default: True)
• tokio.auction.sell — Allows listing items for sale (Default: True)
• tokio.auction.buy — Allows purchasing items (Default: True)
• tokio.auction.bypass.limit — Bypass the maximum active listing limit (Default: OP)
• tokio.auction.admin — Access to the reload command (Default: OP)

---

Requirements & Installation

Prerequisites:

• Server: Spigot or Paper (Version 1.21+)
• Java: Java 21 or higher
• Economy: Vault + any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
• Optional: DiscordSRV (Required only if you wish to use the Discord integration features)

Quick Setup:

1. Download TokioAuction.jar and place it into your server's plugins/ folder.
2. Ensure Vault and your chosen economy plugin are installed and running.
3. Start or restart your server to generate the plugin files.
4. Navigate to plugins/TokioAuction/config.yml to customize settings, messages, and database options.
5. (Optional) Install DiscordSRV, enable Discord in the TokioAuction config, and paste your Channel ID.
6. Run /ah reload in-game or from the console. You're ready to go!

---

Support & Community
Having issues, found a bug, or need help configuring the plugin? We provide full support and regular updates for all buyers.

• Open a conversation directly on this marketplace.
• Join our Support Discord: https://discord.gg/RNNEPRZQMR

Made with ♡ by Tokiomara