Chest Radar

箱子雷达

箱子雷达会索引你打开过的每个箱子、木桶和放置在地上的潜影盒的内容，这样之后你就可以问“我把钻石放哪了”并真正得到答案：物品、数量、所在容器以及距离多远。

它也支持服务器自定义物品。带有自定义名称、描述和数据包附魔的物品会完全按照你客户端收到的样子记录，所以一把带有三行描述的§bVoid Sword可以用其中任何一个词搜到，而不只是“剑”。

整个功能完全在客户端运行。服务器上什么都不用装，不会发送任何数据包，你加入的服务器也不需要知道它的存在。模组只会记录你自己客户端已经看到你打开过的内容，这也是它的主要限制：你从未打开过的箱子，雷达就不知道。

只有真实方块会被索引。容器必须存在于世界中的具体坐标上才会被记录。末影箱、你自己的背包以及无方块的插件菜单被刻意排除在外，因为它们的内容并不在雷达会指引你前往的位置。

功能

• 打开容器即索引。 放置在世界中的箱子、木桶和潜影盒。无需命令、无需扫描、没有“索引我的基地”按钮。你正常游玩，索引会自动填充。
• 手持物品搜索。 手持物品时按下R，模组会在聊天栏报告范围内所有存有该物品的容器，附带坐标和距离。按住Shift则会扩大到该物品的所有变种，而非你手持的确切那一个。
• 搜索键在容器界面内同样有效。 它会关闭界面并对你光标下的物品、你正在拖拽的物品或你的主手物品依次执行搜索。你永远不必为了问剩下的东西在哪而把物品放回手上。聚焦的文本框优先，所以在铁砧上改名时仍然会输入一个r。
• 完整的雷达界面（G）列出你周围所有已索引的内容，可按名称、数量或距离筛选和排序，顶部显示物品数和容器数。
• 两种视图。 每行一个物品的列表，或带数量叠加的图标网格。用工具栏中的按钮切换。你的搜索文本在切换后保留。
• 左键点击带你前往。 它会关闭雷达，勾勒出容器轮廓并将你的视角转向它。右键点击可在不离开界面的情况下显示该物品所在的容器。中键点击可将其固定。
• 搜索语法 在搜索框中：多个词条、排除项、精确短语，以及附魔、物品 ID、描述、容器名称、种类、维度、数量、距离和时间的缀词。
• 容器高亮（ESP）。 搜索后，每个匹配的容器都会获得一个穿墙绘制的琥珀色线框盒，持续可配置的秒数。倒计时只在你关闭雷达后开始，而不是在你点击时。
• 高亮标签。 每个盒子都标注了容器名称以及其中存有多少所搜索的物品。正是这一点让一排八个一模一样的箱子变成一个答案，而不是八个盒子。
• 槽位高亮。 搜索后，打开容器会用脉动的琥珀色边框勾勒出存放你所寻找物品的确切槽位，包括内部嵌套着该物品的潜影盒或收纳袋。它有独立的持续时间设置，因为走到箱子那里可能比线框存活的时间更长。
• 指南针。 一旦你选定一个容器，一个方向箭头和剩余距离会一直显示在屏幕上，直到你到达。线框几秒后就会消失；而穿过你的基地的那段路通常不会。
• 注视预览。 瞄准一个模组已经见过的容器，其已知内容会出现在角落，按数量排序，并显示记录的时效，无需打开它。
• 每个提示框上都有“在你的箱子中”。 游戏中的任何物品在任何地方都会获得一行文字，告诉你总共拥有多少个。按住Shift还会显示容器数量和到最近一个的距离。默认关闭。
• 所有东西都有时效。 每条容器记录都带有“3 天前见过”。超过可配置的阈值（默认 7 天）后，该行会变灰。
• 自动清理。 路过一个已索引的位置，其区块已加载且该方块不再是容器时，记录会被删除。它只在确定时触发：未加载的区块读取为空气，和损坏的箱子完全一样，所以未加载的位置不会被处理。
• 以上所有功能的总开关。 “让模组自行整理”会同时关闭清理和过期处理，模组不再自行改动你的索引。
• 变更报告。 关闭一个模组已经知道的箱子时，它会在聊天栏说明自你上次访问以来发生了什么变化：+3 diamonds、-64 stone。默认情况下它会与你打开它那一刻的状态进行比较，所以你自己的转移不会被读回给你。关闭“忽略你自己的存入和取出”即可获得详尽的日志。
• 跨维度搜索。 从下界进行的搜索也可以返回你的主世界基地，水平距离按传送门规则换算。这些结果会标注维度，因为需要传送门的“100 米”和普通的 100 米不是一回事。
• 嵌套内容。 箱子中潜影盒和收纳袋里的物品会被计为那些物品，而不是一个不透明的潜影盒。装满铁的潜影盒计为铁。
• 批量数量读取。 在某些服务器上，单个物品代表数千个，真实数字写在其描述或菜单标题中。模组会读取那个数字，而不是计为 1。模式可配置。
• 服务器菜单。 某些服务器会以小型漏斗式菜单而非真正的箱子界面打开箱子。有一个设置可以记录这些。
• 固定。 中键点击物品可将其固定。无论当前排序如何，固定物品都会排到顶部，星标按钮可将视图筛选为仅显示它们。Shift + 中键点击可设置目标数量，会绘制进度条和一个1234 / 2000分数，达到时变为绿色。固定项保存在全局配置中，而非世界索引中，所以“我需要 6 组铁”在每个服务器上含义相同。
• 合成规划器。 对于你的配方书知道的任何配方，告诉你缺少什么以及该去哪些箱子搜刮其余部分。详情见下文。
• 收集路线。 将要访问的容器串联成一次行程，最近的优先，并用指南针引导你完成。详情见下文。
• 六个按键绑定，全部是普通的原版按键绑定，位于选项 → 控制中的箱子雷达分类下：搜索手持物品（R）、打开雷达（G）、打开设置、切换高亮、打开合成规划器、取消收集路线。后四个默认未绑定。
• 每个设置都有提示框解释它实际做什么，外加一个筛选框来查找。被其他设置关闭的设置会变灰并说明原因。
• 一切都是设置。 上面列出的每个功能都可以关闭。

