coordcraft

Minecraft seed analyzer for finding biomes, structures, and Nether fortresses in Soul Sand Valleys.

Features

• Quick Scan - All dimensions (Overworld, Nether, End) biomes, structures, and Nether SSV fortresses in one run
• Search all biomes & structures near a location, sorted by distance
• Top-N search for a specific structure or biome
• Nether Fortress SSV purifier - finds fortresses whose surrounding blocks are entirely Soul Sand Valley
• Interactive TUI (Rich + Questionary) and non-interactive CLI modes
• Per-seed result journaling - results saved as JSON for later review

Requirements

• Python 3.11+
• cubiomespi-fork v1.1.1 (Windows wheel)

Installation

pip install cubiomespi_fork-1.1.1-cp312-cp312-win_amd64.whl
git clone https://github.com/mosaddiqdev/coordcraft.git
cd coordcraft
pip install -e .

Usage

Interactive mode

coordcraft

Opens a menu-driven TUI. Enter a seed, then choose from:

1. Quick scan -- Overworld all + Nether SSV
2. Search all biomes & structures near a location
3. Find top-N closest specific structure
4. Find top-N closest specific biome
5. Nether fortress in Soul Sand Valley
6. View saved results
7. Change seed
8. Exit

CLI mode

coordcraft -s 12345 -d nether -m ssv
coordcraft -s 42 -d overworld -m all -r 2000 -n 5
coordcraft -s 99 -d overworld -m structures --x 0 --z 0
coordcraft --help

Flag	Short	Description
--seed	-s	World seed
--dimension	-d	overworld, nether, or end
--mode	-m	all, biomes, structures, or ssv
--radius	-r	Search radius in blocks (biomes, default 5000)
--top-n	-n	Max results (default 10)
--x / --z		Center coordinates (default: spawn)
--ssv-radius		Biome purity radius for SSV check (default 100)
--mc-version		MC version number (26 = 1.21)
--version	-V	Show version

From source without install

cd coordcraft/src
python -m coordcraft

Project structure

coordcraft/
  src/coordcraft/
    cli/          -- TUI: theme, screens, app flow
    engine/       -- Search algorithms: biomes, structures, SSV
    models/       -- Result dataclasses
    utils/        -- Constants, name mappings, journal
    main.py       -- Entry point with CLI parser
  data/fetches/   -- Per-seed result JSON files
  tests/

Saved results

Results are saved as JSON in data/fetches/. Two formats coexist:

• {seed}.json -- timestamped entries from interactive searches
• {seed}-quick.json, {seed}-quick-1.json, etc. -- clean snapshots from Quick Scan