交易洞察

仅服务端——原版客户端也能看到锁定交易预览和库存信息。无需安装客户端。

交易洞察（Trade Insight）让每个村民都变成一本打开的书。在你花掉第一颗绿宝石之前，就能看到村民在更高等级会解锁的交易、每项交易剩余的库存量，以及下次补货的实时倒计时——这一切都在一个纯净、未装模组的客户端上呈现，因为整个模组都运行在服务端。

为 Fabric 和 NeoForge 构建，支持 Minecraft 1.21.1，Java 21。

✨ 特性

📦 库存与补货信息——实时

每笔真实交易都会有描述文本，告诉你确切的状态：库存：剩余/最大，售罄时显示已售罄——等待补货，以及每村民一行今日补货 n/2，并附有诚实的时长估算——"下次：约 1 分 30 秒"，该倒计时在交易界面打开时实时更新，冷却结束后显示"可补货（工作时）"，两次当日补货用完后显示"今日已完成，明天再来"。库存数字会在你交易时实时更新，无需重新打开界面。流浪商人也会有库存描述。

📟 动作栏摘要

潜行 + 空手右键村民，即可在动作栏中看到一行信息——无需打开交易界面：

图书管理员 Lv.3 · 库存 5/7 · 补货 1/2（下次：约 1 分 12 秒）

🔒 锁定交易预览（可选——默认关闭）

启用 lockedTradePreview.enabled 后，交易界面还会显示灰色、锁定的交易行，对应村民在更高职业等级（新手 → 大师）会提供的交易。每一项都重命名为 [Lv.N] <物品>，并带有描述"在村民等级 N 时解锁"。预览行始终缺货——仅作信息展示，永远无法购买。附魔书预览会注明附魔和价格在解锁时随机生成；藏宝图交易则显示一个安全的占位符。

🔁 可选的自动补货

可选策略让村民自动补充交易：ON_DEPLETE 会在某笔交易售罄的瞬间立即补充（红色 X 会在打开的界面中实时消失），VANILLA_PLUS 则进行完全补货。默认为关闭 = 100% 原版行为。

🌐 每玩家语言（自动）

所有文本都在服务端按玩家自己的客户端语言生成——韩语客户端看到韩语，其他玩家看到英语（包含英语/韩语；可通过配置强制指定）。

⚙ 配置——config/tradeinsight.json

选项	默认值	作用
language	"auto"	auto / en / ko——自动跟随每位玩家的客户端语言
lockedTradePreview.enabled	false	显示锁定的更高等级预览行（可选）
lockedTradePreview.maxPerLevel	8	每个更高等级的最大预览行数（1–10）
stockInfo.enabled	true	每笔交易的库存描述，交易时实时更新
stockInfo.showRestockStatus	true	每村民的补货行，带"约 N 分 S 秒"估算
stockInfo.liveCountdownSeconds	1	实时倒计时的刷新频率（0 = 关闭）
actionBarSummary.enabled	true	潜行 + 空手的动作栏摘要
autoRestock.mode	"OFF"	OFF / ON_DEPLETE / VANILLA_PLUS
autoRestock.ignoreDailyLimit	false	绕过每日 2 次补货上限
autoRestock.updateDemand	false	补货时应用原版价格/需求更新
autoRestock.requireJobSite	true	仅在村民有已认领的工作站点时自动补货

命令：/tradeinsight reload 重新读取配置并清除预览缓存（权限等级 2）。损坏的 JSON 会安全地回退到默认值。

❓ 常见问题

与客户端模组兼容吗？
兼容。交易洞察只发送正常的服务端数据——字面意义上的物品名称和描述文本——因此原版和模组客户端都能使用，无需安装。

可以购买预览交易吗？
不可以。预览行始终缺货，仅作信息展示。

潜行右键村民不再打开交易界面了？
没错——潜行 + 空手会改为显示动作栏摘要。普通右键仍照常交易。可通过 actionBarSummary.enabled 禁用。

补货时间精确吗？
这是一个诚实的估算：原版村民每天最多补货两次，且仅在各自的工作站点工作时，并需经过 2 分钟冷却。倒计时显示的是冷却时间；实际补货发生在村民下次工作时。