Create: CoinMarket

Create: CoinMarket is a Create: Numismatics addon that adds a full server-wide marketplace and auction house to Minecraft NeoForge 1.21.1 servers. It is designed for SMP servers that want a real player-driven economy where players can buy, sell, auction, bid, collect payments, and trade items using Create: Numismatics coins.

Instead of players needing to meet up manually, set up chest shops, or handle trades through chat, CoinMarket gives everyone on the server access to a shared marketplace interface. Players can list items for immediate sale at a fixed price, or they can create longer-term auctions where other players compete by placing bids. The addon is built around Create: Numismatics, so payments can use physical coins and, when supported, verified Numismatics bank-card balances.

The main idea behind CoinMarket is simple: players put items into the market, other players buy or bid on those items, and the mod safely handles the item delivery, payment, refunds, and seller proceeds.

Opening the Marketplace

Players open the marketplace with:

/auction open

This opens the CoinMarket dashboard. From there, players can browse listings, search through items, sort available sales, buy fixed-price listings, bid on auctions, use buyout prices when available, create their own listings, and collect anything they have earned or purchased.

Listing Types

CoinMarket supports two main types of listings.

Fixed-Price Listings

The first type is a fixed-price listing. This lets a player sell an item for a set price. Another player can buy it instantly from the marketplace. This is useful for normal server shops, selling resources, selling crafted items, selling Create components, or listing anything other players may want to buy directly.

Auction Listings

The second type is an auction listing. This lets a player put an item up for bidding over a set amount of time. Other players can place bids, and the highest bidder wins when the auction ends. Auctions can also have an optional buyout price, allowing a player to purchase the item immediately if they are willing to pay the buyout amount.

When an auction is active, CoinMarket keeps track of the current highest bid. If a player gets outbid, their money is returned through the payout system. When the auction ends, the winning player receives the item and the seller receives the proceeds. If an auction ends with no bids, the item is returned to the seller.

Collection System

CoinMarket uses a safe collection system so that items, payouts, and refunds are not lost if they cannot be delivered immediately. For example, if a player’s inventory is full, or if money cannot be directly credited right away, the item or payment becomes claimable instead. Players can collect their items, auction winnings, seller proceeds, and refunds from the Collection page or by using the collection commands.

Player Commands

The main player commands are:

`/auction open`

Opens the CoinMarket dashboard.

`/auction open all`

Opens the full marketplace view.

`/auction open public`

Opens the public marketplace listings.

`/auction sell <price>`

Lists the item in your hand for a fixed price.

`/auction sell <price> <quantity>`

Lists a specific quantity of the item in your hand for a fixed price.

`/auction sell hand <price>`

Lists the currently held item for sale.

`/auction auction hand <startBid> <durationHours> [buyout]`

Creates an auction using the item in your hand. The auction starts at the chosen starting bid and lasts for the selected number of hours. A buyout price can be added if desired.

`/auction bid <listingId> <amount>`

Places a bid on an auction listing.

`/auction buyout <listingId>`

Immediately buys out an auction if that auction has a buyout price.

`/auction cancel <listingId>`

Cancels one of your active listings when cancellation is allowed.

`/auction collect`

Collects claimable items, auction winnings, returned listings, or other item claims.

`/auction collectmoney`

Collects pending money, including seller proceeds and refunds.

`/auction balance`

Shows your available Create: Numismatics balance information.

`/auction history`

Shows your market history.

`/auction pricecheck`

Checks pricing information for the item you are holding.

`/auction market <item>`

Looks up market information for a specific item.

Admin Commands

For server admins, CoinMarket also includes management commands. These are useful for maintaining the marketplace, inspecting listings, repairing issues, resolving expired auctions, refunding or returning listings, and checking Numismatics integration. Admin commands require permission level 2.

Some of the main admin commands are:

`/auction admin list`

Lists marketplace entries for admin review.

`/auction admin inspect <listingId>`

Inspects a specific listing.

`/auction admin remove <listingId>`

Removes a listing from the market.

`/auction admin repair`

Runs repair tools if listings are not appearing or if market data needs to be corrected.

`/auction resolveexpired`

Resolves expired auctions.

`/auction admin endauction <listingId>`

Forces an auction to end.

`/auction admin refundlisting <listingId>`

Refunds a listing when needed.

`/auction admin returnlisting <listingId>`

Returns a listing item to the seller.

`/auction admin viewclaims <player>`

Views a player’s pending claims.

`/auction admin forceclaim <player> <claimId>`

Forces a specific claim for a player.

`/auction admin numismaticscheck`

Runs diagnostics for Create: Numismatics integration.

`/auction admin reload`

Reloads CoinMarket configuration.

`/auction admin save`

Saves CoinMarket data.

`/auction admin clear <admin|public|all>`

Clears selected marketplace listing groups.

Server Authority and Safety

CoinMarket is server-authoritative, meaning the server is always treated as the source of truth. The marketplace interface may show listings and buttons to the player, but all important actions are checked again on the server before they actually happen. Purchases, bids, collections, payouts, refunds, and listing changes are validated server-side to help prevent stale data, unsafe transactions, or lost items.

Storage

The addon also uses SQLite-backed storage so market listings, auction data, claims, payments, and other important information can persist properly. It automatically handles database setup and migration support where needed. This makes it more suitable for long-running multiplayer servers than a temporary or client-only marketplace system.

Economy Information

Create: CoinMarket also includes economy information inside the dashboard, including summaries, charts, leaderboards, and balance details. When Numismatics bank-card support is available, the dashboard and balance command can show physical coin balance, bank/card balance, total spendable balance, and the active payment source. If bank-card support cannot be verified, CoinMarket can fall back to physical coin payments.

Purpose

Create: CoinMarket is meant for servers that want Create: Numismatics to feel like a complete economy system. It gives players a reason to earn and spend coins, creates a central place for trading, and gives server owners tools to manage the economy safely. Whether players are selling bulk resources, rare items, Create machinery parts, tools, decorative blocks, or anything else, CoinMarket gives the server a shared marketplace where those trades can happen cleanly and safely.

Requirements

Minecraft 1.21.1
NeoForge 21.1.x
Create 6.0.x
Create: Numismatics 1.0.20+
Create: CoinMarket 1.2.0

Create and Create: Numismatics are required dependencies. The mod should be installed on both the server and every client.