KMarket

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

KMarket 是一个服务器权威的经济与市场模组，适用于使用 Fabric 的 Minecraft Java Edition 26.1.2。

它提供了可配置的服务器商店、安全的玩家市场、即时物品出售、持久化余额，以及透明的社区金库。

特性

可配置的购买、出售和玩家市场价格
支持原版和模组物品
容错式商店搜索
通过 /sell 即时出售
附魔物品价格加成最高可达 70%
支持附魔书
玩家上架时完整保留 ItemStack 组件
持久化的玩家余额、上架、领取和交易历史
玩家付款与捐赠
市场税收汇入服务器资金
由所有者控制的资金支付与调整
大额金额的紧凑显示格式
自动检测未配置的物品
原子化 JSON 保存并自动备份
安全的服务器端交易验证
防止重复购买、溢出和负余额

运行要求

Minecraft Java Edition 26.1.2
Fabric Loader 0.19.3 或更高版本
适用于 Minecraft 26.1.2 的 Fabric API
Java 25

KMarket 使用原版物品栏界面，主要设计为服务端模组。玩家仍需要安装服务器整合包中使用的任何内容模组。

价格、分类、所有者、交易限制、税率和其他设置可在 config/kmarket 下配置。模组物品通过其注册 ID 支持；不可用的物品会被安全地忽略。

安装步骤

为 Minecraft 26.1.2 安装 Fabric Loader。
安装对应的 Fabric API。
将 kmarket-1.0.0.jar 放入服务器的 mods 文件夹。
启动服务器一次以生成 config/kmarket。
在编辑生成的配置前先停止服务器。
将所有者 UUID 添加到 config/kmarket/owners.json。
在 config/kmarket/prices/ 内配置价格。
重启服务器，或在修改价格后使用 /kmarket reload。

owners.json 示例：

{
  "owners": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

所有者还必须拥有 Minecraft 权限级别 4。专用服务器控制台会自动获得授权。

KMarket 会自动将未知的已注册物品放入：

config/kmarket/unconfigured.json

物品必须先被启用并配置价格，才会出现在商店中。模组物品使用其完整的注册 ID，例如 examplemod:item_name。

玩家命令

/market — 打开玩家市场
/market sell <数量> — 上架手持物品的多个副本
/market mine — 查看和管理你的上架
/market cancel <上架-UUID> — 取消一个上架
/market claim — 领取退回或过期的物品
/market notifications — 查看市场通知
/shop — 打开服务器商店
/shop search <文本> — 使用容错搜索
/shop buy <注册-ID> <数量> — 购买一件物品
/shop sell <注册-ID> <数量> — 出售一件物品
/sell — 立即出售一件手持物品
/sell <数量> — 立即出售指定数量的物品
/sell all — 立即出售所有匹配的手持物品
/balance — 显示你的余额
/balance <玩家> — 显示在线玩家的余额
/pay <玩家> <金额> — 向另一名玩家转账
/donate <玩家> <金额> — 向另一名玩家捐赠金钱
/serverfund — 显示公共社区金库余额

所有者命令

这些命令需要权限级别 4 以及 owners.json 中列出的 UUID。

/kmarket reload — 验证并重新加载配置
/serverfund pay <玩家> <金额> — 使用现有金库资金向玩家付款
/serverfund add <金额> — 添加一项经审计的金库修正
/serverfund remove <金额> — 移除一项经审计的金库修正
/serverfund history — 查看最近的税收和金库交易记录
/vaultgrant status — 验证所有者授权
/vaultgrant money add <玩家> <金额> — 增加金钱
/vaultgrant money set <玩家> <金额> — 设置余额
/vaultgrant money remove <玩家> <金额> — 移除金钱

每笔金库交易都会经过审计。金库付款从已收取资金中扣除，而不是自动生成额外的金钱。