RptMerchant —— 全局村民 & 流浪商人交易调整 · 内置原版商品池 · 全 GUI 编辑 [1.21 ~ 26.2]

原创 付费 工具 世界管理 RptMerchant —— 全局村民 & 流浪商人交易调整 · 内置原版商品池 · 全 GUI 编辑 [1.21 ~ 26.2] 1.0.0

请登录后获取
概述 历史版本 讨论区
版权类型
原创
插件中文名称
RPT商人
插件英文名称
RptMerchant
原帖地址
#
支持的核心（服务端）
  1. Paper
  2. Folia
语言支持
中文（简体）
适配版本（Java）
  1. 26.x
  2. 1.21

关于这个插件​

RptMerchant 是一个服务端侧的全局交易表编辑器。
原版村民的交易是"职业决定卖什么、每级随机抽两条"，流浪商人更是每次随机 —— 想改动只能改服务端数据包（而且 1.21.x 的交易根本不在数据包里，是写死在代码里的）。RptMerchant 把这件事变成可视化编辑：
  • 全局生效：装着就管全服的村民和流浪商人，不需要转化任何实体；
  • 默认 = 原版：内置的商品池是从官方数据 1:1 导出的原版内容（村民 288 条 + 流浪商人 97 条），不是空表、也不用你自己抄；
  • 想改就改：增删条目、改收购/出售物品与数量、调出现几率、调等级门槛，改完保存即生效。

功能说明​

1. 全局生效，不需要转化实体​

插件的定位是"调整全服交易"，所以：
  • 装上一个 trades.yml 就对所有村民和流浪商人生效；
  • 不接管无业村民（原版本来就不给它交易，跳过它同时也避开了原版的一个已知问题）；
  • 没写进配置、或 enabled: false 的职业 → 完全不碰，该职业走原版。

2. 村民：职业 → 等级 → 商品池​

  • 覆盖 13 个职业（盔甲匠 / 屠夫 / 制图师 / 牧师 / 农民 / 渔夫 / 制箭师 / 皮匠 / 图书管理员 / 石匠 / 牧羊人 / 工具匠 / 武器匠）。
  • 每个职业分 1~5 级（新手 / 学徒 / 老手 / 专家 / 大师），每级一个独立商品池 —— 和原版一致：村民到几级就解锁到几级，升级时只追加该级的内容，已有的交易不动。
  • 每个池子可配 pick（这一级抽几条），默认 2（= 原版）。

3. 流浪商人：三组池子​

原版流浪商人的交易是"buying / uncommon / common 三组各抽各的"，插件保留这个结构：

组原版抽取条数
buying2
uncommon2
common5
每组可单独配条数与内容。

4. 单条交易能改什么​

字段说明
weight★ 抽中权重 —— 同一个池子里越大越容易被抽到；全部相等（=1）时就是原版等概率
wants玩家要给的，1~2 项（第二项 = 原版的双物品买价）
gives玩家拿到的
max-uses补货前最多交易几次（原版默认 4）
xp★ 村民能获得的升级经验（原版默认 1）—— 调小会让村民升得慢，调 0 等于这条交易不给经验
reputation-discount原版 reputation_discount，价格浮动倍率
variant只在指定群系的村民身上出现（如制图师的探索地图按群系分）
enchant-random给产出物品随机附魔（原版那批"随机附魔装备/附魔书"）

5. 游戏内编辑器​

/rptmc 打开，层层点进去：
代码： 
主菜单（13 个职业 + 流浪商人）
  └─ 等级（1~5）/ 流浪商人的三组
        └─ 商品池（每页 36 条，带翻页）
              └─ 单条编辑（权重 / 买价①② / 产出 / 上限次数 / 经验 / 倍率 / 随机附魔 …）
                    └─ 物品选择器（从背包点选 · 左键=该格数量 · 右键=只取 1 个）
​
  • 商品池里 Shift+左键 删条目、「新增交易」加条目、底栏可直接调 pick；
  • 页码会记住：进条目编辑、进选择器、返回都不会跳回第一页。