搜索语法

搜索框接受多个词条。每个词条之间是 AND 关系。每个前缀接受英文和法文两种形式。

| 词条 | 匹配 |
|—|—|
| diamond | 自由文本：名称、物品 ID、附魔 ID，以及描述（如果该设置开启） |
| -pickaxe | 排除 |
| "void sword" | 精确短语，空格不再分割 |
| ench:sharpness | 按附魔 |
| id:iron_ingot | 按物品标识符 |
| lore:sold | 在描述中，无论描述设置是否开启 |
| in:base | 按容器名称 |
| kind:chest | 箱子、木桶或潜影盒 |
| dim:nether | 按维度 |
| >64 <10 | 按总数量 |
| m:32 | 32 格以内 |
| d:7 | 7 天内见过 |

附魔按标识符匹配（knockback、minecraft:sharpness、serverpack:radioactivity），绝不按本地化名称。搜索Recul不会找到击退物品。

前缀只有在是上述词语之一时才是运算符，所以minecraft:stone仍然是纯文本，仍然能找到石头。尚无值的运算符，比如你还在输入时的ench:，会被忽略，而不是匹配所有或什么都不匹配。

如果你服务器的物品名称字面上包含id:或前导连字符，请关闭搜索栏中的高级筛选。你会恢复旧行为：一个字面子串，不分割，无运算符。

合成规划器

打开你的背包、工作台或熔炉，窗口右下角下方会出现一个小规划标签页。或者在任何地方按下打开合成规划器按键绑定，无需工作台。

在原版配方书中选择一个配方，包括你当前无法合成的，该标签页会变成路线：它直接在该配方上打开规划器，无需输入。否则输入你想制作的东西，说明数量，你会得到类似这样的结果：

Rail                                        Crafting table · 2 crafts, 32 produced
  Iron ingot (+0)              x12    on you 4     chests 20  42m ↗
  Stick                        x2                              missing 2

