万的生物扫描仪

万的生物扫描仪

对准活物它就能告诉你那是什么！猪、树苗，或是你昨天安装的模组里的Boss，按住右键即可读取。它自带原版知识，任何模组或整合包只需一个JSON文件就能教会它其余内容！

万的生物扫描仪预览查看大图

这个 Mod 是什么？

一个物品，以及一种让所有其他人接入它的方式。

作为玩家使用它：一个野外扫描器，可以读取生命值、生长状态、繁殖计时器、主人、变种，以及游戏自己保留的那些数字。作为整合包作者使用它：写下你的生物应该显示的内容，随整合包一起发布，无需 Java。
图片 它是为我们自己的 Mod 《The Ravenous》 而诞生的，起初它只能读取我们自己的生物。现在它可以读取任何人的生物。

版本 1.0.0 (2026年8月25日)

🔭 扫描器

按住右键并透过镜片观察，就像使用望远镜一样。当你观察时，你手持的物品会消失：你是在透过它来观察。

  • 射程可达 15 格。它不能穿透墙壁读取。
  • 扫描所需时间取决于距离：5 格内需要 2.5 秒，10 格内需要 3.5 秒，15 格内需要 4.5 秒。射程是一种选择，而不是免费的升级。
  • 它会忽略画、物品展示框、盔甲架、矿车、船、末影水晶和掉落物，并读取它们后面的东西。
  • 由铁、红石、钻石和一个回声定位器官合成。如果安装了 《The Ravenous》，则需要尖叫者的器官；如果没有安装，则需要回声碎片。你不需要选择，正确的配方会自动启用。

🐾 开箱即用能读取什么

  • 任何生物，原版的或 Mod 的： 名称、生命值、速度、跳跃高度、护甲、攻击伤害，以及它是被动型、中立型还是敌对型，如果中立型生物此时正处于愤怒状态。幼年生物长大所需的时间。繁殖冷却时间。它能否被装上鞍或携带箱子。它的主人。它的变种，精确到熊猫拥有哪两个基因。
  • 植物和活方块： 生长阶段、该位置的光照等级、该光照是否足以生长，以及一次生长尝试大约需要多长时间。174 个方块，包括树叶、草方块、菌丝、苔藓、珊瑚（活的或死的）、幽匿块、蜂巢、海龟蛋、嗅探兽蛋、青蛙卵、紫水晶、竹子、海带和蘑菇。

🧠 它会记住

第一头猪需要的时间一如既往。此后的每一头猪读取时间都只需三分之一。

等待时间的存在是为了让你第一次遇到某物时，射程能成为一个真正的决定，而不是让你为了第一千头猪再坐等一遍。三分之一的时间保留了仪式感，同时去掉了排队等待。它记住的是物种，而不是个体，并且记录在你死亡后依然保留。

🌱 进化分支

如果你所查看的东西会变成其他东西，扫描完成时，整个进化线会出现在屏幕顶部：图形，箭头，图形。

在任何一步的上方，可能有 对勾、叉号，或者对于需要你培育的生物来说什么都没有显示，这样你就能一眼看出进展如何。你喂过的一个阶段，你错过的一个阶段，尚未轮到的一个阶段。

这些图形属于各个生物的主人，所以每个 Mod 都会带来自己的一套图形。

⚙️ 命令

/bioscanner speed <n> — 乘以扫描所需的时间。1 是默认值，0.5 将等待时间减半，0 则瞬间读取。权限等级 2。

🧩 对于整合包作者：一个 JSON 文件

将其放置在 data/<你的命名空间>/bioscanner/schede/<名称>.json：

{
  "bersaglio": "minecraft:pig",
  "righe": [
    "A pig. It has no idea what is coming.",
    { "etichetta": "Health", "valore": "vita" }
  ]
}
  • 适用于实体和方块。
  • 有七个你可以请求的值，它们会被朗读出来：生命值、最大生命值、速度、护甲、伤害、跳跃、名称。这个列表是刻意封闭的，开放的 NBT 路径会更强大但不可用，因为你需要知道生物内部字段的名称，而那在任何地方都没有记载。
  • 一个无法在该目标上读取的值会跳过它的那一行并保留其他行。为没有护甲的生物编写的卡片不能让其生命值也消失。
  • 有拼写错误的卡片不会阻止其他卡片加载，它会随文件名一起进入日志。
  • /reload 命令就足够了。卡片会自动到达客户端，所以这在专用服务器上也能工作。

🛠️ 对于 Mod 作者：读取器

当需要计算要显示的内容时——倒计时、变化的状态——文件就不够用了。在你的 Mod 构造函数中注册一个读取器，并且只为你自己的内容负责。

  • 返回一个空列表意味着"不是我的"，这是你必须做的。每个读取器都会看到玩家所查看的一切，而其中几乎没有什么与它相关。如果你还是回答了，就会占掉你下面所有读取器的机会。
  • 优先级：Mod 优先发言，然后是数据包卡片，最后是内置读取器。特意编写的描述永远不会被通用描述压下去。
  • 你也可以声明一个进化分支，并为它注册你自己的精灵图。

两个扩展点都有完整的文档说明：字段、优先级、完整的值列表、可用的示例，都在下方链接的完整更新日志中。

ℹ️ 须知

  • 客户端和服务器端都需要安装：数据保存在服务器端，屏幕绘制在客户端。
  • 《The Ravenous》3.0 及以上版本需要此 Mod。 如果你玩《The Ravenous》，请两个都安装。
  • 从拆分前的《The Ravenous》3.0 升级过来？你的扫描器是安全的。 物品改了名字，而 Minecraft 通常会在世界加载时删除旧物品，这个 Mod 会告诉游戏它们是同一个东西。

🥚 里面还藏着什么东西，等着被某人发现。

阅读完整更新日志：https://drive.google.com/file/d/19Cp57RDkl9zFla7h9uN6B2bl5P7m26_0/view?usp=sharing

图片