What is BotchedMarket?
BotchedMarket brings trading to your server. In the /ah auction house players list items at their own price, and the house keeps 5% of every sale. Each player can have 5 listings at a time for up to 48 hours. Unsold items and money from sales go to a collection bin, so sellers get paid even when they’re offline.
The /shop server shop sells decorative blocks in 8 categories, from wool and concrete to lighting, and it’s where players buy the market blocks. Sell chests sell whatever goes into them, every 5 minutes at first and instantly at the top tier. Collectors pick up dropped items within 5 to 50 blocks. Shop chests let players run their own shop on their island, buying or selling items at their own prices.
What you can do
Auction house
Fixed-price listings with search, a 5% house fee, 5 listings each and a collection bin.
Server shop
Decorative blocks in 8 categories, plus sell chests, collectors and shop chests.
Sell chests and collectors
Auto-sell every 5 minutes down to instantly, and pickup ranges of 5, 10, 25 and 50 blocks.
Player shops
Shop chests on your own island that sell to or buy from other players.
Features
- Auction house with fixed prices, search, your own listings and a collection bin
- A 5% house fee on every sale, 5 listings per player and a 48-hour listing time (all in config.yml)
- Two buyers can’t buy the same item, and nobody pays without getting it
- Server shop with 8 categories of decorative blocks in shop.yml
- Sell chests that sell their contents on a timer, using shop or BotchedSkills merchant prices
- Collectors that pull dropped items into a chest within their range
- Shop chests that sell to players or buy from them, with stock taken straight from the chest
- Shop chests only go down on your own island when BotchedSkyblock is installed
- Hoppers can’t pull from market blocks, and visitors can’t open or break them
- Blocked items and worlds, plus a player and staff guide book
Sell chest and collector tiers
| Tier | Sells every | Upgrade price |
|---|---|---|
| 1 | 5 minutes | Start |
| 2 | 3½ minutes | $15,000 |
| 3 | 2 minutes | $40,000 |
| 4 | Instantly | $100,000 |
| Tier | Pickup range | Upgrade price |
|---|---|---|
| 1 | 5 blocks | Start |
| 2 | 10 blocks | $10,000 |
| 3 | 25 blocks | $30,000 |
| 4 | 50 blocks | $75,000 |
Default prices in the server shop: sell chest $5,000, collector $4,000, shop chest $1,000. Change any of them in config.yml.
Commands
| Command | What it does |
|---|---|
/ah | Open the auction house (also /auction, /auctionhouse) |
/ah sell <price> [amount] | List the item in your hand |
/ah search | Search the listings |
/ah listings | See and cancel your own listings |
/ah collect | Collect unsold items and money |
/shop | Open the server shop (also /servershop, /market) |
/shop sell | Sell items to the server |
| Command | What it does |
|---|---|
/bmarket give <player> <sellchest|collector|shopchest> [tier] [amount] | Give market blocks |
/bmarket price | What the server pays for the item in your hand |
/bmarket ahclear <player> | Remove someone’s auction listings |
/bmarket info | Count listings, market blocks and shop items |
/bmarket reload | Reload the config |
Get started
- Place BotchedMarket-1.1.0.jar in your server’s plugins folder next to BotchedEconomy (or a Vault economy) and restart.
- Players can open
/ahand/shopright away. - Set the auction fee, listing limits and tier prices in plugins/BotchedMarket/config.yml, and the shop blocks in shop.yml.
- Run
/bmarketreload to apply your changes.
Requirements
| Area | Support |
|---|---|
| Server software | Paper 1.21.8 through 26.3, one jar |
| Java | 21 or newer |
| Economy | BotchedEconomy or any Vault economy |
| Optional | BotchedSkills (sell prices from its merchants) |
| Optional | BotchedSkyblock (shop chests on your own island only) |
Latest version
Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.
Shared menu style
Works with Paper 1.21.8 – 26.3
- The auction house, server shop, confirm screens and market block menus use the shared Botched menu style
- The guide book was redesigned with a cover page, a contents page and colored chapter headers
- Included with purchase
Earlier versions (1)
First release
Works with Paper 1.21.8 – 26.3
/ahauction house: players list items at their own price, and the house keeps 5% of every sale- 5 listings per player for up to 48 hours, with a collection bin for unsold items and money
/shopserver shop with 8 categories of decorative blocks, plus the market blocks- Sell chests that sell every 5 minutes, 3½ minutes, 2 minutes or instantly, and collectors with 5, 10, 25 and 50 block ranges
- Shop chests for running your own shop on your island, buying or selling at your own prices
- Included with purchase
Screens





Auction house




