跳到正文

Server Market

作者:AsagiriBeta

Currency and Market Mod for Minecraft Server

收藏

介绍

中文介绍正在准备中,下面暂时显示原文。

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:

Optional:

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 |

常见问题

Server Market 支持哪些 Minecraft 版本?

Server Market 支持 Minecraft Java 版 1.20–1.21.11,共 19 个版本,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。

Server Market 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅服务端。

评论

登录后评论和评分