Econ: Market and Commerce

EconMC（Econ：市场与交易）是一套安全、适用于多人游戏的服务器经济与拍卖系统，专为服务器和 SMP 打造。

所有交易均由服务器权威处理，精确保留 NBT 数据，并旨在防止物品复制漏洞。 非常适合生存、RPG、派系、进度制和经济类服务器。

此模组需要Modular Toasts API才能运行！

核心功能

多人拍卖行

可自定义的服务器商店

由服务器保存的货币

跨会话持久保存

什么是 Econ：市场与交易？

EconMC 是一套功能强大的服务器权威经济与拍卖系统，可将热门原版服务器上精致的商店和玩家市场带入你的世界或整合包。它重现了大家熟悉的服务器商店、玩家经营的拍卖、余额排行榜和可兑换货币体验，同时具备完整的 NBT 精确性、多人游戏安全性，并支持模组物品。

无论你是在打造生存经济、RPG 进度世界，还是竞争激烈的派系服务器，Econ 都能让你轻松自定义定价、库存上限、买卖规则和奖励，让经济系统完美契合你的服务器愿景。

拍卖行

玩家间交易，安全无忧。

以自定义价格上架物品

精确匹配 NBT（附魔、自定义名称、模组数据）

过期机制

邮箱溢出保护

取消自己的上架

支持管理员强制取消

完全适用于多人游戏

支持大型市场分页

服务器商店

由管理员控制的买卖经济。

服务器向玩家购买物品，也向玩家出售物品

可配置库存上限

补货冷却机制

可选的背包扫描模式（批量出售）

买入/卖出分页

页面导航

从 v1.0.6 起，界面如下所示

新增出价和订单分页，并缩小条目以便一次查看更多内容

从 v1.0.8 起，支持群组余额！/bal group

与群组共享余额，拥有 Officer 或更高权限的成员可以在 /shop 中使用群组余额！

邮箱系统

拍卖过期、背包已满或发生连接错误时，邮箱系统便会派上用场。你可以随时从邮箱中领取物品：

永远不会丢失物品或金钱。

离线安全投递

溢出保护

领取系统

跨会话可用

代金券系统

实体货币物品。

管理员可以生成代金券

右键即可兑换

完全由服务器权威验证

安全的金额上限

非常适合用于：

生物掉落物

箱子

活动

奖励

任务系统

玩家余额

余额（玩家拥有的金钱数量 $）会自动保存。你可以在拍卖行或服务器商店中使用余额，也可以通过出售物品或代金券获得余额；输入 /bal 可查看余额，输入 /baltop 可查看前 10 名排行榜。

命令

EconMC 几乎可以完全通过/shop图形界面操作，同时也提供了完整的玩家和管理员命令，用于管理经济、拍卖、市场出价、订单、邮件和服务器商店设置。

玩家命令

经济

/bal
查看当前余额。

/bal group

打开群组界面，创建群组或加入群组

/baltop
查看服务器上最富有的前 10 名玩家。

/pay <player> <amount>
向另一名玩家转账。

示例：
/pay Steve 500

商店与市场

打开主商店

/shop
打开完整的 EconMC 商店界面。

其中包括：

• 拍卖行
• 服务器商店
• 市场订单
• 市场竞价
• 邮箱状态
• 拍卖计时器的时间格式同步

快速卖给服务器

/shop sell <qty>
如果主手中的物品已配置为可由服务器收购，则立即将其卖给服务器商店。

示例：
/shop sell 32

拍卖行命令

创建拍卖

/ah <qty> <price>
默认将主手中的物品上架60 分钟。

/ah <qty> <price> <duration> <minutes|hours|days>
自定义上架时长，将主手中的物品上架。

/ah <qty> <price> <duration> <minutes|hours|days> scan
从背包中上架符合条件的物品，而不仅限于主手中的物品堆。

示例：
/ah 16 5000
/ah 16 5000 30 minutes
/ah 64 12000 12 hours
/ah 128 25000 7 days scan

拍卖最长时长：90 天

查看正在进行的拍卖

/shop au_list
显示拍卖行当前正在进行的拍卖。

购买拍卖物品

/shop au_buy <id>
按 ID 购买拍卖物品。

示例：
/shop au_buy 42

取消自己的拍卖

/shop au_cancel <id>
取消正在进行的拍卖，并将物品发送到邮箱。

查看自己的正在进行的拍卖

/shop my_listings
显示你当前正在进行的拍卖。

拍卖时间显示格式

/shop format time short
/shop format time decimal
/shop format time long

允许每位玩家选择 GUI 中拍卖时间的显示方式。

市场订单命令

创建求购订单

/order <item> <amount> <price>
为指定物品创建市场订单。

• item= 物品 ID
• amount= 需求数量
• price= 出价总额

示例：
/order minecraft:diamond 16 5000

创建订单时会立即预留相应金额。

市场竞价命令

创建竞价拍卖

/bid <amount> <startingPrice>
使用主手中的物品创建竞价拍卖，并采用默认配置的时长。

/bid <amount> <startingPrice> <duration> <minutes|hours|days>
创建自定义时长的竞价拍卖。