6. 物品写法与中文名​

  • item 支持原版物品 id，也支持 CraftEngine 自定义物品（写 ce:命名空间/路径）；
  • 数量可写固定值，也可写区间（如 amount: '1-3'，每次随机）；
  • 支持 name / lore（MiniMessage 富文本）/ enchantments / custom-model-data / unbreakable；
  • ★ 中文物品名是插件内置的（官方 zh_cn 数据 3036 条），不依赖客户端语言 —— 界面里显示的就是"1 个 绿宝石"，不会出现 minecraft:emerald。

7. 管理员功能​

命令权限说明
/rptmc（不带参数）/ editrptmc.edit打开交易表编辑器
/rptmc list [职业]rptmc.info查看全局交易表（含权重 / 等级 / 候选条数）
/rptmc inforptmc.info准星对准商人，看它当前实际的交易与接管状态
/rptmc preview <职业> <等级>rptmc.info按权重预演 20 次，看每条命中次数 —— 验证权重配得对不对
/rptmc apply [半径]rptmc.admin把当前配置刷到附近已加载的商人（默认 16 格）
/rptmc reloadrptmc.admin重载 config.yml 与 trades.yml
/rptmc help免权限显示指令帮助

支持版本与环境​

项目说明
Minecraft 版本1.21 ~ 26.2（同一个 jar 跨版本，字节码目标 Java 21）
服务端核心Paper、Folia（已声明 folia-supported: true）
Java 运行环境Java 21 及以上
前置插件无。不依赖 Vault、不依赖 PlaceholderAPI、不依赖经济插件
可选前置CraftEngine —— 只有你想用 ce: 自定义物品时才需要
数据库不需要。只生成 config.yml 与 trades.yml
关于内置商品池的版本口径（重要，请先看）：
内置的默认商品池是从 26.2 的官方数据导出的（村民 288 条 + 流浪商人 97 条）。
1.21.x 的村民交易是写死在服务端代码里的、官方没有提供可导出的数据文件，
因此在 1.21.x 上，某些条目可能与"该版本原版"存在数值或用有无差异
（例如盔甲匠 1 级：1.21.x 原版有「15 煤炭 → 绿宝石」，26.x 的官方数据里没有这条）。
功能完全可用，你可以在编辑器里按自己想要的数值改；如果你要的是"和某个具体版本的原版逐条一致"，请以该版本实际表现为准来微调。
点击展开...

目标用户​

  • RPG / 生存服服主 —— 想自己设计经济链（固定收购、固定出售、自定义货币物品），不想被原版交易表绑住。
  • 做活动 / 随机商店的服主 —— 流浪商人换个池子就是一台活动商人。
  • 正在用 Folia 核心的服主 —— 事件挂钩全在实体所属区域线程，文件读写走独立线程。
  • 想把它当"付费权益"的服主 —— 权限默认只给 OP，普通玩家要被授权才能编辑。

是否付费​

付费插件。 具体定价与授权方式以资源页「售价」项为准。
  • 插件不含任何联网校验、授权服务器或机器绑定，购买后安装即用，离线环境照常运行。
  • 不区分免费版 / 高级版，买到的就是完整功能（全局村民表 + 流浪商人三组 + 游戏内编辑器 + CraftEngine 物品支持）。
  • 插件未做任何混淆，欢迎安全审查。

获取作者帮助​

途径内容
交流群QQ 群 1124248111
作者 QQ2221899680
游戏内输入 /rptmc help 查看全部指令与说明

使用教程​

安装​

  1. 把 RptMerchant-1.0.0.jar 放进服务端 plugins/ 目录。
  2. 重启服务端（换 jar / 新装插件不支持热加载）。
  3. 首次启动会生成 plugins/RptMerchant/config.yml 与 trades.yml（后者已内置完整原版商品池）。
  4. 改完 trades.yml 执行 /rptmc reload 生效，不需要重启服务端。
开箱状态：trades.yml 里 13 个职业 + 流浪商人三组默认都是 enabled: true、内容就是原版。
也就是说装上之后交易内容和原版一致，你在编辑器里改什么就变什么。
点击展开...

快速上手（4 步）​

  1. /rptmc 打开编辑器 → 看到 13 个职业 + 流浪商人；
  2. 点「农民」→ 点「1 级 新手」→ 进入该级商品池（能看到原版那几条）；
  3. 点某一条 → 改权重 / 换买价 / 换产出 → 点「保存并重载」；
  4. 回到游戏里靠近一只农民村民，用 /rptmc preview FARMER 1 看权重效果，或直接 /rptmc apply 16 刷到它身上。

