Trading and item conditions
All three modes use market funds and escrowed assets. Other nodes may change an order while a confirmation is open. The server rechecks its revision, price, and remaining quantity. Refresh an expired view instead of relying on an old screenshot.
Listing, purchase, and bid confirmations retain the real sale/auction item's name, enchantments, and lore. Exact-sample buy orders also show their saved sample. Use the confirmation text for quantity, total, reserved funds, and tax; display items never become the assets removed or settled.
Advanced buy orders
The buyer selects a currency, unit price, quantity, duration, and item conditions, then reserves the necessary market funds. A supplier selects matching items and a quantity before confirming. Partial fulfillment is allowed; cancellation or expiry returns unspent funds.
Buy orders have three modes. Plain material accepts the selected vanilla materials only without attached metadata; named, enchanted, or custom items are not silently accepted. Advanced conditions apply explicit rules. Exact sample compares the complete item fingerprint with quantity excluded.
Advanced conditions use AND: an item must satisfy every configured condition, while any material in the selected set is accepted. Extra enchantments are disabled by default and require an explicit toggle. Name and lore support exact and contains matching, without regular expressions.
| Condition | Meaning |
|---|---|
| Material | Match one material from the selected set, together with the other conditions |
| Enchantments | Each requested enchantment must be in its own level range; extra enchantments are a separate setting |
| Durability | Remaining durability percentage, 0–100; 80–100 means at least 80% remains; items without durability are rejected when this condition is set |
| Name / lore | Use the editor's exact or contains rule; unset fields impose no restriction |
| Exact sample | Compare the fingerprint of an item normalized to a quantity of one; trading quantity is separate |
Advanced vanilla rules inspect only properties the editor explicitly understands. Admitted custom data that advanced rules cannot interpret requires an exact sample. Exact mode does not lift the item admission restrictions described below.
Editing conditions
Order details and listing confirmations explain which conditions apply in the selected mode. Plain material mode does not apply advanced conditions retained in the editor. Advanced mode shows its individual rules; exact-sample mode compares the sample's complete properties.
Open Materials to select multiple items from the current server catalog. Click a selected item to remove it. Filter by material ID, show selected items only, add the held material, or enter IDs in bulk, up to 64 materials. Materials failing item admission cannot be newly selected. Invalid bulk input preserves the existing selection; a cleared set must be filled before listing.
Click Enchantments to open the selector, then choose an enchantment and adjust its minimum and maximum levels with the buttons. You can also remove an individual condition. A minimum of zero allows the enchantment to be absent; 0–0 requires its absence. Import from main hand replaces the current enchantment conditions with the held item's enchantments, setting each minimum and maximum to its held level. If no material is selected, it also adds the held material. Other edited conditions remain, and importing switches to advanced mode.
Durability provides minimum and maximum percentage buttons in steps of 5%. Click a value to enter a precise integer, choose 100% or at least 50%, or import the held item's remaining durability. A configured range requires a durable item; clearing it removes that restriction.
Name and lore have dedicated pages for Exact and Contains matching. Chat accepts only content, without = or ~ condition prefixes. Use \n between lore lines. Importing from the main hand uses the complete original text, including formatting and line breaks, for exact matching. Clearing removes the restriction; importing empty text with exact matching requires that field to be empty.
Fulfillment preview
- Click Supply in a buy order to preview your inventory storage slots. Icons retain the real name, enchantments, and original lore, with added match results, rejection reasons, and quantities to take and leave.
- Click a matching slot to protect it; click again to include it. Protected items are excluded from this fulfillment. Protection belongs only to this preview flow, not a permanent inventory setting; select it again when starting another fulfillment.
- Set a quantity or use Maximum available to recalculate from unprotected matching items and the order's remaining demand. Items are selected in inventory-slot order. A shortfall is shown and prevents final confirmation. Refresh reads the order and inventory again for the latest available quantity.
- Review the quantity from each slot, gross proceeds, tax, and net income. The confirmation also lists source slots and quantities so you can catch a selected tool or collectible before submitting.
- After final confirmation, the actual inventory properties and quantities are checked again before removal; submitting the order rechecks its revision and remaining demand. Inventory changes reject removal. If the order expires or another supplier fills it, use the operation record to check any items already escrowed and inspect claims before starting a new operation.
Previewing does not move or modify inventory items. Fulfillment transfers snapshots of the actual selected items instead of generating replacements from the buyer's sample.
Exact samples and custom items
Exact mode retains serialized item data and compares complete properties, including the name, lore, enchantments, and serializable custom data. Sample stack size does not define the order quantity or price. Changing durability, name, or other metadata can make an item stop matching.
New exact buy orders retain both the real sample and rule fingerprint, validate admission and matching material/fingerprint when published, and normalize the sample quantity to one. The sample is for display; fulfillment still transfers the supplier's actual items. Historical orders containing only a fingerprint identify the missing display sample instead of guessing or recreating the original item.
KiteMarket does not interpret third-party item IDs or equate items solely by appearance. Nodes must have matching Minecraft versions and item profiles. Validate real samples created by your item plugin before enabling player trading.
Exact samples still must pass item admission and serialization round-trip checks. Exact mode cannot bypass these restrictions. 1.0.0 does not accept new trades in items with nested storage structures, such as shulker boxes and bundles; empty shulker boxes are also excluded. Other special items or data can be traded only if admitted by the current build. If you see UNVERIFIED_SPECIAL_ITEM, UNVERIFIED_ITEM_DATA, or ITEM_ROUNDTRIP_UNSAFE, stop listing that item instead of retrying in exact mode. Follow the operations and migration guide for safe withdrawal of assets already in escrow.
Fixed-price sales
The seller escrows real items with the same properties as the main-hand sample and chooses a unit price and duration. One listing cannot mix differing item properties, and buyers can purchase part of its quantity. Buyers review price, quantity, currency, and total before confirming. Items enter the buyer's claims, and the seller receives income after the order's tax. Unsold items can be withdrawn to the seller's claims. A full inventory does not cause items to be dropped on the ground.
The listing confirmation shows estimated gross proceeds, tax, and net income for selling the entire quantity in one purchase. Partial purchases calculate tax separately, so accumulated net income can differ through rounding to the currency's smallest unit. Use transaction records for the actual amounts.
Market and detail icons retain the actual sample's name, enchantments, and original lore, with order details appended. Use the order description and confirmation for quantities and amounts. Display icons are never regenerated into settlement items.
Public auctions
Bids are manual total amounts for one item or stack. The highest accepted bid is fully reserved, and outbid funds immediately return to the wallet. There is no proxy bidding, buyout, or hidden reserve price. An accepted bid with less than 30 seconds remaining extends the deadline to at least 30 seconds after that bid, capped at 5 minutes after the original deadline. These are fixed rules, with deadlines checked against database time.
Use the order's starting price, minimum increment, and deadline. Self-bidding is not permitted. A seller must not bypass settlement by cancelling an auction with an accepted bid; administrative intervention requires an audit reason.
The starting price is the total price for the whole auction lot, not a price multiplied by item quantity. The listing confirmation estimates tax and net income at the starting price; settlement uses the final highest accepted bid.
Details show the minimum accepted bid, increment, whether you are leading, and additional funds needed for the minimum bid. A leading bidder only needs to fund the increase. Bid the current minimum opens a confirmation first; a higher total can also be entered. Another bid changes the revision and rejects an old confirmation, requiring a refresh; bids are never automatically increased. If the next minimum exceeds the currency limit, further bidding is disabled while the existing highest bid still settles normally.
At expiry, the winner receives the items in claims and the seller receives income after tax. With no bids, items return to the seller's claims. All modes forbid self-purchasing, self-fulfillment, and self-bidding. Published prices, conditions, and fees are fixed; cancel and recreate to change them. Administrators cannot directly reverse completed trades.
Escrow and claims
If listing creation fails after item escrow, inspect claims and the operation record before submitting the items again. Leave inventory space before claiming. If money or item delivery becomes UNKNOWN, stop retrying, record the operation ID, and ask an administrator to reconcile it.
Search and transaction receipts
Filter by type, currency, or material, then sort by ending time, newest first, or price. Search covers order IDs, material IDs, real names, lore, and active advanced-condition text. % and _ are literal characters; serialized bytes and fingerprints are excluded. Database filtering happens before pagination, and pages retain your filters. Price sorting compares fixed-price and buy-order unit prices or auction starting totals; filter to the same type and currency first. No exchange rates or cross-currency valuation are applied.
Click a history entry for a read-only receipt showing the individual trade's quantity, currency, gross amount, fixed tax, net-income recipient, and confirmed refunds or returned items. Seller proceeds come from the linked transaction, never cumulative order quantities. Your proceeds receipt does not expose the buyer's original operation evidence.
Bidder history includes the amount unfrozen when outbid and the settled whole lot when winning. Raising your own bid is not recorded as being outbid; duplicate requests or concurrent settlement workers do not duplicate these records.
Historical and current operation states are separate. Missing older details are explicitly marked, not treated as zero or successful. Result messages distinguish success, failure, and pending review, retain a clickable operation ID, and provide relevant wallet or claims links. Pending results do not offer automatic retries, refunds, or redelivery.