示例：
/bid 16 500
/bid 16 500 30 minutes
/bid 16 500 12 hours
/bid 16 500 7 days

• amount= 主手物品数量
• startingPrice= 起拍价

竞价拍卖最长时长：7 天

邮箱命令

领取邮件

/mail claim
领取邮箱中的所有物品。

如果背包已满，剩余物品会掉落在你脚边。

此功能用于：

• 退回过期拍卖物品
• 退回已取消拍卖的物品
• 退回被管理员取消的拍卖物品
• 其他未送达的物品转移

管理员命令

所有管理员命令都需要权限等级 2（OP）。

经济管理员命令

/eco set <player> <amount>
将玩家的余额设为指定金额。

示例：
/eco set Steve 10000

/eco give <player> <amount>
向玩家的余额中添加金钱。

示例：
/eco give Steve 2500

/eco take <player> <amount>
从玩家的余额中扣除金钱。余额不能低于 0。

示例：
/eco take Steve 500

/eco reset <player>
将玩家的余额重置为 0。

示例：
/eco reset Steve

/eco voucher <amount>
创建可兑换的金钱凭证物品。

示例：
/eco voucher 10000

/payall <amount>
向所有在线玩家发放指定金额。

示例：
/payall 1000

管理员服务器商店命令

设置服务器收购物品

/admin shop buy <price>
服务器将以指定价格收购你主手中完全相同的物品。

示例：
/admin shop buy 250

设置服务器出售物品

/admin shop sell <price> <stock> <cooldownMinutes>
服务器将出售你主手中完全相同的物品，并设有库存上限和自动补货。

• price = 单件价格
• stock = 全服务器库存上限
• cooldownMinutes = 补货间隔

示例：
/admin shop sell 500 100 30

这会创建一个基于动态库存的商店条目。
库存为全服务器共享，而非按玩家分别计算。

服务器无限库存出售条目

/admin shop sell <price> <stock> <cooldownMinutes> unlimited
创建一个库存无限的出售条目。

示例：
/admin shop sell 500 100 30 unlimited

移除服务器收购条目

/admin shop remove_buy
停止服务器收购你主手中的物品。

移除服务器出售条目

/admin shop remove_sell
移除与你主手中的物品对应的服务器出售条目。

管理员拍卖管理

强制取消任意拍卖

/admin auction cancel <id>
按 ID 取消任意正在进行的拍卖，并安全地将物品退回卖家的邮箱。

示例：
/admin auction cancel 42

适用于：

• 移除违禁物品
• 修复损坏或滥用的拍卖条目
• 处理价格滥用
• 清理不需要的拍卖条目

API 集成

// Modular Toasts API
compileOnly fg.deobf(files("libs/modulartoasts-1.0.1-dev.jar"))
runtimeOnly fg.deobf(files("libs/modulartoasts-1.0.1-dev.jar"))

// EconMC
compileOnly fg.deobf(files("libs/econmc-1.0.10-dev.jar"))
runtimeOnly fg.deobf(files("libs/econmc-1.0.10-dev.jar"))

常见问题

EconMC 支持多人游戏服务器吗？

支持。EconMC 完全由服务器权威控制，专为多人游戏环境设计。所有余额、商店数据和拍卖信息都存储在服务器端。值得一提的是，它也可以完全离线使用，例如用于角色扮演类的单人实况地图。

玩家的钱会安全保存吗？

会。玩家余额使用持久化世界数据保存，并会随服务器世界自动加载。

如果玩家购买物品时背包已满，会怎样？

物品会安全地发送到他们的邮箱。
绝不会丢失任何物品。

如果服务器在交易过程中崩溃，会怎样？

交易会在确认前由服务器端处理。物品和余额会按安全顺序处理，以防止丢失或复制。

玩家能利用兑换券作弊吗？

兑换券由服务器生成，并在服务器端兑换。根据你对经济系统安全性的要求，还可以加入额外的安全措施。

怪物或其他模组可以奖励金钱吗？

可以。你可以：

让生物掉落兑换券物品

在命令方块中使用 /money give

通过服务器端脚本或数据包进行集成

可以轻松自定义商店物品吗？

可以。
服务器商店物品直接通过你主手中的物品定义，这意味着以下内容都完全受支持：

附魔

NBT 数据

自定义名称

模组物品

以上内容均完全受支持。

它能替代 Vault 或其他经济 API 吗？

EconMC 是独立的经济系统，无需外部插件或 API 即可运行。

它适用于整合包吗？

适用。
只要模组已安装在客户端和服务器端（如有需要），就能与整合包及模组物品兼容。

管理员可以管理拍卖吗？

可以。管理员可以随时强制取消拍卖条目，并安全地将物品退还给卖家。

GUI 可以自定义吗？

当前 GUI 简洁且针对服务器进行了优化。未来更新可能会支持材质自定义或主题包。

“EconMC”是什么意思？

EconMC 代表“经济：市场与商业”

来看看我的 Patreon！

即使你不能捐款，仅仅订阅免费档也是巨大的支持 🙂

Patreon