指令列表​

指令
权限​
说明
/rptmc / /rptmc editrptmc.edit打开交易表编辑器
/rptmc list [职业]rptmc.info查看全局交易表
/rptmc inforptmc.info查看准星目标商人的实际交易
/rptmc preview <职业> <等级>rptmc.info按权重预演 20 次
/rptmc apply [半径]rptmc.admin把配置刷到附近商人（默认 16 格）
/rptmc reloadrptmc.admin重载配置
/rptmc help免权限显示指令帮助
主指令为 /rptmc，别名 /rptmerchant。
点击展开...

权限节点​

默认口径：普通玩家默认没有任何功能权限；OP 默认全部拥有（服主开箱即用）。
要给普通玩家开放，用权限插件逐个授予即可，例如 LuckPerms：
/lp user <玩家> permission set rptmc.edit true
点击展开...
权限默认值说明
rptmc.use仅 OP使用基础功能
rptmc.info仅 OPlist / info / preview
rptmc.edit仅 OP打开编辑器
rptmc.admin仅 OPreload / apply

主要配置项（config.yml）​

配置项默认值说明
villagers.enabledtrue村民总开关（关掉 = 完全不碰，走原版）
villagers.freeze-villagersfalse兜底开关：把受管村民的 AI 关掉（原版已知问题变通方法）
wandering-trader.enabledtrue流浪商人总开关
editor.reload-after-savetrue编辑器保存后自动 reload，并刷附近 48 格的商人
editor.default-max-uses / default-xp16 / 5新增交易时的默认值

常见问题​

  • 装完交易和原版一样？ 是的 —— 默认商品池就是原版内容，插件只在你改动之后才产生差异。想彻底不碰：villagers.enabled: false。
  • 改完配置，世界里的村民怎么没变？ 设计如此：改配置只影响之后新生成 / 升级的村民，不会去动已经存在的（避免一改配置就把全服库存清空）。要立刻生效用 /rptmc apply [半径]（注意：会重置那些商人的已交易次数）。
  • weight 怎么理解？ 同一个池子里按权重抽 pick 条。全填 1 就是原版等概率；把某条调到 10、其余 1，它就明显更容易出现。
  • 村民升级变慢了 / 不升级了？ 检查那条交易的 xp —— 村民的经验完全来自这里，xp: 0 等于这笔交易不给升级经验。
  • 无业村民为什么不能被接管？ 原版本来就不给无业村民交易，硬塞交易会触发原版的一个已知问题（交易界面一闪就关）。所以插件直接跳过它们；给它一个工作站点让它就职后就会正常受管。
  • 保存之后我的注释没了？ 编辑器保存是整文件重写，会换成插件生成的注释头；旧文件已自动备份为 trades.yml.bak。想保留自己的注释就手改文件、然后 /rptmc reload。
  • 用了 CraftEngine 物品但没生效？ item 要写成 ce:命名空间/路径（例如 ce:stardew/crop_potato）。插件不会把 CraftEngine 当强制前置：没装时不会报错、也不会加载失败，只是那些条目用不了。
  • 换 jar 要重启吗？ 要。换 jar 必须重启；改配置不用，/rptmc reload 即可。
  • 配置里写了本服务端没有的物品会怎样？ 那一条不会生效、也不会出现在编辑器里，但保留在文件里（换回对应版本的核心后自动恢复），控制台会有一条汇总提示。

声明​

  • 本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合进服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
  • 本插件未使用任何混淆手段，欢迎安全审查。
  • 本插件不含任何后门、病毒或远程控制代码，不含任何联网校验，所有配置仅保存在服务器本地 plugins/RptMerchant/ 目录中。
  • 本插件不会主动给予任何物品，也不修改玩家的背包与经验，只改写村民与流浪商人的交易表。
PixelCloud 一键开服
作者
RPT
查看
69
首次发布
最后更新

评分

0.00 星 0 次评分
参与讨论

RPT 的其他资源

分享资源

旋律云高性能云服务器
后退
顶部 底部