跳到主要内容

安装与首次查看价值

这篇文档对应的使用场景是：

  • 你第一次安装 One Enough Value
  • 你想先确认模组是否正常工作
  • 你暂时不打算写脚本，只想先看到价值提示

前言​

本模组本身并不直接提供兑换台、转化桌或商店界面，它提供的是一个“物品价值底层”。

也就是说，它的主要职责是回答一件事：某个物品现在值多少钱。

安装方式​

单人游戏​

将 One Enough Value 与 KubeJS 一起放入 mods 文件夹。

局域网或服务器​

价值在服务端计算，并通过网络包同步到客户端。

因此更稳妥的做法是：

  • 服务端安装 One Enough Value 与 KubeJS
  • 客户端也安装 One Enough Value 与 KubeJS

这样可以保证：

  • 模组端逻辑完整加载
  • 客户端能正确显示同步后的价值
  • 之后如果你扩展脚本联动，也不会遇到环境不一致问题

进游戏后如何确认模组已经生效​

本模组默认会在物品 Tooltip 中显示价值，但有两个前提：

  • 客户端配置没有关闭默认 Tooltip
  • 你已经开启了高级提示

开启高级提示​

在游戏内按 F3 + H。

这是 Minecraft 自带的高级 Tooltip 开关。One Enough Value 只会在高级提示启用时追加价值文本。

观察提示文本​

将鼠标悬停在有价值的物品上。

如果该物品最终价值大于 0，你会看到类似下面的提示：

该物品价值: 256 $

如果没有显示，先不要急着判断脚本或模组坏了，优先确认以下几项：

  • 当前物品是否真的有价值
  • 是否已经按了 F3 + H
  • 客户端配置项 addValueTooltip 是否仍为 true
  • 你是否刚进服，还没完成同步

价值显示来自哪里​

这点对排错很重要。

客户端显示的不是本地临时计算结果，而是服务端计算后的同步结果。

当前流程是：

  1. 服务端加载配方、标签和脚本。
  2. 服务端计算基础价值、配方生成价值和附加价值。
  3. 玩家加入服务器，或执行 /reload 后，服务端把结果同步给客户端。
  4. 客户端在 Tooltip 中读取同步后的价值表。

这意味着：

  • 如果服务端脚本没生效，客户端一定也不会显示正确数值。
  • 如果你改了 KubeJS 脚本，通常需要 /reload 才能刷新价值。

客户端配置项​

本模组当前提供一个客户端配置：

  • addValueTooltip = true

作用是控制是否添加默认价值 Tooltip。

适用场景：

  • 保持默认显示方式：保持为 true
  • 你想自己做 JEI、REI、TOP 或自定义 HUD 显示：可以关掉它

建议的首次验证步骤​

第一次装好模组后，可以按下面步骤确认运行正常：

  1. 启动游戏并进入世界。
  2. 按 F3 + H 开启高级提示。
  3. 查看一些明显应该有默认价值的物品，例如铁锭、金锭、钻石之类。
  4. 如果能看到价值，说明默认数据、服务端计算和客户端显示链路都正常。
  5. 再进入下一步文档，开始自定义价值。