Skip to content

ezsx/seedforge

Repository files navigation

Seedforge — GPU Noita seed search, verification and research

Seedforge is both a usable local seed-search product and a reproducible worldgen research project:

  1. an exhaustive 2.147B-seed coalmine census found 3.33M great chests and all 55 known natural Orb-of-Knowledge chest seeds;
  2. a dual-GPU 179.6M-seed ROI12 scan resolved another 10.95M great chests and recorded 5,131 observed chest coordinates across 12 source biomes;
  3. the repository preserves the commands, hashes, negative results and known limitations behind those scans.

Coalmine seeds Great chests analysed Natural Orb seeds ROI source biomes Telescope comparison License

Seedforge inspects seeds, searches large ranges with rich predicates, ranks discoveries, opens an authoritative world map and launches selected seeds in the game. It combines a React UI, a Node/TypeScript verifier, embedded Noita Telescope, and a heavily extended CUDA search engine. It runs locally and requires your own Noita game data; no data.wak or other copyrighted game data is distributed.

Status: public research/development release. Search, evidence, reproducible submodules and native V100/Blackwell GPU profiles are operational. UI polish and broader hardware validation remain in progress.

Research and evidence map

Open the complete research and evidence map →

Question Measured answer Evidence
Where did the scans emit natural great chests? Coalmine produced 279 observed coordinates; ROI12 added 5,131 across 12 source biomes. These inherit the engine's placement-completeness limits. Coalmine distribution · ROI12 atlas
Why are natural Sampo/Orb drops Mines-only? Not a biome whitelist: repeated coordinate-seeded RNG makes ordinary chest presence incompatible with the rare roll; guaranteed Mines/Tower slots bypass that gate. RNG-overlap study
Do Orb Atlas pixels occur in other biomes? Yes. Nine pixels were found in the representative record seed's ROI areas, but none intersected any of the 5,131 natural chest coordinates. Orb Atlas intersection
How closely did CUDA match Telescope in sampled runs? Selected comparisons found and fixed real CUDA errors; the final sample retains named boundary and wand-content residuals. This is not proof over every seed. Telescope comparison scorecard
What did the overnight cross-biome hunt produce? 179.6M world seeds, 10.95M chest records, 10.1k complete world sweeps/s and a Telescope shortlist. ROI12 run report

Coalmine great-chest lattice: frequency, Sampo rate and Orb-producing slots

The exhaustive coalmine lattice: circle size is chest frequency, colour is Sampo rate, and purple rings mark slots that have produced an Orb. The cross-biome atlas contains one equivalent SVG for each ROI12 source biome.

Great-chest loot leaderboards

loot is the number of top-level drops produced by one Great Treasure Chest; a wand counts as one top-level item and its contained spells are reported separately. The coalmine table is exhaustive over the supported seed space. The ROI12 table covers only the 179.6M-seed overnight range, but searches much richer biomes. Both use the same parser and metric.

Coalmine — all seeds 1..2,147,483,645

rank loot seed position
1 359 520067174 (175,857)
2 352 1527791963 (595,637)
3 336 273344954 (1755,777)
4 332 164026141 (615,967)
5 300 1939086692 (-85,657)
6 299 742929106 (1745,927)
7 297 111591643 (1995,597)
8 296 824710883 (315,17)
9 295 1941358933 (1865,527)
10 294 52361906 (1865,527)

Full coalmine treasure report →

ROI12 — seeds 1,000,100,000..1,179,745,151

rank loot source biome seed position
1 436 meat 1095481929 (6775,6937)
2 427 fungiforest 1110005919 (14305,4317)
3 389 fungiforest 1149948244 (12935,2217)
4 375 rainforest_dark 1069901920 (-4605,7457)
5 372 vault 1165392194 (1075,9687)
6 363 excavationsite 1164240465 (-755,2287)
7 359 snowcave 1099128143 (1075,3467)
8 354 fungiforest 1143875538 (12635,3637)
9 352 excavationsite 1026121216 (465,1837)
10 348 fungiforest 1177130050 (14065,5587)

The loot-436 record is Telescope-confirmed; the remaining rows are deterministic engine candidates pending targeted Telescope/game seals. The complete curated top-100 is top-100.csv.

Completed coalmine census

Seedforge's CUDA and ranking pipeline exhaustively scanned every supported Noita world seed from 1 through 2,147,483,645 for coalmine great chests:

  • 3,332,208 great chests cataloged;
  • coalmine record: 359 top-level loot entries, seed 520067174, position (175,857) — Telescope-confirmed, in-game seal pending;
  • all 55 Orb-of-Knowledge chest seeds in the range;
  • 37,855 tier-11 wands, including three chests holding four each.

The complete curated result, top ten, orb list and verification status are in Treasures of the Mines. Large raw dumps are kept outside Git; ranked and provenance artifacts remain documented.

What Seedforge does

  • Scry: inspect perks, rerolls, shops, starting equipment, alchemy, fungal shifts, wands and other deterministic seed data.
  • Seek Fates: combine HARD predicates and weighted SOFT preferences, stream results, stop while keeping hits, and open any hit in Scry or Telescope.
  • Player profile: read the active Noita save unlocks and use one profile for clone evaluation, CUDA wand generation and embedded Telescope.
  • World map: Noita Telescope is the default map. The local noita-tools map is retained as an explicitly marked WIP renderer.
  • Recipe workspace: edit or save JSON presets and run commented PowerShell searches from recipes/search/.
  • Long hunts: resume UUID-pinned per-biome ranges across native V100 and RTX 5060 Ti workers, preserving canonical evidence.
  • Descend: set the seed and launch Noita from a selected result.

