钱币学宝库

钱币宝库（Numismatics Treasury）

概述

钱币宝库是适用于 NeoForge 1.21.1 的钱币学（Numismatics）附属模组，通过直接转账、可配置商店、玩家自有商店以及全球拍卖行来扩展其银行系统。

所有交易都直接使用钱币学的银行账户。玩家无需携带实体硬币或在购买、出售、竞拍或转账前手动兑换货币。

该模组包含英文文本以及完整的法语翻译。

包含内容

• 通过 /pay 命令进行直接银行转账
• 拍卖行
• 转账出纳员方块
• 便携式转账终端
• 管理员管理的服务器商店
• 玩家商店

功能特性

银行转账

可通过以下方式在钱币学银行账户之间直接转账：

• /pay <玩家> <金额> 命令
• 转账出纳员方块
• 便携式转账终端

已知的玩家名称可以自动补全，包括已拥有钱币学账户的离线玩家。

服务器商店

服务器商店由管理员控制，使用无限的服务器库存和资金。

管理员可以配置：

• 展示的物品
• 交易类型
• 单价

服务器商店可以向玩家出售物品，或从玩家处收购物品。款项会直接从玩家的银行账户中扣除或存入其中。

服务器商店没有合成配方，旨在由服务器管理员分发。

玩家商店

玩家商店允许玩家出售一种配置好的物品。

每个商店提供：

• 一个无限容量的库存槽位
• 可配置的单价
• 直接支付至店主银行账户
• 通过漏斗/输送管及兼容的传输系统自动插入物品
• 仅接受配置物品的过滤器

只有店主或服务器管理员可以配置或破坏商店。玩家商店在其库存清空之前无法被破坏。

全球拍卖行

每个拍卖行方块都会打开同一个服务器范围内的市场。

玩家可以：

• 创建直接出售的列表
• 创建限时拍卖
• 浏览所有玩家的列表
• 使用银行余额出价
• 管理自己的活跃列表
• 从“领取”页面收取待领取的物品

拍卖出价会安全保留直至拍卖结束。出价被超过的玩家会获得退款，而获胜者的付款将在扣除可配置的佣金后转移。

购买的物品会尽可能直接放入玩家的物品栏中。无法安全送达的物品将保留在“领取”页面中。

玩家可以收到有关购买、出价、被超价、售出和列表完成的通知，包括离线时存储的通知。

可配置模块（配置文件）

每个主要功能都可以独立启用或禁用：

• /pay
• 转账出纳员
• 便携式转账终端
• 服务器商店
• 玩家商店
• 拍卖行

当某个方块模块被禁用时，其合成配方会在服务器重载后被移除，已放置的方块也会变为非活动状态。

配置

服务器配置文件存储于：

config/numismatics_treasury.json

该文件在服务器首次启动时自动生成。只需在服务器端编辑；相关设置会与连接的客户端同步。

无需重启服务器即可应用更改，使用以下命令：

/numismatics_treasury reload

此命令需要管理员权限。

模块设置

modules 部分控制哪些功能可用：

"modules": {
  "payCommand": true,
  "bankTeller": true,
  "portableTransferTerminal": true,
  "serverShop": true,
  "playerShop": true,
  "auctionHouse": true
}

将值设置为 false 即可禁用该模块。

付款限额

pay 部分定义了单次转账允许的最低和最高金额：

"pay": {
  "minimum": 1,
  "maximum": 2000000000
}

拍卖行设置

auctionHouse 部分控制市场限制和费用：

"auctionHouse": {
  "commissionPercent": 5.0,
  "maximumListingsPerPlayer": 20,
  "minimumPrice": 1,
  "maximumPrice": 2000000000,
  "allowedDurationsHours": [
    1,
    6,
    12,
    24,
    48
  ]
}

• commissionPercent：从完成的交易中扣除的百分比
• maximumListingsPerPlayer：每位玩家同时拥有的最大列表数量
• minimumPrice：可接受的最低价格或出价
• maximumPrice：可接受的最高价格或出价
• allowedDurationsHours：界面中可用的列表持续时间

需求

• Minecraft 1.21.1
• 适用于 Minecraft 1.21.1 的 NeoForge 21.1.242 或更高版本
• 钱币学（Numismatics）1.0.20 或更高版本

钱币学是钱币宝库声明的唯一模组依赖项。