Explorer’s Compass Enhance

Explorer’s Compass

Explorer’s Compass 是一个 Minecraft 模组，让你无需离开所站的区块，就能在世界任何地方搜索并定位结构和生物群系。

本仓库是 MattCzyr/ExplorersCompass 的一个分支，新增了生物群系搜索、书签、位置分享、抬头方向条等功能。上游模组仅涵盖结构；生物群系则由其姊妹模组 Nature’s Compass 负责。

功能

搜索

• 在你所处的维度中，定位世界能够生成的任何结构或生物群系。
• 同时选中多个（Ctrl+点击），搜索会返回其中最近的一个。
• 搜索整个组——所有村庄、所有海底废墟——而不是指定某一个。
• 在你已找到的位置之后继续搜索下一个同类目标，以及再下一个。
• 按模组、按维度或使用小型查询语言筛选列表；按名称、组、维度或来源模组排序。
• 在花费一次搜索之前先看看结构长什么样：服务器会按照世界生成的方式组装它，但不会将其放置在任何地方，指南针会把它绘制成一个模型，你可以旋转、缩放并切掉图层来查看内部。一个格子对应一个方块：你看到的是结构本身的大小，而不是它的草图。小型结构使用方块自身的模型绘制，包括箱子、床和旗帜；大型结构则以相同尺寸用彩色方块绘制，这样宅邸或要塞可以快速查看而不必等待。

搜索之后

• 一个抬头面板会显示指南针正在做什么：搜索运行时显示搜索半径和进度，完成后显示坐标、距离和罗盘方位。
• 屏幕顶部的方向条会标记目标相对于地平线的位置，当你面向它时会变绿，当它在屏幕外时会指示需要转向的方向。
• 指南针指针本身会指向已定位的地点，正如指南针应有的样子。
• 每个已定位的地点都会被记住。将指南针重新指向其中一个，在聊天中分享可点击复制的坐标，或在服务器允许的情况下前往该地点。

集成

• 当安装了 Xaero’s Minimap 时，会为每个已定位的地点创建路径点。
• 资源包可以通过自定义模型数据为每个结构赋予指南针不同的外观。
• 数据包和整合包可以定义自己的结构组。
• 已翻译为英语、德语、西班牙语、日语、俄语、简体中文和繁体中文。

配置

服务端选项位于 config/explorerscompass-common.toml，客户端选项位于 config/explorerscompass-client.toml。

值得了解的事项：

• maxRadius、maxSamples、maxBiomeSamples — 允许搜索在放弃前查找的最大范围。调高它们能以更高的开销找到更远的目标。
• maxSearchTimePerTick — 每个服务器 tick 中允许搜索消耗的时间片，由所有同时运行的搜索共享。调低可保持服务器响应性；调高则更快完成。
• asyncBiomeSearch — 在服务器线程之外运行生物群系搜索，分摊到允许搜索的尽可能多的线程上，从而快数倍完成且不消耗服务器资源。这样做是安全的，因为某个位置生成何种生物群系仅由种子和生成器的噪声决定。如果某个生物群系来源模组被证明不是线程安全的，请将其关闭。
• asyncStructureSearch — 对结构搜索同样如此，也分摊到多个线程上，通过按照世界生成的方式推算出结构会在哪里生成，而不是向区块存储询问每一个查看的位置。那个询问几乎就是结构搜索的全部开销，而用这种方式回答它不会读取世界的任何部分。搜索最终确定的位置在指南针指向它之前仍会与区块存储核对；两者可能出现差异的地方是在设置改变后生成的地形，此时指南针会给出结构现在会生成的位置。将其关闭可让每个位置都像以前一样由区块存储回答。
• structureBlacklist / biomeBlacklist — 指南针不会显示或搜索的内容。* 匹配任意数量的字符，? 匹配一个字符，因此 minecraft:*village* 可用。
• allowTeleport、allowSharing 及其冷却时间 — 玩家可以对结果执行的操作。
• allowStructurePreview、structurePreviewResolution、structurePreviewMaxBlocks — 玩家是否可以查看结构的样子、显示的精细程度以及绘制多少。每个结构只组装一次，然后在服务器运行期间一直保留，因此再次打开预览不产生任何开销。客户端的 structurePreviewDetailLimit 是预览停止用真实方块绘制、开始用彩色方块绘制的界限。
• showDirectionBar、directionBarWidth、directionBarSpan — 地平线条带。将宽条带与大跨度搭配，可让整个地平线同时显示在屏幕上。
• overlayBackground、guiHeaderBackground、guiSidebarBackground、guiStatusBarBackground — 每个面板可以单独填充，或保持描边和透明。

致谢

Explorer’s Compass 由 ChaosTheDude 创建
（MattCzyr/ExplorersCompass）。本仓库基于该作品构建。

许可证

本模组在
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License 下提供。