元素:经济

元素:经济

一个适用于NeoForge 1.21.1的服务端经济系统,将你的货币与玩家商店、服务器商店和拍卖行关联起来。

Elements: Economy 1.0.2

Minecraft NeoForge Version Environment Type Source

一个面向 NeoForge 1.21.1 的服务端经济模组。它会识别你的服务器所使用的货币,并将其连接到你的商店和拍卖行,使一切使用同一种货币运行。之后当你更换货币时,一切都会随之切换。

可单独运行,也可与 Elements: Nexus 一同运行。需要 Elements: Vault。

特性

  • 货币检测: 自动识别支持的货币模组,或在管理员于聊天中选择时使用绿宝石等原版物品,或使用纯数字货币。货币始终以其自身的名称显示,例如“3 Block of Emerald, 5 Emerald”。
  • 玩家商店: 箱子与木桶的买卖商店,带有告示牌展示、所有者菜单、销售提醒、每日限额和按等级设置的商店数量上限。Create 的 Item Vault(物品保险库)可作为库存保险库链接。
  • 服务器商店: 通过 /shop 或从关联的村民、NPC 或方块打开的管理员商店。
  • 拍卖行: 一口价和竞价挂单、搜索、分类、销售税、黑名单和收取箱。可关联到 NPC、村民或方块。
  • 货币切换: 将余额、商店价格、收银台、挂单和收取箱转换为新货币,支持预览,并会先创建备份。
  • 迁移: 从 Impactor、Eights Economy、Wano Economy 及大多数货币模组导入余额,支持预览。
  • 与其他模组兼容: 为 Impactor、OctoEconomy、SDM、Spud's Shops 和 Easy NPC 提供桥接。若其他模组已运行商店或拍卖行,Economy 会关闭自身对应的功能。
  • 商店保护: 漏斗、活塞和 Create 机器无法从商店中窃取物品或破坏商店。
  • 主控制文件: 每个功能和命令在 features.toml 中都有独立开关。被关闭的内容完全不会被注册。
  • 私密交易: 购买永远不会被公开通告。/payments 显示你自己的历史记录。
  • 存储: JSON(默认)、YAML、SQLite 或 MySQL。

货币方案

货币之间为 1:1 换算:1 Emerald 价值 1 数字货币。同一货币内各物品之间的价值在 currency_values.toml 中设置。

仅使用数字货币。 无需安装任何东西。在 economy.toml 的 [digital] 下命名它:name、plural、symbol、decimals 和 icon。

使用货币模组。 安装它,Economy 会在启动时识别。其物品会以完整物品 ID 及其价值写入 currency_values.toml。

不使用货币模组。 管理员会在聊天中被询问选择数字货币还是原版物品。

  • 原版物品: 添加每个物品及其价值(例如 minecraft:emerald = 1,minecraft:emerald_block = 9),然后点击 [Confirm]。确认即为批准;它们将成为主货币。
  • /economy currency setup 可随时再次发起询问。

在游戏内更改价值 使用 /economy currency values([Change] / [Remove] / [+ Add item] 按钮),或编辑 currency_values.toml 并运行 /economy reload。

被移除的货币模组会从 currency_values.toml 中删除(会先备份旧文件)。

银行与 /exchange

使用物品货币时,玩家还可以将钱存入银行:

  • /exchange deposit [amount] [item] 将你携带的货币物品存入银行。
  • /exchange withdraw <amount> [item] 将其以物品形式取出,使用尽可能少的物品数量。
  • 添加完整物品 ID 以按该物品计算:/exchange deposit 2 minecraft:emerald_block。
  • 1:1:你的最小货币物品之一 = 一个数字货币。

命令

  • /bal [player]、/pay <player> <amount>、/pay toggle、/baltop、/payments
  • /exchange deposit | withdraw
  • /shop create buy | sell、/shop rename <name>、/shop remove、/shop
  • /ah、/ah link npc | villager | block、/ah unlink(管理员)
  • /eco give | take | set | reset <player> <amount>(管理员)
  • /economy reload | version | migrate | storage convert(管理员)
  • /economy currency setup | values | value | remove | switch(管理员)

权限

权限节点为 economy.<feature>.<action>,可与 Elements: Nexus 等级、其他权限模组或 OP 等级配合使用。商店和挂单数量上限可通过 economy.shop.limit 和 economy.ah.limit 按等级设置。完整列表。

输入价格

价格是以最小单位表示的一个数字。以 Emerald 1 / Block of Emerald 9 为例:

价格 输入
10 Emerald 10
2 Block of Emerald 18
3 Block of Emerald 5 Emerald 32
1,000 Emerald 1000 或 1k

k = 千,m = 百万。

须知

  • 仅使用原版箱子菜单,无需资源包。
  • messages.toml 在更新后会自动更新;你编辑过的行会被保留。开关:features.toml 中的 messages_auto_update。
  • messages.toml 和 currency_values.toml 在自动更改前会创建备份;仅保留最新的 2 个(economy.toml 中的 backups_kept)。
  • SQLite 和 MySQL 需要将其驱动 jar 放在 <server>/elements_economy/drivers 中(未包含)。

许可证

可免费用于任何整合包,付费或免费均可,需注明 Telmarine。不得单独作为付费产品转售或重新打包。


文件更新日志(1.0.2)

Elements: Economy 1.0.2

更改

  • Elements: Vault 现在是单独的下载项。 在 Economy 旁边安装 Elements: Vault 1.0.0 或更高版本;没有它 Economy 将无法启动。
  • 所有货币之间为 1:1。 economy.toml 中的 rates 仅在从数字货币转为实体货币(原版物品或货币模组的物品)时使用。

货币

  • 货币以服务器自身的货币名称显示,例如“3 Block of Emerald, 5 Emerald”。
  • 在聊天中设置: 当未找到货币模组时,管理员会被要求选择数字货币或原版物品。对于原版物品,添加每个物品及其价值,然后 [Confirm]。确认即为批准;它们将成为主货币。/economy currency setup 可随时再次发起询问。
  • currency_values.toml 由 Economy 填充,仅列出正在使用的内容:[values] 下每个完整物品 ID 一行,例如 "minecraft:emerald" = 1。被移除的货币模组会被删除(先备份)。旧文件会被转换,并保留你的价值设置。
  • 在游戏内编辑价值: /economy currency values([Change] / [Remove] 按钮)、/economy currency value <item> <value>、/economy currency remove <item>。
  • 重命名数字货币 在 economy.toml 的 [digital] 下:name、plural、symbol、icon。
  • economy.toml 中的 primary_currency 接受完整物品 ID,例如 "minecraft:emerald"。
  • 银行以服务器的货币物品显示,包括交易日志。开关:features.toml 中的 bank_as_coins。

修复

  • 缺少 /exchange。 /exchange deposit [amount] [item] 将你携带的货币物品存入银行;/exchange withdraw <amount> [item] 以尽可能少的物品数量取出。添加完整物品 ID 以按该物品计算,例如 /exchange deposit 2 minecraft:emerald_block。仅适用于玩家可以物品形式持有的货币。权限:economy.exchange.deposit、economy.exchange.withdraw。
  • 空余额显示货币名称,例如“0 Emerald”。
  • 交易日志显示货币名称而非内部 ID。

消息与文件

  • messages.toml 会自动更新: 未编辑的行获得新文本,添加新行,已编辑的行被保留。会先创建备份。开关:features.toml 中的 messages_auto_update。
  • 仅保留最新的 2 个备份 的 messages.toml 和 currency_values.toml(economy.toml 中的 backups_kept)。

升级

  • 将 Elements: Vault 的 jar 添加到 mods 文件夹。