• 随身是你的背包，箱子是搜索半径内你的索引，缺少是两者都不覆盖的部分。这三者被刻意分开：你携带的是现在可用的，箱子里的需要走一段路，缺少的需要一趟挖矿。
• 数量是搜索框旁边的框。输入数字，点击- / +，或在其上滚动。按住Shift时一步是一整组而非一次合成。数字计的是物品，不是合成次数：要 128 个铁轨，它会算出需要 8 次合成。
• 所需是配方乘以合成次数，向上取整。32 个铁轨是两次 16 的合成，所以是 12 个铁，而不是 6 个。
• 接受多种物品的原料（任意木板、任意原木）会全部加总，完全像工作台会做的那样。名称后的(+10)是该槽位还接受多少种其他物品。
• 左键点击一个原料可被带到存有它的最近容器，包含指南针和高亮。右键点击它可在该原料上重新规划面板，针对你缺少的数量。◀沿链条向上返回。递归是手动的，一次一步，因为有用的深度完全取决于你已经拥有什么。
• 合成、熔炼、切石和锻造配方都会被读取。熔炉燃料被刻意不计为原料，因为“任意燃料”不是该去某个特定箱子取的东西。
• 按 Escape 返回工作台，你的合成格不受影响。

配方来自你自己的配方书。自 1.21.2 起，客户端接收的是配方展示，而不是配方本身，因此规划器能准确知道配方书显示了什么：你在该世界中解锁的内容，包括服务器数据包添加的配方。

收集路线

分别回答“这个物品在哪儿”的五个答案，意味着你得在基地里来回跑三趟。路线会把它们合并成一趟：先去最近的容器，再去离它最近的下一个容器，每一站都会列出要在那里拿的物品。

• 在雷达界面中，路线按钮会根据你固定的目标生成路线。每个有目标数量的固定目标都会纳入路线target − what you already carry。没有目标数量的固定目标会被忽略，因为“我在关注这个”并没有说明要拿多少。
• 在合成规划器中，收集路线会根据缺少的材料生成路线，并跳过你物品栏里已有的物品。
• 指南针会指向当前站点，HUD 也会显示2/5 · Iron chest以及该站需要拿取的物品。抵达后会自动前往下一站。
• 如果发现某站的容器已经不在了，就会将它从行程中移除，而不会继续把它当作目的地。
• 其他维度的容器不会纳入路线，并会在聊天栏中显示跳过的数量。步行路线不会穿过传送门，而换算成传送门距离也无法说明实际绕路需要多久。
• 如果本维度中没有任何已索引的容器能提供某件物品，系统会明确报告，而不是悄悄跳过。超过路线最大站点数（默认为 8）的物品也会如此处理，因为列出四十个箱子的行程只是清单，不算路线。

路线按最近邻方式排序，而不是计算最短的完整行程：如果一条行程连你自己都无法预想，那在看得见的基地里走起来也很难让人放心。

Jade（可选）

如果安装了Jade，注视预览就不会再绘制自己的面板，而是把内容附加到 Jade 的提示框中：先显示记录的时间，再为每种物品显示一行，包含图标和数量。两者都在描述屏幕角落里的同一个方块，叠在一起只会互相碍事。

数据来源不会改变。它仍然来自你自己的索引，从内存读取，不会发送数据包，也不需要服务端安装 Jade。该提供程序以普通 Jade 插件的形式注册，因此也会显示在 Jade 自己的设置中，你可以在那里关闭它。在本模组中，对应的开关是在 Jade 中显示预览；关闭后会改用本模组自己的面板。没有安装 Jade 时，该设置会变灰，并照常使用本模组面板。

ModMenu（可选）

如果安装了ModMenu，Chest Radar 会在模组列表中添加一个入口，点击后会打开与打开设置按键绑定相同的设置界面。

完全可选。即使没有安装它，仍然可以通过按键绑定或雷达界面中的设置按钮访问所有设置。

数据存放位置

• config/chestradar.json是本模组的设置和你固定的物品。
• config/chestradar/<world>.json每个世界或服务器各有一个索引文件：单人游戏按存档名称区分，多人游戏按服务器地址区分。

删除其中一个索引文件，只会让对应世界的索引在你下次游玩时从空白开始。手动编辑配置文件前请先退出 Minecraft，并记得定期备份。

常见问题

服务器规则与公平游戏

这算作弊吗？它只会记录你的客户端原本就能看到的内容。打开箱子时，客户端会收到其中的物品；本模组只是把这些内容记下来，而不是在你关上界面后就忘掉。它不会发送或请求任何数据，也无法看到你从未打开过的容器。

