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 |