orefinder-estimate (npm)

A fast, offline, dependency-free Minecraft ore estimator for Node.js. Given a seed label, version, and player position, it estimates likely ore coordinates and the best mining Y level for Java and Bedrock.

Fast, offline estimates of the best mining Y and where an ore is likely to concentrate. For pinpoint, seed-exact coordinates (Java & Bedrock), pair it with the Minecraft Ore Finder.

Install

npm install orefinder-estimate

Library

import { estimate } from "orefinder-estimate";

const result = estimate({
  seed: "42",
  version: "java_1_21",
  ore: "diamond",
  x: 0, y: 64, z: 0,
  biome: "plains",
  searchRadius: 220,
});

console.log(result.metadata.miningPeakY); // suggested Y
console.log(result.bestCluster[0]);       // { x, y, z, distance, confidence, probabilityPct }

CLI

npx orefinder-estimate --seed 42 --version java_1_21 --ore diamond -x 0 -y 64 -z 0
npx orefinder-estimate --ore ancient_debris --version java_1_21 --biome crimson_forest --json

Supported ores

diamond, iron, gold, coal, copper, emerald, redstone, lapis, ancient_debris (and netherite aliases), nether_gold, nether_quartz, gilded_blackstone, blackstone.

Structures and exact seed-based placement are intentionally out of scope; those live at orefinder.io.

How it works

Pure statistics over published Y-distribution ranges with deterministic seeding, so the same input always yields the same output. It never simulates world generation and never makes a network request. Algorithm details: SPEC.md.

License

MIT (c) Ore Finder