Server Market

模组

· 作者 AsagiriBeta

Minecraft 服务器的货币与市场模组

0 本站下载 0 关注 更新于 5 个月前
一键开服(送7天)

Server Market 是一款适用于 Fabric 的服务端模组,为你的服务器带来完整的玩家驱动经济与市场系统。玩家可以通过简单的指令或直观的图形界面(GUI)查看余额、向其他玩家(包括离线玩家)转账以及查看交易历史。该模组包含玩家市场和系统商店两种模式,支持物品的上架、购买和出售,并完整支持 NBT 数据变体。此外,它还支持带有包裹站配送功能的采购订单系统,买家可以发布需求,卖家无需面对面即可履行订单。管理员可以选择性地引入实体货币物品、设置系统商店价格、直接管理玩家余额,并根据需要配置经济系统。存储默认使用 SQLite 以实现零配置运行,但可切换至 MySQL,并可选配合 XConomy 记录镜像功能,以共享数据库环境。对于运行 1.21.9 或更高版本的服务器所有者,该模组内置了 Placeholder API 支持。开发者可以通过暴露的 API 和事件系统进行挂钩,查询余额、处理转账、拦截购买操作或将经济系统集成到他们自己的模组中。

依赖要求

必需:

可选:

指令

玩家:

/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>

管理员:

/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

更新日志

  • 指令措辞更新:
    • 采购订单:/svm purchase -> /svm order
    • 卖给买家:/svm selltopurchase -> /svm supply
  • 移除指令组:/svm edit(管理员命令现位于 /svm admin 下)。
  • 已弃用:/svm admin lang

Placeholder API

仅在安装 Placeholder API 时可用(仅限 1.21.9+ JAR 包):

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

集成 API

入口点:asagiribeta.serverMarket.api.ServerMarketApiProvider

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

EconomyProvider(Vault 风格):asagiribeta.serverMarket.api.economy.EconomyProviderRegistry

  • withdraw, format

事件:

  • ServerMarketEvents.BALANCE_CHANGED
  • ServerMarketEvents.PRE_PURCHASE(返回 false 以取消)
  • ServerMarketEvents.POST_PURCHASE

配置 / 存储

配置文件:config/server-market/config.properties

游戏内重载:/svm admin reload

经济系统

Key Default Description
initial_player_balance 100.0 首次加入玩家的初始余额
max_transfer_amount 1000000.0 /svm pay 指令的最大转账金额
enable_transaction_history true 记录交易历史
max_history_records 10000 自动清理最旧的记录
enable_tax false 对玩家商店销售征收税费
market_tax_rate 0.05 税率(0.0–1.0)

存储(SQLite — 默认)

Key Default Description
storage_type sqlite sqlite 或 mysql
sqlite_path market.db 数据库文件路径

存储(MySQL / XConomy)

设置 storage_type=mysql 并配置 mysql_host、mysql_port、mysql_database、mysql_user、mysql_password、mysql_use_ssl、mysql_jdbc_params。

XConomy 表名(当共享现有数据库时):

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

设置 xconomy_write_record=true 可将交易镜像复制到 XConomy 的记录表中(仅限 MySQL)。

调试

Key Default Description
enable_debug_logging false 详细调试日志

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源