不过，是否允许使用由你的服务器决定，不是我说了算。容器高亮可以隔墙显示，无论数据来源是什么，有些服务器都会把它视为透视功能。如果不确定，请关闭高亮（本模组专门提供了对应的按键绑定），或先询问管理团队。

找不到容器

你知道有个箱子，但雷达里没有显示。通常是以下三种原因之一。

1. 你从未打开过它。本模组无法索引你从未查看过内部物品的容器。这是设计本意，纯客户端没有办法绕过。
2. 它超出了搜索半径。超过该距离后，容器就不会出现在搜索结果中。不过它并没有被忘掉：在设置中调大搜索半径，它就会重新出现。
3. 它在另一个维度，而且搜索所有维度已关闭。

如果以上都不是原因，请检查是否启用了隐藏信息过期的箱子，以及该记录是否已超过过期时间阈值。

物品内容已过期

雷达显示箱子里有钻石，但实际没有。物品内容反映的是你上次打开该容器时的情况。你再次打开之前，如果有人把东西拿走，索引就会不准确。

本模组会如实标明这一点，而不会假装数据始终正确：每一行都标注记录时间，较旧的信息会显示为灰色；如果容器方块已经消失，下次你在区块加载时经过那里，它就会自动删除该记录。如果你关闭了显示“最后发现时间”，请重新开启。在繁忙的服务器上，可以调低信息在多久后视为过期。

自定义物品出现重复条目

服务器里的每种自定义物品都各自显示为一行。有些插件会给每一件自定义物品都加上唯一标记，例如单件物品 UUID 或创建时间戳。这样一来，两件实际上相同的物品就无法再被识别为同一种物品。

将对应组件的键添加到ignoredComponentKeys中的chestradar.json，然后重新索引。这样就能把它们归为同一类。

如果插件不是在创建物品时生成一次标记，而是在每次交互时重新随机生成标记，那么此方法就不起作用。这种情况下，同一个容器两次打开时，标记值都不一样，客户端过滤无法解决问题。

末影箱

末影箱不会被索引，这是有意为之：它们的内容会跟着你走，而不是固定在某个坐标。同样不会被索引的还有你的物品栏、从物品栏中打开的潜影盒，以及任何没有对应方块的插件菜单。

找不到配方

合成规划器只知道你的配方书收到的配方，也就是你在该世界中解锁的配方。自 1.21.2 起，客户端不会收到配方本身，只会收到配方书绘制的展示内容，因此客户端没有其他信息可读取。你从未解锁的配方不会出现在搜索结果中。

如果面板显示“未收到配方：该世界中的配方书为空”，说明服务器还没有向你发送任何配方。

路线为空

路线只会留在你开始规划时所在的维度，也不会计算你已经携带的物品。这两点都是有意设计的。因此，即使雷达仍然列出了大量该物品，路线也可能没有可执行的内容，因为物品在其他维度，或者已经在你的口袋里。

生成路线后请查看聊天栏提示：其中会统计因位于其他维度而被跳过的容器。

关闭自动清理

你可以阻止本模组自动修改索引。关闭让模组自动整理数据，它是“过期信息”部分的第一项设置，也是控制清理和过期标记的总开关：不会删除任何内容，也不会将信息标记为过期；只有在你打开容器或自行清除时，索引才会改变。

如果你只想保留其中一项功能，可以使用下方的两个细分设置。关闭总开关时，这两个设置会变灰。

清除单个世界

如果只想清除一个世界而保留其他数据，请在设置中使用忘记此世界中的所有内容，这只会删除当前世界或服务器的数据，并保留你固定的物品。你也可以在关闭游戏后手动删除对应的config/chestradar/<world>.json。

以上操作都无法撤销，也没有回收站。

潜影盒

雷达不会告诉你物品具体在哪个潜影盒里。它会告诉你物品曾在哪个容器中出现过（箱子、木桶或放置出来的潜影盒）。要进一步查找，就得自己打开该容器里的潜影盒。

请注意，物品总数可能包含放在潜影盒或收纳袋里的物品；不先打开它们，就无法直接取出。如果属于这种情况，聊天栏结果会显示“（N 个在潜影盒中）”。