Minecraft Plugin · Ironing out kinks

BotchedMarket

An auction house, a server shop for decorative blocks, auto-sell chests, item collectors and player shop chests, all on one economy.

Discuss on the forum
Website downloads
0
BotchedMarket artwork
Platform
Paper 1.21.8 – 26.3
Trading
Auction house · shops
Version
1.1.0
Requires
BotchedEconomy or Vault
Overview

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.

Highlights

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.

Everything included

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
Upgrades

Sell chest and collector tiers

Sell chests
TierSells everyUpgrade price
15 minutesStart
23½ minutes$15,000
32 minutes$40,000
4Instantly$100,000
Collectors
TierPickup rangeUpgrade price
15 blocksStart
210 blocks$10,000
325 blocks$30,000
450 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.

Reference

Commands

Player commands
CommandWhat it does
/ahOpen the auction house (also /auction, /auctionhouse)
/ah sell <price> [amount]List the item in your hand
/ah searchSearch the listings
/ah listingsSee and cancel your own listings
/ah collectCollect unsold items and money
/shopOpen the server shop (also /servershop, /market)
/shop sellSell items to the server
Admin commands
CommandWhat it does
/bmarket give <player> <sellchest|collector|shopchest> [tier] [amount]Give market blocks
/bmarket priceWhat the server pays for the item in your hand
/bmarket ahclear <player>Remove someone’s auction listings
/bmarket infoCount listings, market blocks and shop items
/bmarket reloadReload the config
Setup

Get started

  1. Place BotchedMarket-1.1.0.jar in your server’s plugins folder next to BotchedEconomy (or a Vault economy) and restart.
  2. Players can open /ah and /shop right away.
  3. Set the auction fee, listing limits and tier prices in plugins/BotchedMarket/config.yml, and the shop blocks in shop.yml.
  4. Run /bmarket reload to apply your changes.
Compatibility

Requirements

AreaSupport
Server softwarePaper 1.21.8 through 26.3, one jar
Java21 or newer
EconomyBotchedEconomy or any Vault economy
OptionalBotchedSkills (sell prices from its merchants)
OptionalBotchedSkyblock (shop chests on your own island only)
Updates

Latest version

Buying the plugin gets you every version below, plus future updates. Sign in with Discord and they are always in My purchases.

v1.1.0Latest

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
  • BotchedMarket-1.1.0.jarUniversal build · Java 21 · 146.5 KBIncluded with purchase
Earlier versions (1)
v1.0.0

First release

Works with Paper 1.21.8 – 26.3

  • /ah auction 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
  • /shop server 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
  • BotchedMarket-1.0.0.jarUniversal build · Java 21 · 138.3 KBIncluded with purchase