Kobase Traders
随心定制的商人:任意外观(生物、玩家皮肤或村民)、自定义交易、商店区域、路线和营业时间——全部在游戏内用商人魔杖设置。
概览
用商人魔杖在任何地方放置商人,并在带有四个标签页——外观、交易、行为和预设——的编辑器中设置。右侧的 3D 预览会旋转显示;每次修改都会立即显示在预览和世界中的商人身上。
交易在 Minecraft 原版的交易界面中进行:付款、Shift 点击和背包已满时的表现与村民完全相同。
任意外观
原版和模组中的任意生物(带搜索和实时预览,许多动物可选颜色和变种)、按名字或 UUID 指定的玩家皮肤,或带有生物群系、职业和徽章的村民。另可设置大小 0.5–2、名字和头衔行。
自定义交易
价格、第二价格和商品可自由选择——包括数量和 NBT(附魔、名称)。每项交易可设置库存或无限、商人经验、价格系数、需求、特殊价格和交易等级。
补货与等级
库存可以不补货、每天在指定时间补货、每 n 分钟补货,或像村民一样补货。还可以让交易随等级逐步解锁。
行为
站在原地注视玩家、在家周围的区域内走动,或沿着路径点组成的路线行走(循环或往返,可设置停留)。
营业时间
从–到,也可以跨越午夜。营业时间外商人会显示“已关门 · 08:00 开门”,回家,或回家睡觉。最多 4 行的问候语可显示为卡片、聊天消息或两者。
预设与模板
将自己的预设保存、加载并以 JSON 分享。自带职能模板:铁匠、面包师、农民、图书管理员、制图师、银行、珠宝商、动物商人、流浪商人组合和 Kobase Shop。
服务器友好
无敌且不会消失(可设置),无法被推动。服务器会检查每项输入:权限、上限、物品和模型禁用列表、NBT 大小。
图片








操作
| 操作 | 效果 |
|---|---|
| 手持商人魔杖右键方块 | 放置新商人并打开编辑器(需要权限) |
| 手持魔杖 潜行 + 右键商人 | 打开编辑器 |
| 右键商人 | 交易 |
| 编辑器 → 行为 → 路线 → 录制 | 编辑器关闭;右键方块添加路径点,潜行 + 对空气右键结束录制 |
| 编辑器 → 行为 → 家 用魔杖 | 下一个点击的方块成为家的位置 |
| 编辑器:应用 / 完成 / 取消 | 发送到服务器 / 发送并关闭 / 放弃更改 |
谁可以放置和编辑商人由服务器决定(默认为管理员和创造模式玩家;放置商人的玩家始终可以编辑它)。无敌商人只能在编辑器中或用 /kill 移除。
物品与配方

放置商人并打开编辑器
配方

