探险家罗盘强化

探险家指南针

探险家指南针（Explorer's Compass）是一个 Minecraft 模组，让你无需离开所在区块，就能搜索并定位世界中的结构和生物群系。

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

功能

搜索

• 定位你当前所在维度中，世界可以生成的任何结构或生物群系。
• 可同时选择多个目标（按住 Ctrl 键点击），搜索将返回最近的一个。
• 可搜索整个类别——例如所有村庄、所有海底废墟——而无需指定具体名称。
• 可以继续搜索已找到目标的下一个实例，以及再下一个。
• 可通过模组、维度或小型查询语言过滤列表；还可按名称、类别、维度或来源模组排序。
• 在搜索前查看结构外观：服务器会像世界生成那样组装它，但不会在世界中实际放置任何方块，指南针会将其绘制成可旋转、缩放和逐层剖切的模型。模型与方块的比例为 1:1：你看到的是结构本身的大小，而非缩略图。小型结构会使用方块自身的模型绘制，包括箱子、床和旗帜；大型结构则以相同尺寸的色块代替，这样即使是大宅或要塞也能一览无余，而无需等待加载。

搜索之后

• 平视显示面板会显示指南针的状态：搜索时的搜索半径和进度，以及定位后的坐标、距离和罗盘方位。
• 屏幕顶部的方向条会标记目标在水平线上的位置，当你正对目标时变为绿色，目标在屏幕外时则提示转向方向。
• 指南针指针本身会指向已定位的位置，如同真正的指南针一样。
• 每次定位的位置都会被记住。你可以将指南针重新指向它们，在聊天中分享（点击即可复制坐标），或在服务器允许的情况下传送到该位置。

集成

• 如果安装了 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——每个面板可以独立设置为填充背景或仅显示轮廓并保持透明。

致谢

探险家指南针由 ChaosTheDude 创作（MattCzyr/ExplorersCompass）。本仓库基于该作品构建。

许可证

本模组基于 知识共享 署名-非商业性使用-相同方式共享 4.0 国际 许可证 提供。