- Compatible API Versions
- 1.0.0.1
- Contributors
- https://github.com/BrunoJaegerK/AuctionHouseNK
AuctionHouseNK
A complete and configurable Auction House for Minecraft Bedrock servers using Nukkit.I created AuctionHouseNK because I couldn't find a decent plugin that allowed players to sell their items to other players through an auction house. I wanted a simple and reliable way for players to list their items, browse other players' offers, and trade directly with each other. That's why I decided to develop AuctionHouseNK.
Features
Auction House: Players can list items for sale and browse available listings.
Player Trading: Buy items directly from other players using the server economy.
Graphical Interface: Easy navigation through custom inventory menus.
Pagination: Browse auction listings across multiple pages.
My Auctions: View your own active listings.
Economy Integration: Uses EconomyAPI to process purchases and seller payments.
Purchase Protection: Prevents multiple players from processing the same auction simultaneously.
Inventory Validation: Checks available inventory space before delivering purchased items.
Automatic Expiration: Listings expire after a configurable duration.
Storage System: Recover items from expired or cancelled listings.
Rank-Based Limits: Configure different listing limits for each rank.
Unlimited Listings: Allow selected ranks or administrators to list without limits.
Item Data Preservation: Preserves item properties and data when storing and transferring items.
Customizable Messages: Edit chat messages, menu titles, buttons and interface descriptions.
Color Support: Customize messages and menu text using Minecraft color codes.
Commands
| Command | Description |
|---|---|
| /ah | Open the Auction House. |
| /ah sell <price> | List the item currently held in your hand. |
Permissions
| Permission | Description | Default |
|---|---|---|
| auctionhouse.use | Open the Auction House. | Everyone |
| auctionhouse.sell | List items for sale. | Everyone |
| auctionhouse.admin | Administrative permission and unlimited listing access. | Operators |
| auctionhouse.limit.vip | Apply the VIP listing limit. | Configurable |
| auctionhouse.limit.vipplus | Apply the VIP+ listing limit. | Configurable |
Configuration
AuctionHouseNK provides a configurable config.yml.Default settings:
Code:
auction:
listing-duration-hours: 24
listing-limits:
default: 5
vip: 10
tax-percent: 0.0
allow-self-purchase: false
min-price: 1.0
max-price: 1000000000.0
storage:
type: H2
database: auctionhouse
Rank-based listing limits
You can configure listing limits for your server ranks:
Code:
listing-limits:
default: 5
vip: 10
vipplus: 15
mvp: 20
elite: 30
A value of 0 means unlimited listings.
Customization
AuctionHouseNK generates two additional configuration files:| File | Description |
|---|---|
| messages.yml | Customize chat messages, notifications and error messages. |
| menus.yml | Customize menu titles, buttons, descriptions and interface text. |
Installation
- Download AuctionHouseNK from the Releases section.
- Make sure your server has the required plugins installed.
- Place the AuctionHouseNK .jar file inside your server's plugins folder.
- Start your server to generate the configuration files.
- Configure the auction settings and rank limits.
- Use /ah to open the Auction House.
Requirements
- NukkitPetteriM1Edition/nukkit.
- FakeInventories.
- FormConstructor.
- EconomyAPI.
- LuckPerms (optional, recommended for rank-based permissions).
Screenshots
The plugin includes graphical interfaces for:- Main Auction House.
- My Auctions.
- Purchase Confirmation.
- Storage.
Project Information
Bug Reports and Suggestions:
https://github.com/BrunoJaegerK/AuctionHouseNK/issues