铁锭放在右上角,两根木棍沿对角线放在下方。工作台 · 由游戏材质渲染
设置
所有选项都可以在游戏内修改:Mods → Kobase Traders → Config(通过 Kobase Core)。服务器选项对所有玩家生效;客户端选项由每位玩家自行设置——标记为可锁定的选项可由服务器为所有人固定。
| 选项 | 说明 | 默认值 |
|---|---|---|
谁可以编辑商人permissions.editSERVER | 管理员:仅限管理员。创造模式:管理员和创造模式下的玩家。 | 创造模式 管理员 / 创造模式 |
主人可编辑permissions.allowOwnerEditSERVER | 创建商人的玩家始终可以编辑它。 | 开 |
谁可以创建商人permissions.spawnSERVER | 管理员、创造模式(管理员 + 创造模式玩家)或所有人。 | 创造模式 管理员 / 创造模式 / 所有人 |
每位玩家的商人数spawn.maxPerPlayerSERVER | 一名非管理员玩家最多可拥有多少个商人(0 = 无限)。 | 0 范围 0 – 1000 |
初始模板spawn.defaultTemplateSERVER | 新创建商人所用的角色模板。 | 无(无交易) 无(无交易) / 铁匠 / 面包师 / 农民 / 图书管理员 / 制图师 / 银行 / 珠宝商 / 动物商人 / 流浪商人杂货 / Kobase Shop |
新商人无敌defaults.invulnerableSERVER | 只有 /kill 能移除它们。 | 开 |
新商人常驻defaults.persistentSERVER | 它们永远不会消失。 | 开 |
新商人可推动defaults.pushableSERVER | 玩家和生物可以推动它们。 | 关 |
默认补货方式restock.defaultModeSERVER | 从不、每天、按间隔或同村民(每天两次)。 | 同村民 从不 / 每天 / 间隔 / 同村民 |
补货间隔(分钟)restock.defaultMinutesSERVER | 间隔模式下两次补货之间的分钟数。 | 20 范围 1 – 1440 |
每日补货时刻restock.defaultHourSERVER | 每日补货的游戏内时刻(6 = 日出)。 | 6 范围 0 – 23 |
最大交易数limits.maxTradesSERVER | 每个商人最多的交易项数。 | 32 范围 1 – 128 |
最大 NBT 大小limits.maxNbtBytesSERVER | 交易物品或模型变种的最大 NBT(字节)。 | 8192 范围 256 – 262144 |
最大路径点数limits.maxWaypointsSERVER | 一条路线最多的路径点数。 | 32 范围 1 – 256 |
最大区域半径limits.maxRadiusSERVER | 商店区域的最大半径(格)。 | 32 范围 1 – 128 |
最大路线距离limits.maxRouteDistanceSERVER | 路径点与家之间的最大距离。 | 128 范围 8 – 1024 |
禁止的物品limits.itemDenySERVER | 不能出售的物品(ID 或 #tags)。 | minecraft:command_block, minecraft:chain_command_block, minecraft:repeating_command_block, minecraft:command_block_minecart, minecraft:structure_block, minecraft:structure_void, minecraft:jigsaw, minecraft:barrier, minecraft:light, minecraft:debug_stick, minecraft:spawner, minecraft:knowledge_book, minecraft:bedrock |
禁止的模型limits.appearanceDenySERVER | 不能用作商人模型的实体类型(或 modid:*)。 | minecraft:ender_dragon |
管理员无视禁止列表limits.opsBypassDenySERVER | 管理员可以使用被禁止的物品和模型。 | 开 |
允许刷怪蛋limits.allowSpawnEggsSERVER | 非管理员编辑者可以出售刷怪蛋。 | 关 |
显示头衔display.showTitlesCLIENT可锁定 | 在商人名称上方显示头衔行。 | 开 |
显示“打烊”牌display.showClosedSignCLIENT可锁定 | 在营业时间之外的商人上方显示。 | 开 |
问候卡片display.greetingCardCLIENT可锁定 | 在交易界面上方显示问候语。 | 开 |
名称显示距离display.nameRangeCLIENT可锁定 | 在此距离内显示商人名称。 | 24 范围 4 – 64 |
旋转预览editor.autoRotateCLIENT | 在编辑器中缓慢旋转模型。 | 开 |
兼容性
| Minecraft | 1.20.1 |
|---|---|
| 模组加载器 | Forge 47.2 及以上 |
| Kobase Core | 已包含在模组 jar 中(1.0.2 至 2.0.0(不含))——无需另外安装 |
| 安装 | 安装在服务器和所有客户端(两端使用同一个 jar,已内置 Kobase Core)。 |
| 整合包 | CJ_SimpleMod · Modpack D+J |
面向其他模组:API(de.kobase.traders.api.TraderApi)可以通过代码或 JSON 创建和配置商人并打开编辑器;TraderClientApi 将编辑器作为设计对话框提供。Kobase Traders 仍然是可选依赖。
版本
- v1.0.0 首个版本:外观自由的商人、自定义交易、补货、等级、区域、路线、营业时间、预设和职能模板;通过 Kobase Core 设置;支持 12 种语言。
- v1.0.1 翻译:模组及其设置的全部文本支持 13 种语言;内置 Kobase Core 1.0.3。
- v1.0.2 设置:在所有语言中补全了缺失的提示和名称。