{
  "schemaVersion": 1,
  "page": "/tools/ocean-ruins-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, warm ruins start in Warm Ocean, Lukewarm Ocean and Deep Lukewarm Ocean. Cold ruins start in the normal, cold and frozen ocean families, including their deep variants. Warm buildings use sandstone and cold buildings use stone. Choose the ocean family that matches the style you want to find.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.ocean-ruins.placement[0]",
            "researchedOn": "2026-10-09",
            "text": "Ocean ruins generate in the Overworld. Java 26.3 warm ruins require Warm Ocean, Lukewarm Ocean or Deep Lukewarm Ocean; cold ruins require Ocean, Deep Ocean, Cold Ocean, Deep Cold Ocean, Frozen Ocean or Deep Frozen Ocean. These are start-biome eligibility checks, so a whole cluster need not stay inside one biome.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 inner server JAR: data/minecraft/tags/worldgen/biome/has_structure/ocean_ruin_{warm,cold}.json; OceanRuinStructure.findGenerationPoint; Structure.findValidGenerationPoint",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[7]",
            "researchedOn": "2026-10-09",
            "text": "Warm ruins are recognizable by sandstone; cold ruins use stone. Searching the seabed in the appropriate ocean family is more useful than treating every ocean type as a warm-ruin target.",
            "edition": "both",
            "versions": "Mojang article2025-08-14; currentJava biome tags independently confirmed26.3; Bedrock carry-forward26.50",
            "source": "Mojang Building Blocks: Ocean Ruins",
            "url": "https://www.minecraft.net/en-us/article/ocean-ruins",
            "confidence": "medium"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Both styles share one possible starting chunk in each 20 by 20 chunk region, 320 blocks on each side. They have equal selection weights, followed by biome and generation checks. The ocean's temperature still controls which style can start there, and some candidate regions end up without a ruin.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.ocean-ruins.placement[1]",
            "researchedOn": "2026-10-09",
            "text": "The Java 26.3 ocean_ruins structure set uses random_spread with spacing 20 chunks, separation 8 chunks, and salt 14357621. The offset range is 20-8=12 chunks on each axis, selected uniformly (default linear spread); one potential starting chunk is selected in each 20?20-chunk region.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 inner server JAR: data/minecraft/worldgen/structure_set/ocean_ruins.json; RandomSpreadStructurePlacement.getPotentialStructureChunk",
            "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.ocean-ruins.placement[2]",
            "researchedOn": "2026-10-09",
            "text": "Warm and cold entries have weight 1 each in the same Java structure set. If an entry fails its biome check, the generation code can retry the other entry; equal weights do not mean 50% warm ruins in a cold ocean. The set has no exclusion_zone or minimum distance from world origin configured.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 inner server JAR: ocean_ruins.json; ChunkGenerator.createStructures/tryGenerateStructure",
            "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.ocean-ruins.frequency[0]",
            "researchedOn": "2026-10-09",
            "text": "The 20?20 grid means one Java candidate per 400 chunks (a region 320 blocks on each side), before biome and generation checks. It is not a measured ruin count or a promise that traveling 320 blocks finds a ruin; placement candidates on land can fail.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 ocean_ruins.json; Structure.findValidGenerationPoint; existing generation audit",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "The game adjusts the buildings to the seabed. Some starts add smaller buildings around the main ruin, so explore nearby after reaching a finder location. Pieces can be partly buried or reach onto a coast. Their heights follow the local terrain; there is no fixed Y level for every ocean ruin.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-b/facts.json",
            "field": "structures.ocean-ruins.placement[3]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 starts from OCEAN_FLOOR_WG and adjusts each template to supporting ocean-floor terrain. The constructor's Y=90 is an initial anchor, not a guaranteed ruin height. Pieces can be partly buried, and a cluster's additional buildings are not all at the finder start coordinate.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 inner server JAR: OceanRuinStructure.findGenerationPoint; OceanRuinPieces.OceanRuinPiece.postProcess; existing research/structures/ocean-ruins/rooms.md",
            "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.ocean-ruins.frequency[1]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 sets large_probability=0.3 and cluster_probability=0.9 for both temperatures. A large ruin can attempt a cluster of 4–8 surrounding small pieces; these are buildings associated with one start, not 4–8 independent grid placements.",
            "edition": "java",
            "versions": "26.3",
            "source": "Mojang 26.3 structure/ocean_ruin_{warm,cold}.json; OceanRuinPieces.addPieces/addClusterRuins",
            "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.ocean-ruins.placement[6]",
            "researchedOn": "2026-10-09",
            "text": "Cold/warm ocean biome families, partial burial and occasional shore/land extension are also documented for both editions in the November 2025 Minecraft Wiki snapshot. Current Java 26.3 is confirmed directly above; carrying these descriptions to Bedrock 26.50 is plausible but not a fresh Bedrock source audit.",
            "edition": "bedrock",
            "versions": "Wiki snapshot 2025-11; applicability to 26.50 not independently confirmed",
            "source": "Minecraft Wiki historical snapshot, Generation section (mirror because live Wiki fetch was blocked)",
            "url": "https://wiki.ronlab.site/content/minecraftwiki_en_all_maxi_2025-11/Ocean_Ruins",
            "confidence": "medium"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ],
    "in-game": [
      {
        "text": "With command permission in Java 26.3, /locate structure #minecraft:ocean_ruin finds either style. Choose one with /locate structure minecraft:ocean_ruin_warm or /locate structure minecraft:ocean_ruin_cold. Bedrock 26.50 uses /locate structure minecraft:ruins. Run the search in the Overworld using your edition's command.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[0]",
            "researchedOn": "2026-10-09",
            "text": "Java: /locate structure minecraft:ocean_ruin_warm selects warm ruins; /locate structure minecraft:ocean_ruin_cold selects cold ruins; /locate structure #minecraft:ocean_ruin selects either. The structure subcommand dates to Java 1.19; these IDs/tag are present in the 26.3 game data.",
            "edition": "java",
            "versions": "Structure subcommand 1.19+; IDs/tag confirmed26.3",
            "source": "Mojang Java 1.19 changelog; official26.3 structure registry/tag",
            "url": "https://www.minecraft.net/en-us/article/the-wild-update-out-today-java",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[1]",
            "researchedOn": "2026-10-09",
            "text": "Bedrock 26.50: /locate structure minecraft:ruins [useNewChunksOnly]; default=false, true=new chunks only. Cheats required.",
            "edition": "bedrock",
            "versions": "Current stable docs inspected2026-10-09; target26.50",
            "source": "Microsoft Learn locate command reference",
            "url": "https://learn.microsoft.com/en-us/minecraft/creator/commands/commands/locate?view=minecraft-bedrock-stable",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Java 26.3 secret chests in abandoned camps can contain a Warm Ocean Ruins Map. Bedrock 26.50 also adds camp maps to warm ruins. A map gives you another route to that style of building, although you may need to search more than one camp to find one.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[3]",
            "researchedOn": "2026-10-09",
            "text": "In Java 26.3, the Abandoned Camp secret chest loot table includes the Warm Ocean Ruins Map; its destination is #minecraft:on_ocean_ruin_warm_maps, containing ocean_ruin_warm. A map_id filter discards the item if destination creation fails. This is a route to warm ruins, not a guarantee that every camp chest has a map.",
            "edition": "java",
            "versions": "26.3",
            "source": "Official Mojang 26.3 server.jar, inner META-INF/versions/26.3/server-26.3.jar: data/minecraft/loot_table/chests/abandoned_camp_secret_chest.json; tags/worldgen/structure/on_ocean_ruin_warm_maps.json",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[4]",
            "researchedOn": "2026-10-09",
            "text": "Bedrock 26.50 adds camp chest maps leading to warm ocean ruins. The official changelog does not by itself prove which individual camp chest or loot probability supplies that map.",
            "edition": "bedrock",
            "versions": "26.50",
            "source": "Mojang Wilderness Bound changelog",
            "url": "https://feedback.minecraft.net/hc/en-us/articles/48826825649933-Minecraft-Bedrock-Edition-26-50-Changelog-Wilderness-Bound",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "In Java 26.3, look in a ruin's chest for a possible Buried Treasure Map. Brushing suspicious sand or gravel gives archaeology loot. The cartographer's Ocean Monument Map leads to a monument, so look for the camp map when your destination is warm ocean ruins.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[7]",
            "researchedOn": "2026-10-09",
            "text": "Warm ruins are recognizable by sandstone; cold ruins use stone. Searching the seabed in the appropriate ocean family is more useful than treating every ocean type as a warm-ruin target.",
            "edition": "both",
            "versions": "Mojang article2025-08-14; currentJava biome tags independently confirmed26.3; Bedrock carry-forward26.50",
            "source": "Mojang Building Blocks: Ocean Ruins",
            "url": "https://www.minecraft.net/en-us/article/ocean-ruins",
            "confidence": "medium"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[5]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 cartographer trades do not sell Warm Ocean Ruins Maps or Buried Treasure Maps. The ocean-monument trade gives an Ocean Monument Map pointing to #minecraft:on_ocean_monument_maps; that map is not an ocean-ruins finder.",
            "edition": "java",
            "versions": "26.3",
            "source": "Official Mojang 26.3 server.jar, inner META-INF/versions/26.3/server-26.3.jar: data/minecraft/villager_trade/cartographer/3/emerald_and_compass_ocean_monument_map.json; complete villager_trade JSON scan",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.existingResearchIssues[0]",
            "researchedOn": "2026-10-09",
            "file": "research/structures/ocean.json",
            "issue": "Summary wording is ambiguous about which container yields maps: 'Their chests and suspicious blocks hold treasure maps and pottery sherds...' could imply maps are brushed from suspicious blocks.",
            "evidence": "The detailed loot research separates chest maps from archaeology loot. Java 26.3 underwater_ruin_big/small tables contain treasure maps; suspicious-sand/gravel archaeology tables do not. Clarify that maps come from chests.",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.buried-treasure.inGameFinding[3]",
            "researchedOn": "2026-10-09",
            "text": "Find a Buried Treasure Map in the map chest of a shipwreck, or as a loot outcome in a small or big ocean-ruin chest. It points to the buried-treasure structure tag with a red X. A shipwreck's map-chest table attempts one map entry, but a wreck need not expose that chest and26.3 discards maps that cannot acquire a destination.",
            "edition": "java",
            "versions": "26.3",
            "source": "Official Mojang 26.3 server.jar, inner META-INF/versions/26.3/server-26.3.jar: data/minecraft/loot_table/chests/shipwreck_map.json; underwater_ruin_small.json; underwater_ruin_big.json; tags/worldgen/structure/on_treasure_maps.json",
            "url": "https://piston-data.mojang.com/v1/objects/33680f5f2ac32864d6d7cf5e56a705fdb3e05f4c/server.jar",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ],
    "versions": [
      {
        "text": "Java 1.16 made ocean ruins less common, starting in snapshot 20w06a. Match the finder to the version that generated the area you plan to explore. The warm-ruin camp maps arrived in Java 26.3 and Bedrock 26.50, adding a way to find them in those updates.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.versionHistory[1]",
            "researchedOn": "2026-10-09",
            "text": "Java snapshot 20w06a, released into1.16, made ocean ruins less common. This is a genuine placement-history reason to choose the world's generation version rather than simply its currently installed version.",
            "edition": "java",
            "versions": "20w06a → 1.16",
            "source": "Mojang snapshot 20w06a changelog",
            "url": "https://www.minecraft.net/en-us/article/minecraft-snapshot-20w06a",
            "confidence": "high"
          },
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.versionHistory[3]",
            "researchedOn": "2026-10-09",
            "text": "Java 26.3 and Bedrock 26.50 introduced camp maps targeting warm ocean ruins. This changes how players can find warm ruins without a seed tool; it does not by itself prove the ruin placement grid moved.",
            "edition": "both",
            "versions": "Java 26.3; Bedrock 26.50",
            "source": "Mojang Java 26.3 and Bedrock 26.50 release notes",
            "url": "https://www.minecraft.net/en-us/article/minecraft-java-edition-26-3",
            "confidence": "high"
          }
        ],
        "datasets": [],
        "seedPages": []
      },
      {
        "text": "Java has separate warm and cold structure IDs and a tag that searches both. Bedrock's documented ruins ID covers the structure as a whole. Use the command for your edition even though the buildings in both editions are described as warm sandstone ruins or cold stone ruins.",
        "sourceClaims": [
          {
            "record": "research/seo/finder-pages-2026-10-09/codex-a/facts.json",
            "field": "structures.ocean-ruins.editionDifferences[2]",
            "researchedOn": "2026-10-09",
            "text": "Current Bedrock /locate uses minecraft:ruins for either temperature. Current Java exposes minecraft:ocean_ruin_warm and minecraft:ocean_ruin_cold, plus the #minecraft:ocean_ruin structure tag.",
            "edition": "both",
            "versions": "Java 26.3 game data; Bedrock stable command docs inspected 2026-10-09",
            "source": "Java 26.3 tags/worldgen/structure/ocean_ruin.json; Microsoft Learn StructureFeature enum",
            "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-a/facts.json",
            "field": "structures.ocean-ruins.inGameFinding[7]",
            "researchedOn": "2026-10-09",
            "text": "Warm ruins are recognizable by sandstone; cold ruins use stone. Searching the seabed in the appropriate ocean family is more useful than treating every ocean type as a warm-ruin target.",
            "edition": "both",
            "versions": "Mojang article2025-08-14; currentJava biome tags independently confirmed26.3; Bedrock carry-forward26.50",
            "source": "Mojang Building Blocks: Ocean Ruins",
            "url": "https://www.minecraft.net/en-us/article/ocean-ruins",
            "confidence": "medium"
          }
        ],
        "datasets": [],
        "seedPages": []
      }
    ]
  },
  "catalogueSummary": {
    "java263": {
      "seeds": 0,
      "locations": 0
    }
  },
  "catalogue": [],
  "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:ocean_ruin_warm",
      "label": "Ocean Ruins",
      "x": -595,
      "y": 48,
      "z": 131,
      "view": "close-south",
      "file": "ocean-ruins-close-south",
      "alt": "Sandstone walls of warm ocean ruins among underwater kelp",
      "sha256": "ee918498df062c234aac5e6aa8f4a8e790ec2bd1e4ebe4c4fd109277654bf924",
      "caption": "Ocean Ruins at -595, 48, 131, 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/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-close-south",
      "url": "https://img.seedlookout.com/structures/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-close-south-960.a04c6e1d5e.webp"
    },
    {
      "kind": "reference",
      "seedSlug": "natural-reference-2026-10-02t01-12-37-971z",
      "seed": "28462718234064871",
      "edition": "java",
      "version": "26.3",
      "templateId": null,
      "role": "exterior",
      "path": null,
      "variant": "minecraft:ocean_ruin_warm",
      "label": "Ocean Ruins",
      "x": -595,
      "y": 48,
      "z": 131,
      "view": "gallery-20261002022521-angle-1",
      "file": "ocean-ruins-gallery-20261002022521-angle-1",
      "alt": "Sandstone pillars of ocean ruins surrounded by kelp",
      "sha256": "a6168fa58eb447f746bc3291363f2dfc31083b4b6cfcb11a48d6f4a3db2ac9d7",
      "caption": "Ocean Ruins at -595, 48, 131, 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/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-gallery-20261002022521-angle-1",
      "url": "https://img.seedlookout.com/structures/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-gallery-20261002022521-angle-1-960.e28518527d.webp"
    },
    {
      "kind": "reference",
      "seedSlug": "natural-reference-2026-10-02t01-12-37-971z",
      "seed": "28462718234064871",
      "edition": "java",
      "version": "26.3",
      "templateId": null,
      "role": "exterior",
      "path": null,
      "variant": "minecraft:ocean_ruin_warm",
      "label": "Ocean Ruins",
      "x": -595,
      "y": 48,
      "z": 131,
      "view": "gallery-20261002022521-angle-3",
      "file": "ocean-ruins-gallery-20261002022521-angle-3",
      "alt": "Close view of sandstone and chiseled blocks in ocean ruins",
      "sha256": "1279919b4e1b33c627880e9f11459710ff62affc830444d33dfd64bebd96a286",
      "caption": "Ocean Ruins at -595, 48, 131, 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/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-gallery-20261002022521-angle-3",
      "url": "https://img.seedlookout.com/structures/ocean-ruins/natural-reference-2026-10-02t01-12-37-971z-ocean-ruins-gallery-20261002022521-angle-3-960.ae76c16b5b.webp"
    }
  ]
}
