Mercado Central – Barter Marketplace

Mercado Central – Barter Marketplace

An item-for-item marketplace for Minecraft 1.20.1 Forge servers. Trade from anywhere, collect your items at a central counter.
Players can list an item and choose another item as payment, without a virtual currency. Buying and negotiating work remotely; collecting the purchase and the seller’s payment requires visiting an administrator-registered counter.

Main features

Open the market with ALT + L or /loja. The keybind can be changed in Controls.
Browse listings, search by item or player, and manage your own advertisements.
Set an item-based price and choose whether a listing accepts counteroffers.
Buy, send counteroffers, accept, reject and cancel remotely.
Listing items, purchase payments and counteroffer items are reserved by the server.
Counteroffers are separate and remain available for the seller to review while other players are offline.
Unanswered counteroffers expire after 24 real-world hours.
Rejected, cancelled and expired offers return to the owner’s collection queue.
Purchases and payments must be collected at a registered counter in the same dimension.
A compact HUD shows the active listing count and pending collection notices.
Listings, offers and collection queues are saved with the world.

Requirements

Minecraft 1.20.1
Forge 47.4.0 or newer within the 47.x series
Java 17
Install the same Mercado Central version on the server and every client.
No additional library is required for the core marketplace. Fabric, NeoForge and other Minecraft versions are not supported by this release. The published build is 0.1.0-beta.8, developed against Forge 47.4.28.

Set up a collection conter

Install the JAR on the server and clients, then start the server.
With operator permissions, look at an existing block from no more than six blocks away.
Run /loja bancada adicionar centro.
Players can collect their items near that block, with a default radius of five blocks. Right-clicking the registered block opens the collection tab when region protection permits interaction.
Use /loja bancada listar to list counters and /loja bancada remover centro to remove that registration. Only operators with permission level 2 or higher can manage counters.
The mod registers existing blocks as counters; it does not add a counter block or crafting recipe.

Trading rules and settings

Fixed prices use one item type, with up to 2304 units. A counteroffer can contain up to nine item stacks. Sellers can disable counteroffers per listing.
Insufficient inventory space leaves uncollected items in the market. Refunds go to the collection queue, not directly to the player’s inventory.
Server settings are generated in WORLD/serverconfig/mercadocentral-server.toml. They control listing limits, offer limits, collection radius and banned item IDs. Defaults include five active listings per player, ten pending counteroffers and a five-block collection radius.
Item data is preserved as serialized ItemStacks, including NBT and Forge capability data. Items whose serialized data exceeds 16 KiB cannot be traded in this version. Compatibility with individual modded items should be checked in your pack.

Optional integrations
Xaero’s Minimap: HUD placement adapter developed for version 26.6.0, with a fallback position when the adapter is unavailable.
Real Bicycles: optional hold-to-pedal assistance developed for v1.0.3. It can be disabled in the client configuration.
DirectAuth: optional authentication check. If DirectAuth is installed and its API cannot be queried, market access remains blocked.
This build also contains HUD, nameplate and server hooks for an external safezone/combat integration. Full protection, combat tagging and combat-logout enforcement require the corresponding server script and its KubeJS/YAWP/TaCZ setup. The marketplace JAR alone does not create safezones or activate that complete system.
Optional integrations are version-dependent; they are not required for the core marketplace.

Administration

Market data is stored in WORLD/data/mercadocentral.json. Back up the world and player data together, and stop the server before editing configuration or stored market data.
Reserved items are kept outside player inventories. Administrators should consider that storage behavior when defining PvP or looting rules. Collect pending items before removing the mod.

License and artwork

All Rights Reserved, with express permission to redistribute unmodified official releases in modpacks and server installations under the project’s custom license.
The project icon is AI-generated branding, not an in-game screenshot and not a preview of an added block.