EconomyCraft – Multiplayer Economy

EconomyCraft

适用于 Fabric 和 NeoForge 的服务端经济系统。

附属模组： EconomyCraft Bounties

/eco菜单

每个界面也都有对应命令：/bal、/pay、/daily、/shop、/ah、/auction、/sell、/worth、/orders、/deliveries、/transactions。

命令和菜单中的金额支持简写：500、1.5k、20M、3B、2T、2.5Qa、1Qi。

管理员（/eco admin）菜单

商店编辑器

浏览分类，点击物品即可编辑。

• 分类编辑器：右键点击分类可重命名、修改颜色、图标或可见性，也可将其排除在动态定价之外。删除分类后，其中的物品会移至misc，且买入价会归零。
• 添加物品：选择游戏中的任意物品，或从背包中选择。自定义名称、附魔和容器内容都会保留。
• 买入价 / 卖出价：单个物品的价格；0可关闭对应的交易方向。启用动态定价时，此处也会显示当前价格和倍率。
• 动态定价：即使服务器已启用动态定价，也可将此物品设为不参与动态定价。
• 批量数量：Shift+单击时购买或出售的数量。
• 分类：物品所在的商店页面。blocks.wood会创建子页面。
• 移除：将物品从商店中移除，但保留其价格。
• 已移除物品：列出所有已移除的物品。点击物品即可按原价格将其放回商店。通过添加物品添加已移除的物品，效果相同。

商店动态定价

可选功能，默认关闭（dynamic_prices.enabled）。所有买入价都会按以下比例缩放：

current price = base price × active-player median balance / starting balance

缩放比例限制在dynamic_prices.min_multiplier和dynamic_prices.max_multiplier之间，每隔dynamic_prices.update_minutes重新计算一次（默认每小时一次）。卖出价不受影响。可在上方的商店编辑器中按分类或物品关闭动态定价。

设置

包含config.json中的所有选项，可在游戏内编辑，并按与配置文件相同的分类分组。

玩家

选择任意玩家（无论是否在线），即可向其赠款、收款或设置余额，将其从经济系统中移除，或覆盖其活跃订单/拍卖的数量上限。

重置工具

只有两个商店工具会改动商店价格/分类。它们都不会改动权限设置。

管理员命令

/eco addmoney、/eco setmoney、/eco removemoney、/eco removeplayer。

权限

管理员和命令访问由权限节点控制。任何未由权限插件设置的管理员节点都会回退为 OP；任何未设置的命令节点都会回退为所有人允许。

管理员节点

命令节点

配置文件

在服务器上存储于config/economycraft/（单人游戏中每个世界存储于saves/<world>/economycraft/）：顶层的config.json、webhook.json和prices.json，玩家数据位于data/下。

config.json

webhook.json

prices.json

每个商店物品对应一条目，以物品 ID 为键：

{
  "minecraft:diamond": {
    "category": "ores",
    "stack": 64,
    "unit_buy": 800,
    "unit_sell": 200
  }
}

category 接受 top.sub 作为子页面，stack 是 Shift+点击时的批量数量，unit_buy/unit_sell 分别是单个物品的价格（0 会禁用对应方向）。已安装模组中的物品会自动添加，以其模组 ID 作为类别，并将 0 设为两种价格。

编辑器还会写入一些额外键：

• components：自定义物品的 NBT（名称、附魔、容器内容）。添加 #label 后缀可区分同一物品的重复条目，例如 minecraft:shulker_box#loot_rare。
• "removed": true：将物品从商店中移除，但保留其其他键，以便之后从 已移除物品中重新添加。删除 removed 键即可将其放回商店。
• "dynamic_price_enabled": false：将某个物品或 _categories 下的某个类别排除在动态定价之外。

占位符

通过 Text Placeholder API（Fabric）或 Placeholder API NeoForge（NeoForge），向其他模组提供经济数据。两者均为可选项；即使不安装也能运行此模组，但必须将对应的 JAR 放入 mods/，占位符才能正常解析。

超出玩家人数的排名会解析为无效值。

交易日志与 Webhook

每次余额变动都会记录到配置文件夹中的 logs/transactions-YYYY-MM-DD.log，并保留 transaction_log.retention_days 天（默认 7）。设置为超过 90 天时，启动时会在控制台发出警告。

在 webhook.json 中启用 webhook_enabled，还可将每笔交易 POST 到兼容 Discord 的 Webhook；使用 webhook_min_amount 仅通知金额较大的交易。

开发者 API

常规版 EconomyCraft JAR 已包含供其他服务端模组使用的 API v1，无需另外安装运行时 API 模组。该 API 涵盖余额与付款、货币格式化、只读物品价格、排行榜数据以及余额变动事件。公共类位于 com.reazip.economycraft.api.v1。

有关设置、示例和完整参考，请参阅 开发者 API Wiki。