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