Server Market

Server Market is a Fabric server-side mod that brings a complete player-driven economy and marketplace to your server. Players can check their balance, send money to others (even offline players), and review their transaction history — all through simple commands or an intuitive GUI. The mod features both a player market and a system shop where items can be listed, bought, and sold with full NBT variant support. It also supports purchase orders with parcel station delivery, so buyers can place requests and sellers can fulfill them without needing to meet face-to-face. Administrators can optionally introduce physical currency items, set up system shop prices, manage player balances directly, and configure the economy to suit their needs. Storage defaults to SQLite for zero-setup operation, but can be switched to MySQL with optional XConomy record mirroring for shared database environments. For server owners running 1.21.9 or newer, the mod bundles Placeholder API support out of the box. Developers can hook into the exposed API and event system to query balances, process transfers, intercept purchases, or integrate the economy into their own mods.

Requirements

Required:

• Fabric API (version matched to your MC version)
• Fabric Language Kotlin 1.13.8+kotlin.2.3.0
• Fabric Permissions API 0.5.0

Optional:

• LuckPerms (recommended) for permission management
• Placeholder API (1.21.9+ JAR only)

Commands

Player:

/svm
/svm menu

/svm money
/svm balance
/svm pay <player> <amount>
/svm history [page]

/svm sell <price>
/svm restock <quantity>
/svm pull

/svm list
/svm search <keyword>

/svm buy <quantity> <item> [seller]

/svm cash <value> <quantity>
/svm exchange <amount>

/svm order <price> <amount>
/svm supply <quantity>

Admin:

/svm admin balance <player>
/svm admin set <player> <amount>
/svm admin add <player> <amount>
/svm admin remove <player> <amount>
/svm admin rank
/svm admin history <player> [page]

/svm admin price <price> [limit]
/svm admin pull
/svm admin purchase <price> [limit]

/svm admin cash <value>
/svm admin cash get
/svm admin cash del
/svm admin cash list [item]

/svm admin reload

Updates

• Command wording updated:
  • purchase order: /svm purchase -> /svm order
  • sell to buyer: /svm selltopurchase -> /svm supply
• Removed command group: /svm edit (admin commands are now under /svm admin).
• Deprecated: /svm admin lang

Placeholder API

Available in the 1.21.9+ JAR only when Placeholder API is installed:

• %server-market:balance%
• %server-market:balance_short%
• %server-market:parcel_count%
• %server-market:player_name%
• %server-market:top_name:<rank>% (rank 1–10)
• %server-market:top_balance:<rank>% (rank 1–10)
• %server-market:top_balance_short:<rank>% (rank 1–10)

Integration API

Entry point: asagiribeta.serverMarket.api.ServerMarketApiProvider

• getBalance, hasEnough, getParcelCount
• addBalance, withdraw, setBalance, transfer
• getTopBalances, getHistory, format, openMenu, getModVersion

EconomyProvider (Vault-style): asagiribeta.serverMarket.api.economy.EconomyProviderRegistry

• withdraw, format

Events:

• ServerMarketEvents.BALANCE_CHANGED
• ServerMarketEvents.PRE_PURCHASE (return false to cancel)
• ServerMarketEvents.POST_PURCHASE

Configuration / Storage

Config file: config/server-market/config.properties

Reload in-game: /svm admin reload

Economy

Key	Default	Description
initial_player_balance	100.0	Balance for first-time joiners
max_transfer_amount	1000000.0	Max amount per /svm pay
enable_transaction_history	true	Record transactions
max_history_records	10000	Auto-prune oldest records
enable_tax	false	Tax on player shop sales
market_tax_rate	0.05	Tax rate (0.0–1.0)

Storage (SQLite — default)

Key	Default	Description
storage_type	sqlite	sqlite or mysql
sqlite_path	market.db	Database file path

Storage (MySQL / XConomy)

Set storage_type=mysql and configure mysql_host, mysql_port, mysql_database, mysql_user, mysql_password, mysql_use_ssl, mysql_jdbc_params.

XConomy table names (when sharing an existing database):

Key	Default
xconomy_player_table	xconomy
xconomy_non_player_table	xconomynon
xconomy_record_table	xconomyrecord
xconomy_login_table	xconomylogin
xconomy_system_account	SERVER
xconomy_write_record	false

Set xconomy_write_record=true to mirror transactions into XConomy's record table (MySQL only).

Debug

Key	Default	Description
enable_debug_logging	false	Verbose debug logs