{
  "schemaVersion": 1,
  "page": "/tools/mineshaft-finder/",
  "editorialDate": "2026-10-15",
  "interpretation": "Source research, model measurements and catalogue game observations are separate evidence. A quoted source claim is not a new game check. A location waypoint is not the full structure bounding box. Dates belong to their recorded events.",
  "paragraphs": {
    "placement": [
      {
        "text": "In Java 26.3, each Overworld chunk has a 0.4% chance of becoming a mineshaft candidate, before biome and generation checks. Normal and badlands mineshafts share that roll.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.placement[1]",
            "researchedOn": "2026-10-09",
            "text": "Mineshafts use a chunk-by-chunk placement roll, not a widely spaced regional grid: spacing 1 chunk, separation 0, salt 0, frequency 0.004, frequency_reduction_method legacy_type_3. The normal and mesa entries have weight 1 each. Failed entry generation can retry the other entry, so these weights do not mean a 0.2% chance for each eligible biome.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), data/minecraft/worldgen/structure_set/mineshafts.json; AbstractSpreadingStructurePlacement.legacyProbabilityReducerWithDouble; ChunkGenerator.createStructures / tryGenerateStructure; CFR 0.152 reconstruction of official bytecode, read locally; source analysis only",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.frequency[0]",
            "researchedOn": "2026-10-09",
            "text": "The configured 0.004 candidate probability is 0.4% per chunk before successful generation and biome checks. It is not a measured structure density, a guarantee of one mineshaft every 250 chunks, or a travel-distance estimate. Adjacent candidate chunks are possible because separation is zero.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), data/minecraft/worldgen/structure_set/mineshafts.json; AbstractSpreadingStructurePlacement.legacyProbabilityReducerWithDouble; CFR 0.152 reconstruction of official bytecode, read locally; source analysis only",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Normal mineshafts start outside the Deep Dark. Badlands, Eroded Badlands and Wooded Badlands use the separate badlands variant. Tunnels can extend beyond the biome where they start, so you may see a branch near an ancient city even though its starting chunk is elsewhere.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.mineshaft.placement[1]",
            "researchedOn": "2026-10-09",
            "text": "Normal mineshaft allowed-biome data covers the Overworld excluding the badlands variants and Deep Dark; mineshaft_mesa is allowed in badlands, eroded_badlands and wooded_badlands. A prohibited start biome does not establish that long tunnels cannot overlap it.",
            "edition": "java",
            "versions": "26.3",
            "source": "Java 26.3 official server.jar, data/minecraft/tags/worldgen/biome/has_structure/mineshaft.json and mineshaft_mesa.json",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Normal layouts move below sea level, while badlands layouts can sit higher depending on the sampled surface. There is no single Y level to dig at for every mineshaft. Start near the structure coordinates and look through intersecting caves for branches of the tunnel network.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.placement[2]",
            "researchedOn": "2026-10-09",
            "text": "Normal layouts are moved below sea level with a 10-block margin using the generator minimum Y; this is a vertical layout adjustment, not one universal level at which a player should dig. Mesa layouts instead place their bounding-box center at sea level when the sampled surface is lower, otherwise at a randomly selected inclusive height from sea level to that surface.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), MineshaftStructure.generatePiecesAndAdjust; StructurePiecesBuilder.moveBelowSeaLevel; CFR 0.152 reconstruction of official bytecode, read locally; source analysis only",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[5]",
            "researchedOn": "2026-10-09",
            "text": "A finder location identifies the starting chunk/structure anchor, not a known entrance or chest. The Java start room is assembled at in-chunk +2,+2 before the whole network is vertically adjusted; branches extend outside that room. Inspect intersecting caves near the coordinates rather than assuming a surface entrance is present.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), MineshaftStructure.findGenerationPoint / generatePiecesAndAdjust; MineshaftPieces.MineShaftRoom / addChildren; CFR 0.152 reconstruction of official bytecode, read locally; source analysis only",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ],
    "in-game": [
      {
        "text": "In Java 26.3, normal mineshafts have oak supports and badlands mineshafts have dark oak. Look through caves and ravines for wooden tunnel supports, rails and cobwebs. Tunnels are easier to spot where a canyon exposes them. In badlands, also check cliff faces and higher cave openings.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[2]",
            "researchedOn": "2026-10-09",
            "text": "For a survival search, look for wooden tunnel supports, rails and cobwebs exposed in caves or ravines. Mojang describes ravine/canyon intersections as especially visible clues. Badlands terrain is worth inspecting for higher exposed layouts, but visible clues do not guarantee a mineshaft in every cave or badlands patch.",
            "edition": "both",
            "versions": "General gameplay article published 2024-11-09; Java 26.3 vertical behavior separately checked; Bedrock 26.50 fine placement unresolved",
            "source": "Mojang Building Blocks: Mineshaft; current Java higher-layout evidence in MineshaftStructure",
            "url": "https://www.minecraft.net/en-us/article/mineshaft",
            "confidence": "medium"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.mineshaft.inGameFinding[5]",
            "researchedOn": "2026-10-09",
            "text": "In Java 26.3, oak-plank supports, rails and cobwebs distinguish normal mineshaft tunnels; the badlands type uses dark-oak wood. A cave opening that exposes these pieces is a locating clue, while a seed-tool start pin does not identify a particular cave-spider spawner.",
            "edition": "java",
            "versions": "26.3",
            "source": "Java 26.3 MineshaftStructure.Type wood definitions and MineshaftPieces piece generation; existing research/structures/mineshaft/rooms.md source audit",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Secret chests in abandoned camps can contain a Buried Mineshaft Map. These maps lead to normal mineshafts only, so use another method if you want the badlands variant. A map is possible loot, and its destination may differ from the nearest mineshaft returned by your own search.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[3]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 abandoned-camp secret-chest loot can produce a Buried Mineshaft Map via exploration_map destination #minecraft:on_mineshaft_maps. The destination tag contains only the normal mineshaft. This is a possible map drop, not guaranteed camp loot, and following a particular map is a different task from finding the nearest mineshaft to your current position.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), data/minecraft/loot_table/chests/abandoned_camp_secret_chest.json; data/minecraft/tags/worldgen/structure/on_mineshaft_maps.json",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "With command permission, /locate structure #minecraft:mineshaft searches both variants. To choose one, put minecraft:mineshaft or minecraft:mineshaft_mesa after /locate structure. Once you arrive, the mineshaft guide explains the rooms, cave-spider spawners and loot you can find inside.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[0]",
            "researchedOn": "2026-10-09",
            "text": "Use /locate structure #minecraft:mineshaft to search both Java variants; use /locate structure minecraft:mineshaft or /locate structure minecraft:mineshaft_mesa to search a specific variant. The structure tag contains exactly those two IDs.",
            "edition": "java",
            "versions": "26.3, vanilla default world generation",
            "source": "Mojang Java 26.3 official inner server JAR (SHA-256 a362163eec5d1612d520772bc16e5b39c09e3b234fdc045f56bf544284ee8ae6), data/minecraft/tags/worldgen/structure/mineshaft.json; structure registry IDs; LocateCommand.register (syntax history independently sourced below)",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ],
    "versions": [
      {
        "text": "In Bedrock 26.50, use /locate structure minecraft:mineshaft in the Overworld. Abandoned-camp chests can also contain explorer maps to mineshafts. We have not confirmed whether these Bedrock maps target only normal mineshafts, as Java maps do; the official release notes leave that detail open.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[1]",
            "researchedOn": "2026-10-09",
            "text": "Use /locate structure minecraft:mineshaft [useNewChunksOnly] in the Overworld. Cheats and Game Directors permission are required; the optional Boolean defaults to false.",
            "edition": "bedrock",
            "versions": "26.50 target; current stable documentation retrieved 2026-10-09; structure subcommand since 1.19.10",
            "source": "Microsoft Learn syntax and StructureFeature enum; command expansion: https://www.minecraft.net/en-us/article/1-19-10-update-out-bedrock; legacy /locate mineshaft applies to 1.18.0/1.19.0 checkpoints",
            "url": "https://learn.microsoft.com/en-us/minecraft/creator/commands/commands/locate?view=minecraft-bedrock-stable",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.inGameFinding[4]",
            "researchedOn": "2026-10-09",
            "text": "Bedrock 26.50 abandoned-camp chests can contain explorer maps leading to mineshafts. The official release notes supply this survival-finding method but do not establish the Java secret-chest pool, its odds or exact destination tag for Bedrock.",
            "edition": "bedrock",
            "versions": "26.50",
            "source": "Official Bedrock 26.50 changelog, Abandoned Camps section",
            "url": "https://www.minecraft.net/en-us/article/minecraft--bedrock-edition-26-50-changelog",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Java 1.18 raised badlands mineshafts and changed the randomness used in Overworld generation. Camp maps arrived later, in Java 26.3 and Bedrock 26.50. Match the finder to the version that generated the area you are searching. The camp-map route depends on those later updates.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.versionHistory[2]",
            "researchedOn": "2026-10-09",
            "text": "Java 1.18 changed Overworld terrain/caves and raised badlands mineshafts; snapshot 21w41a explicitly records the higher badlands placement and a new Overworld random-number generator. The snapshot announcement is evidence of the change, not proof every mineshaft placement algorithm was replaced.",
            "edition": "java",
            "versions": "1.18 development: 21w41a; release-era finding change",
            "source": "Mojang snapshot changelog",
            "url": "https://www.minecraft.net/en-us/article/minecraft-snapshot-21w41a",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.mineshaft.versionHistory[11]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 introduced Abandoned Camp mineshaft maps, adding a Survival locating route without a seed finder.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang Java 26.3 Abandoned Camp Explorer Maps",
            "url": "https://www.minecraft.net/en-us/article/minecraft-java-edition-26-3",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.mineshaft.versionHistory[7]",
            "researchedOn": "2026-10-09",
            "text": "Bedrock 26.50 adds abandoned camps whose chests include mineshaft explorer maps. It is a finding-method change relevant to the latest supported Bedrock checkpoint, not evidence that mineshaft placement spacing changed.",
            "edition": "bedrock",
            "versions": "26.50",
            "source": "Official 26.50 changelog",
            "url": "https://www.minecraft.net/en-us/article/minecraft--bedrock-edition-26-50-changelog",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ]
  },
  "catalogueSummary": {
    "java263": {
      "seeds": 0,
      "locations": 0
    }
  },
  "catalogue": [
    {
      "slug": "zombie-village-cherry-grove",
      "seed": "2734971658",
      "edition": "java",
      "version": "1.20.1",
      "url": "/seeds/java/zombie-village-cherry-grove/",
      "settings": {
        "generation": null,
        "note": "Generation settings are not retained in the catalogue record. Observations apply to the recorded release and locations; creative/spectator inspection and excavations are disclosed in captions."
      },
      "locations": [
        {
          "index": 2,
          "name": "Mineshaft",
          "x": -215,
          "y": -2,
          "z": 115,
          "summary": "Plank bridges with rails cross a big deepslate cave, with a waterfall and lava falls in view."
        }
      ],
      "verification": {
        "version": "1.20.1",
        "checkedAt": "2026-09-29",
        "runId": "2026-09-29T03-16-37-182Z",
        "serverJarSha1": "84194a2f286ef7c14ed7ce0090dba59902951553",
        "toleranceBlocks": 16,
        "results": [
          {
            "label": "Mineshaft",
            "claimed": {
              "x": -215,
              "y": -2,
              "z": 115
            },
            "verdict": "present-at-claim",
            "structure": "minecraft:mineshaft",
            "startChunk": {
              "x": -15,
              "z": 9
            },
            "distance": {
              "horizontal": 0,
              "vertical": 0
            },
            "resultIndex": 2,
            "locationIndex": 2
          }
        ]
      },
      "images": [
        {
          "file": "03-mineshaft-eye-level-east",
          "location": 2,
          "caption": "The mineshaft at y -2.",
          "alt": "Mineshaft plank bridge with rails in a large deepslate cave with a waterfall and a lava fall",
          "sha256": "82cfa4974da5336a334bcfbce809e9caf79bffd51a22d67f8da2d073867e50d6",
          "url": "https://img.seedlookout.com/seeds/zombie-village-cherry-grove/zombie-village-cherry-grove-mineshaft-eye-level-east-960.9b5a9eafc3.webp"
        }
      ],
      "estimatedSpawn": {
        "x": 0,
        "z": 0,
        "y": 78,
        "biome": "Plains"
      },
      "spawnModelWasmSha256": "639eda72563c5076fde931a232880d2ac0d13547a228ee88f8841b59142fb635"
    }
  ],
  "photos": [],
  "referenceImages": [
    {
      "kind": "reference",
      "seedSlug": "natural-reference-2026-10-02t01-12-37-971z",
      "seed": "28462718234064871",
      "edition": "java",
      "version": "26.3",
      "templateId": null,
      "role": null,
      "path": null,
      "variant": "minecraft:mineshaft",
      "label": "Mineshaft",
      "x": -26,
      "y": 25,
      "z": -61,
      "view": "timber-corridor",
      "file": "mineshaft-timber-corridor",
      "alt": "Rails and cobwebs beneath oak support beams in an underground mineshaft corridor",
      "sha256": "df4363748f3583ce0daf9fe91d376c58ee3fcb113b24b265454555a2aab24a31",
      "caption": "Mineshaft at -26, 25, -61, overworld, seed 28462718234064871, Java 26.3. Naturally generated structure, photographed in Minecraft Java 26.3.",
      "note": "Naturally generated structure, photographed in Minecraft Java 26.3.",
      "dimension": "overworld",
      "width": 1440,
      "height": 810,
      "base": "structures/mineshaft/natural-reference-2026-10-02t01-12-37-971z-mineshaft-timber-corridor",
      "url": "https://img.seedlookout.com/structures/mineshaft/natural-reference-2026-10-02t01-12-37-971z-mineshaft-timber-corridor-960.11f8fd7e7b.webp"
    },
    {
      "kind": "reference",
      "seedSlug": "natural-reference-2026-10-02t01-12-37-971z",
      "seed": "28462718234064871",
      "edition": "java",
      "version": "26.3",
      "templateId": null,
      "role": "interior",
      "path": null,
      "variant": "minecraft:mineshaft",
      "label": "Mineshaft",
      "x": -37,
      "y": 25,
      "z": -56,
      "view": "gallery-20261002022521-interior-1",
      "file": "mineshaft-gallery-20261002022521-interior-1",
      "alt": "Mine rails and wooden supports in a natural mineshaft passage",
      "sha256": "00be178256ab0a372e10f370a2700ba4caa1a420f4f263c6eade2e119091b143",
      "caption": "Mineshaft at -37, 25, -56, overworld, seed 28462718234064871, Java 26.3. Naturally generated structure, photographed in Minecraft Java 26.3.",
      "note": "Naturally generated structure, photographed in Minecraft Java 26.3.",
      "dimension": "overworld",
      "width": 1440,
      "height": 810,
      "base": "structures/mineshaft/natural-reference-2026-10-02t01-12-37-971z-mineshaft-gallery-20261002022521-interior-1",
      "url": "https://img.seedlookout.com/structures/mineshaft/natural-reference-2026-10-02t01-12-37-971z-mineshaft-gallery-20261002022521-interior-1-960.ed4d60973f.webp"
    }
  ]
}
