Companion mod
Seedscout Nav
A Fabric mod for Minecraft Java Edition that pairs with the Seedscout app over your local network. Once paired, the app reads your world seed and player position, and can draw a route on the ground to guide you toward a feature you picked.
Pre-release. There is no released JAR yet, and the mod is not on Modrinth or CurseForge. End-to-end pairing has had only limited testing on real hardware, so a build from source is experimental. Releases are deliberately being held until pairing is properly tested, rather than shipping something untested. Watch the GitHub repo to hear about the first one, or build it from source in the meantime.
Requirements at a glance
- Edition
- Java Edition only. There is no Bedrock build, and the Seedscout app's Bedrock mode cannot pair.
- Loader
- Fabric, not Forge.
- Minecraft
- 1.26.2
- Fabric API
- 0.158.0+26.2 or later
- Also needed
- The Seedscout app on Android, on the same local network.
- License
- Apache 2.0, free and open source.
Where to get it
Three channels, one page
This page is the single place the Seedscout app points at, so a channel can be added or dropped here without shipping an app update.
GitHub
The source, the issue tracker and the security policy. Releases will appear here first.
Modrinth
Not published yet. This card becomes a link when the project is live.
Not available yet
CurseForge
Not published yet. This card becomes a link when the project is live.
Not available yet
Setup
Installing the mod
Until the first release lands, step 3 means building the JAR yourself. The build takes one command, and needs only a JDK 25.
Install Fabric Loader
For Minecraft 1.26.2, following the official Fabric documentation. Fabric, not Forge.
Install Fabric API
Version 0.158.0+26.2 or later. Put the JAR in your mods folder.
Add Seedscout Nav
Put the Seedscout Nav JAR in that same mods folder.
Start Minecraft
Launch a world, and you are ready to pair.
Until the first release
Building it yourself
There is no released JAR yet, so this is currently the only way to get the mod. A build takes about 30 seconds once Gradle has warmed its cache, and it runs the test suite as it goes.
What you need
JDK 25 or later, and nothing else. The build targets Java 25, so an earlier JDK will not compile it. Gradle ships with the wrapper, and Fabric Loom downloads Minecraft and Fabric API itself on the first run.
Where the JAR lands
At build/libs/seedscout-nav-0.1.0.jar. That is the file to drop in your mods folder. The -sources.jar beside it is for IDEs; Minecraft does not need it.
A dev client instead
Run ./gradlew runClient to launch a development client with the mod already loaded, rather than installing the JAR into your own Minecraft.
On macOS, avoid /usr/libexec/java_home -v 25. It only sees JDKs registered under /Library/Java/JavaVirtualMachines, so with a Homebrew JDK it quietly hands back a different Java instead of failing, and the build then dies on an unrelated-looking error. The full build notes live in the repo README.
Pairing
Connecting the app
Open the pairing screen
Press N, the default key. It is rebindable through Mod Menu, or Minecraft's own Options, Controls menu, under the Seedscout Nav category.
Scan the QR code
Use the Seedscout app on your phone to scan the code shown on your screen.
Confirm in game
Accept the in-game prompt. Scanning the code alone is never enough on its own.
You are paired
The app can now see your seed and position, and draw routes in your world. Press the key again to close the screen or end the session.
Security
What it opens, and for how long
The mod is entirely client-side. There is no account and no cloud service behind it.
Local network only
A WebSocket listener opens on your local network only while you are pairing or a session is running, and closes by itself when the session ends.
The QR code is a secret
It is short-lived, 120 seconds, and anyone who can see it can use it to pair. Keep the pairing screen off stream and out of screenshots.
You confirm every pairing
Pairing always needs an explicit in-game confirmation from you. The pairing token is never written to disk or to logs.
The full threat model, covering what a device on your network can and cannot do and how to report a vulnerability, is in SECURITY.md. Questions, problems or suggestions: support@seedscout.app.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.