Start here

The current build requires Node.js 20+, Docker Desktop/WSL2, an NVIDIA driver for GPU search, and Noita. Dependency locations and pinned revisions live in seedforge.dependencies.json.

Follow the complete Getting Started guide for:

  1. workspace layout and dependencies;
  2. V100 sm_70 or native Blackwell sm_120 image builds;
  3. UUID-pinned bridge startup;
  4. backend and frontend commands;
  5. runtime identity checks and troubleshooting.

The unified entrypoint performs dependency checks, initializes the current manifest/submodules, selects a GPU profile and starts the bridge plus both web services:

.\seedforge.ps1 setup
.\seedforge.ps1 doctor
.\seedforge.ps1 start -Gpu auto

Use status to inspect the actual runtime GPU/build and stop to stop only the processes recorded by this entrypoint. Manual component commands remain in the Getting Started guide for development and troubleshooting.

Open http://127.0.0.1:5173. Seek Fates reports the actual runtime GPU, UUID, native/PTX-JIT status, register cap, geometry multiplier and build identity.

Search workflows

Use the smallest workflow that honestly represents the task:

Workflow Best for
Interactive UI Common predicates, a few results, rapid inspection
Disk recipes Expert HARD/SOFT combinations using the /search API
Path A hunt Exhaustive per-biome/all-biome scans, records, leaderboards

Ready-made UI hunts are JSON files in recipes/search/presets/. They can be edited externally, reloaded, or created with SAVE TO DISK in the UI.

The real great-chest record workflow is intentionally not approximated by a UI loot-count field. The clone map misses some real wang/pixel-source chests, including the known 359 seed. Use the exact resumable census and ranking recipe:

.\recipes\search\great-chest-record-hunt.ps1 -Start 1 -Hours 5 -Workers both -MinLoot 100

For a main-world catalog across all 22 target biomes, use the source-aware Path A recipe. It generates only the 16 biomes that can produce chests, while the engine's separate target gate retains valid boundary chests landing in the six source-empty biomes:

.\recipes\search\all-biome-great-chest-hunt.ps1 -Start 1000000000 -Hours 2.5 -Workers both

Completed runs contain resumable raw cells, merged.canonical.txt, a full leaderboard.csv, and records.sqlite3 for further community analysis.

GPU performance

Measured final profiles on the development machine:

  • V100: native sm_70, MAXRREG=160, m18/s8;
  • RTX 5060 Ti: native sm_120, MAXRREG=80, general m24/s4, with an excavationsite m20 exception;
  • RTX 5060 Ti coalmine: about 75.7k seeds/s native versus 19.9k/s through the old sm_70 PTX-JIT profile on the same card/workload;
  • combined measured coalmine capacity: about 135.2k seeds/s (59.5k/s V100 + 75.7k/s RTX 5060 Ti), before dual-worker orchestration overhead;
  • all-22 arithmetic capacity: roughly 1.2k world-seed sweeps/s across both cards before orchestration overhead.

These numbers are workload-specific. The UI exposes runtime identity so unlike biomes, predicate sets, architectures and launch profiles are not compared as if they were the same benchmark.

The CUDA fork contains the full build matrix, correctness anchors and tuning evidence in docs/BUILD-GPU-ARCH.md and diagnostics/.

Correctness and evidence

Seedforge treats correctness gates as stronger than performance explanations:

  • canonical CPU/GPU output comparisons;
  • frozen WAK, image, binary and configuration fingerprints;
  • all-22 native V100/Blackwell gates;
  • sampled Noita Telescope comparisons as an independent cross-check;
  • targeted in-game seals for disputed or high-value findings.

Telescope agreement is not described as exhaustive game parity or as a substitute for checking disputed results in Noita. Outstanding caveats — including map/pixel-source completeness — remain visible in the evidence.

Start at the evidence index and the CUDA performance archive for reproducible claims.

Repository layout

  • packages/backend — local API, verifier, search orchestration and game launch;
  • packages/frontend — React/Vite application;
  • searcher — UUID-pinned Docker Compose services;
  • recipes/search — editable presets and runnable predicate/hunt examples;
  • tools/path_a_hunt.py — resumable dual-GPU source/target-aware hunt runner;
  • tools/path_a_results.py — strict merge, SQLite catalog and leaderboard finalizer;
  • tools/path_a_path_b_gate.py — multiplicity-preserving Path A/Path B equivalence gate;
  • tools/rank_chests.py — community-style great-chest ranking;
  • hunts — curated discoveries and leaderboards;
  • docs — architecture, guides, specifications and evidence.

Seedforge is the product hub. The CUDA engine and noita-tools clone remain separate repositories with their own histories and notices. See the CUDA engine boundary.

Credits

Seedforge builds on several Noita community projects:

Seedforge is an unofficial fan project and is not affiliated with Nolla Games.

License

MIT © 2026 ezsx. Linked/forked components retain their own licenses, upstream attribution and notices.

About

GPU-accelerated Noita seed search, inspection, maps and reproducible community research.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages