Skip to content

SunnySlopes/DoubleMonumentForFixedSeed

Repository files navigation

Double Monument For Fixed Seed

固定种子二联海底神殿搜索工具

A GUI program for searching double ocean monuments (paired ocean monuments) in Minecraft Java Edition fixed seeds. Supports Minecraft Java Edition 1.18.2 through 1.21.1.

用于在 Minecraft Java 版固定种子中搜索二联海底神殿(成对生成的海底神殿)的图形界面工具。支持 1.18.21.21.1

Search uses cubiomes via a native library (JNI): monument positions and deep-ocean biome viability (isViableStructurePos for monuments). Results may differ from older versions that used custom climate noise thresholds.

搜索通过 cubiomes 原生库(JNI)实现:计算神殿位置并判定深海群系是否可行isViableStructurePos)。与旧版基于自定义气候噪声阈值的实现相比,结果可能略有不同。

The UI supports Chinese / English switching (single-seed tab). Default language follows the system locale.

界面支持中 / 英切换(单种子搜索 Tab)。默认语言随系统 Locale 自动选择。


Requirements / 环境要求

  • Java 17+
  • Windows / Linux / macOS (native library built per platform)
    Windows / Linux / macOS(需按平台编译原生库)
  • To build the native library: CMake, Ninja, MinGW gcc/g++ (e.g. MSYS2 ucrt64)
    编译原生库需要:CMakeNinjaMinGW gcc/g++(如 MSYS2 ucrt64

Build from source / 从源码构建

git submodule update --init --recursive
./gradlew buildNative DoubleMonumentForFixedSeedJar

Output / 输出:build/libs/DoubleMonumentForFixedSeed-2.0.jar

On Windows with MSYS2, ensure C:\msys64\ucrt64\bin (or mingw64\bin) is on PATH when running Gradle.

Windows + MSYS2 环境下,运行 Gradle 前请将 C:\msys64\ucrt64\bin(或 mingw64\bin)加入 PATH


Run / 运行

java -jar build/libs/DoubleMonumentForFixedSeed-2.0.jar

Or use run.bat after building.
或构建后使用 run.bat

The JAR embeds native libraries under /native/{windows|linux|macos}/. You can also run with:

JAR 内嵌原生库,路径为 /native/{windows|linux|macos}/。也可指定库路径运行:

java -Djava.library.path=build/native -jar build/libs/DoubleMonumentForFixedSeed-2.0.jar

JNI smoke test / JNI 冒烟测试

./gradlew buildNative compileTestJava
java -Djava.library.path=build/native -cp "build/classes/java/main;build/classes/java/test" project.MonumentNativeSmokeTest

How to Use / 使用方法

Common controls / 通用按钮

中文 English Description / 说明
开始搜索 Start Search Start search / 开始搜索
暂停 Pause Pause search / 暂停搜索
继续 Resume Resume paused search / 继续已暂停的搜索
停止 Stop Stop search / 停止搜索
重置搜索区域 Reset Search Area Reset MinX/MaxX/MinZ/MaxZ to defaults / 将区域坐标恢复为默认值
导出 Export Export single-seed results / 导出单种子搜索结果
排序 Sort Sort results by distance to origin / 按到原点距离排序
选择文件 Select File Import seed list (batch tab) / 导入种子列表(批量 Tab)
导出完整结果 Export Full Results Export full batch output / 导出批量完整结果
导出种子列表 Export Seed List Export seeds that had hits / 导出有结果的种子列表

Click 开始搜索 / Start Search to start, 暂停 / Pause to pause, 停止 / Stop to stop.

点击 开始搜索 / Start Search 开始,暂停 / Pause 暂停,停止 / Stop 停止。

Default thread count is the number of CPU cores (capped at runtime). If you enter more threads than CPU cores, a confirmation dialog offers to adjust automatically.

默认线程数为 CPU 核数(运行时会 clamp)。若输入超过 CPU 核数,会弹出确认框询问是否自动调整。


Tab 1: Single seed search / 单种子搜索

Field / 字段 中文 English
Seed 种子 Seed
Threads 线程数 Thread Count
Version 版本 Version
Region MinX / MaxX / MinZ / MaxZ (×512) same
Language 语言 (Chinese / English) Language
Option 找到符合条件的二联时立即暂停 Pause immediately when a valid pair is found
  • Results format / 结果格式:/tp x 50 z (dx=?, dz=? / dx=?, dz=?)
    Low-efficiency pairs append / 低效配对后缀: - 效率会略微损失 / - slightly reduced efficiency

Tab 2: Batch seed search / 批量种子搜索

Import a text file (one seed per line), configure region and thread count, then click 开始搜索 / Start Search. The tool searches each seed in order and prints seeds with at least one valid pair.

导入文本文件(每行一个种子),设置区域与线程数后点击 开始搜索 / Start Search。程序按顺序搜索每个种子,并输出存在有效二联的种子及其结果。


Project layout / 项目结构

Path Description / 说明
src/main/java/project/ Swing UI (DoubleMonumentForFixedSeed), JNI bridge (MonumentFinderBridge), runner (MonumentSearchRunner) / 界面、JNI 桥接、搜索编排
src/main/resources/messages_*.properties UI i18n strings (zh_CN / en_US) / 界面国际化文案
monument_search.cpp / monument_search_core.c C++ search and cubiomes calls / C++ 搜索与 cubiomes 调用
jni/ JNI glue and CMake target monumentFinderLibJ
cubiomes/ git submodule (Cubitect/cubiomes)

About

Double monument finder for Minecraft Java 1.18+

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors