SeedMapper - 种子地图

务必使用最新（稳定）版本的 SeedMapper！如果你想在旧版 Minecraft 上游戏，请使用 ViaFabricPlus。该模组允许你使用 SeedMapper 的最新功能，同时仍能在旧版 Minecraft 上游戏。

SeedMapper

一款 Minecraft Fabric 游戏内模组，允许你利用世界种子进行多种操作。作为参考，请查看本模组具备的功能](#features)。但请注意，此模组要求你拥有种子的访问权限。如果种子未知，你可以使用 19MisterX98 开发的 [SeedCrackerX 来破解。如有疑问或需要支持，请前往我的 Discord。

安装

• 安装 Fabric Loader。
• 下载 Fabric API 并将其移动到你的模组文件夹：
• Linux/Windows：.minecraft/mods。
• Mac：minecraft/mods。
• 从发布页面下载 SeedMapper 并将其移动到你的模组文件夹。

重要提示

你需要至少安装 Java 23 才能使用此模组。我建议从 adoptium.net 获取 Java 23（或更高版本）。接下来，配置你的 Minecraft 启动器以使用此版本的 Java。

• 原版启动器：前往 安装 -> 编辑 -> 更多选项 -> Java 可执行文件。
• MultiMC：前往 编辑实例 -> 设置 -> Java -> Java 安装。
• PrismLauncher：前往 设置 -> Java -> Java 运行时 -> 自动检测...。
• Modrinth App：前往 实例设置 -> Java 与内存 -> 自定义 Java 安装 -> 浏览

有时可能需要点击跳过 Java 兼容性检查的选项。

如果你在 Windows 上，请确保选择 javaw.exe，而不是 java.exe。

如果遇到问题，请联系你所用启动器的支持。

功能

在使用以下任何命令之前，请确保已使用 /sm:config Seed set 配置好种子。

种子地图

用法：/sm:seedmap

打开一个基于配置种子的可探索种子地图。你可以通过拖动鼠标来移动地图，并使用滚轮进行缩放。你可以通过点击屏幕顶部的功能开关来切换显示哪些特征。此命令与 /sm:source 命令结合使用时尤其有用！

生物群系定位

用法：/sm:locate biome 。

定位距离玩家最近的指定生物群系。支持所有维度的所有生物群系。

结构定位

用法：/sm:locate feature []{}。

定位距离玩家最近的指定结构。支持所有维度的所有结构。然而，由于底层库的限制，某些结构（特别是沙漠神殿、丛林神庙和 woodland mansions）可能会出现偶尔的误报。对于更高级的查询，你还可以使用部件和变体数据来进一步限制搜索。例如，以下命令将搜索带有船的末地城：/sm:locate feature structure endcity[endship]。

矿脉定位

用法：/sm:locate orevein (copper|iron)。

定位距离玩家最近的矿脉。将返回找到的第一个矿脉方块的坐标。之后，你可以使用 [/sm:highlight orevein [chunks]](#ore-vein-highlighting) 来高亮显示其他矿石。

战利品定位

用法：/sm:locate loot []。

定位距离玩家最近的箱子战利品。支持 1.13 及以后的所有版本。SeedMapper 将搜索结构的箱子战利品，以找到匹配物品和附魔条件的战利品。请注意，该命令不会阻止对无法获得的战利品和非法附魔组合的查询。如果搜索耗时过长，你应该使用 /sm:stoptask 取消它。

矿石高亮

用法：/sm:highlight block [chunks]。

在世界中高亮显示指定的方块。支持 1.13 及以后的所有版本。由于高度依赖于 OCEANFLOORWG 高度图，煤炭、铜和绿宝石矿石的位置可能不准确。

矿脉高亮

用法：/sm:highlight orevein [chunks]。

在世界中高亮显示矿脉。作为矿脉一部分生成的原始矿石方块会被特别高亮显示。填充方块会被忽略。

史莱姆区块定位

用法：/sm:locate slimechunk。

定位距离玩家最近的史莱姆区块。这总是准确的。

源点变异

用法：/sm:source (run)|(as )|(positioned )|(rotated )|(in )|(versioned )|(seeded )。

从修改后的源点执行给定的命令。例如，修改源点的位置将使得命令如同你在该位置一样执行。这个命令非常强大，请善用它！

从源码构建

此模组内部使用了 Cubitect 开发的 C 库 cubiomes（的一个分支）。该库的 Java 绑定是使用 jextract（也是一个分支）创建的。这些绑定使用了来自 Project Panama 的 Foreign Function & Memory API。有关自动执行此操作的 Gradle 任务，请参阅 CreateJavaBindingsTask.java。

要在本地构建模组，请按照以下步骤操作：

• 克隆仓库：

   git clone --recurse-submodules https://github.com/xpple/SeedMapper
   cd SeedMapper

• 将 cubiomes 编译为共享库。不能使用 MSVC 来构建项目！以下步骤适用于 Windows：

   cd src/main/c/cubiomes
   cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
   cmake --build build --config Release
   cp build/cubiomes.dll ../../resources/cubiomes.dll
   cd ../../../../

• 安装 LLVM（推荐版本 13.0.0）并将环境变量 LLVM_HOME 设置为 LLVM 的安装目录。
• 编译 jextract。同样，以下步骤适用于 Windows：

   cd jextract
   ./gradlew --stacktrace -Pjdk_home="$env:JAVA_HOME" -Pllvm_home="$env:LLVM_HOME" clean verify
   cd ../

• 构建模组：

   ./gradlew build

你应该能在 src/main/java/com/github/cubiomes 中找到 Java 绑定。

最后，你也可以参考 GitHub Actions 工作流文件，其中包含了每个主要操作系统的完整构建说明。