promotional bannermobile promotional banner

KMarket

A configurable server-side economy and marketplace mod for Fabric featuring admin shops, player trading, JSON pricing, and modded item support.

KMarket

KMarket is a server-authoritative economy and marketplace mod for Minecraft Java Edition 26.1.2 using Fabric.

It provides a configurable server shop, secure player marketplace, instant item selling, persistent balances, and a transparent community treasury.

Features

  • Configurable buy, sell, and player-market prices
  • Support for vanilla and modded items
  • Typo-tolerant shop search
  • Instant selling with /sell
  • Enchanted-item pricing bonuses up to 70%
  • Enchanted book support
  • Player listings with complete ItemStack component preservation
  • Persistent player balances, listings, claims, and transaction history
  • Player payments and donations
  • Market taxes collected into a server fund
  • Owner-controlled treasury payments and adjustments
  • Compact balance display for large amounts
  • Automatic detection of unconfigured items
  • Atomic JSON saving with automatic backups
  • Secure, server-side transaction validation
  • Protection against duplicate purchases, overflow, and negative balances

Requirements

  • Minecraft Java Edition 26.1.2
  • Fabric Loader 0.19.3 or newer
  • Fabric API for Minecraft 26.1.2
  • Java 25

KMarket uses vanilla inventory interfaces and is designed primarily as a server-side mod. Players still require any content mods used by the server’s modpack.

Prices, categories, owners, transaction limits, taxes, and other settings can be configured under config/kmarket. Modded items are supported through their registry IDs; unavailable items are safely ignored.

Setup

  1. Install Fabric Loader for Minecraft 26.1.2.
  2. Install the matching Fabric API.
  3. Place kmarket-1.0.0.jar in the server’s mods folder.
  4. Start the server once to generate config/kmarket.
  5. Stop the server before editing the generated configuration.
  6. Add owner UUIDs to config/kmarket/owners.json.
  7. Configure prices inside config/kmarket/prices/.
  8. Restart the server, or use /kmarket reload after changing prices.

Example owners.json:

{
  "owners": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Owners must also have Minecraft permission level 4. The dedicated server console is authorized automatically.

KMarket automatically places unknown registered items in:

config/kmarket/unconfigured.json

Items must be enabled and given prices before appearing in the shop. Modded items use their complete registry IDs, such as examplemod:item_name.

Player Commands

  • /market — open the player marketplace
  • /market sell <quantity> — list copies of the held item
  • /market mine — view and manage your listings
  • /market cancel <listing-uuid> — cancel a listing
  • /market claim — collect returned or expired items
  • /market notifications — view market notifications
  • /shop — open the server shop
  • /shop search <text> — search with typo tolerance
  • /shop buy <registry-id> <quantity> — buy an item
  • /shop sell <registry-id> <quantity> — sell an item
  • /sell — instantly sell one held item
  • /sell <quantity> — instantly sell the selected quantity
  • /sell all — instantly sell all matching held items
  • /balance — display your balance
  • /balance <player> — display an online player’s balance
  • /pay <player> <amount> — send money to another player
  • /donate <player> <amount> — donate money to another player
  • /serverfund — display the public community treasury balance

Owner Commands

These commands require permission level 4 and a UUID listed in owners.json.

  • /kmarket reload — validate and reload the configuration
  • /serverfund pay <player> <amount> — pay a player using existing treasury funds
  • /serverfund add <amount> — add an audited treasury correction
  • /serverfund remove <amount> — remove an audited treasury correction
  • /serverfund history — view recent tax and treasury transactions
  • /vaultgrant status — verify owner authorization
  • /vaultgrant money add <player> <amount> — add money
  • /vaultgrant money set <player> <amount> — set a balance
  • /vaultgrant money remove <player> <amount> — remove money

Every treasury transaction is audited. Treasury payments subtract from collected funds instead of automatically generating additional money.


The KMarket Team

profile avatar
  • 1
    Projects
  • 18
    Downloads