BTD Shop & Sell

BTD Shop & Sell is a Fabric economy mod for Minecraft Java Edition 1.20.1.

It adds easy-to-use graphical /shop and /sell menus powered by the Impactor economy system.

Features

• Double-chest /shop buying interface
• Double-chest /sell selling interface
• Player balance display using the player’s own head
• Buy individual items or complete stacks
• Safely returns unsupported items
• Returns unsold items when the sell menu is closed
• Preconfigured buy and sell prices
• Vanilla-only automatic food and block registration
• Optional support for selected modded items

Shop categories

• Ingredients
• Blocks
• Combat
• Food
• Redstone
• Functional items

Commands

Command	Description
/shop	Opens the buying menu
/sell	Opens the selling menu

How selling works

1. Run /sell.
2. Place supported items inside the selling area.
3. Click the lime Sell button.
4. Supported items are removed.
5. The money is deposited into the player’s Impactor balance.
6. Unsupported items are returned safely.
7. Closing the menu cancels the sale and returns all unsold items.

Requirements

Required

• Minecraft Java Edition 1.20.1
• Fabric Loader
• Fabric API
• Impactor

BTD Shop & Sell must be installed on both the server and every connecting player’s client.

Impactor is required on the server to store balances and process economy transactions.

Installation

Server

1. Install Fabric Loader for Minecraft 1.20.1.
2. Install Fabric API.
3. Install Impactor.
4. Place the BTD Shop & Sell JAR inside the server’s mods folder.
5. Fully restart the server.

Client

1. Install Fabric Loader for Minecraft 1.20.1.
2. Install Fabric API.
3. Place the BTD Shop & Sell JAR inside the client’s .minecraft/mods folder.
4. Fully restart Minecraft.

Do not use /reload after installing or replacing the mod.

Pricing

Version 1.0.0 uses preconfigured prices stored inside the mod.

Base sell prices include:

Item	Sell price
Copper Ingot	$2.50
Iron Ingot	$5.00
Gold Ingot	$5.00
Diamond	$10.00
Emerald	$5.00

Other sell prices are calculated from their configured buying prices.

Price configuration

Version 1.0.0 does not currently include an external configuration file.

Server owners who want to change prices must edit ShopItems.java and rebuild the mod.

External price configuration is planned for a future update.

Mod compatibility

Automatically registered foods and blocks are restricted to items in the vanilla minecraft: namespace.

Modded items are not automatically added to the shop. A modded item must be explicitly supported before it can be bought or sold.

VinURL compatibility

Optional support is included for the VinURL Custom Record when VinURL is installed.

VinURL is not required for the rest of the mod and is not bundled or redistributed with BTD Shop & Sell.

Open source

BTD Shop & Sell is open source under the MIT License.

You may view, download, modify, build, and redistribute the source code under the terms of the license.

• Source code on GitHub
• Report bugs or request features
• GitHub releases

Building from source

Download or clone the GitHub repository.

Windows

.\gradlew.bat clean build