Every other ruin in Minecraft asks you to imagine a room, a hallway, a temple. A ruined portal asks something more specific: a door, half built or half destroyed, that someone was standing in front of when whatever happened to them happened. No floor plan to interpret, no maze to walk. A frame, a few missing blocks, and a chest of belongings dropped beside it like nobody came back for their things.

That directness is what makes ruined portals the most literal narrative object in the game. A stronghold could be read as ceremonial. A ruined portal only reads one way: somebody built a door between worlds, and it did not finish the job it was built for.

This piece is the deep dive on that door: what the loot table says about who packed for the trip, why the game never generates one intact, and what crying obsidian is actually doing there. For the wider "who built everything" question, see the Ancient Builders deep-dive and the complete lore hub. The people on the other side of these doors, the Piglins, get full treatment in the Nether and Piglin lore piece; this article stays on the portals themselves.

As always on this site: Mojang has never published a backstory for ruined portals. Everything below that is not a direct mechanic is flagged as theory, not fact.

What a ruined portal actually is

Mechanically, a ruined portal is a structure, not a broken version of a portal you built. Added in the Java 1.16 Nether Update, the world generator places it fully formed as a partially destroyed obsidian frame, dressed with decay: cracked stone, vines, netherrack scorching, sunken sections, sometimes lava pooling where a floor should be. There are thirteen distinct portal designs, ten normal-sized and three giant, and every one spawns already damaged. The generator has no intact state. Ruined is the only state a ruined portal comes in.

Here is the detail that carries more weight than any other in this article: the ruined portal is the only structure in Minecraft that generates in more than one dimension. Not one of several. The only one. Villages, fortresses, monuments, mansions, cities, every other structure in the game belongs to exactly one world. Portals appear in both, which is precisely what you would expect of the one thing built to connect them.

They generate in every Overworld biome except the Deep Dark, and in every Nether biome as well, so a ruined portal can be sitting on an ocean floor, half-buried under desert sand, in the roof of the Nether above a lava sea, or embedded in a mountainside. Biome context changes the dressing (buried in sand, grown over with vines, flooded on a seabed) but the underlying frame, and the decay, is constant. Finding one in the Nether roof is also a reminder of just how hostile that dimension stays even for its own former visitors: it's the one place in the game where you can't even sleep off the danger.

The loot is the story

If you read nothing else in this article, read the chest. It's the clearest piece of writing Mojang has done on this structure, written entirely in item weights.

The main pool rolls four to eight times from a weighted list that includes:

  • Fire charge and flint and steel - the two most direct ways to light a portal
  • Obsidian (1-2) - the literal building material of the frame
  • Iron nugget (9-18) and flint (1-4) - raw crafting stock
  • Gold nugget (4-24), gold ingot (2-8), and block of gold (rare, low weight) - portable wealth
  • Golden apple, and rarely an enchanted golden apple - emergency survival items
  • Golden carrot and glistering melon slice - more gold-adjacent consumables and brewing stock
  • Enchanted golden armor and tools, generated as individually enchanted pieces
  • Golden horse armor, a clock, a light weighted pressure plate, a bell, and lodestone as rarer or supplementary rolls

A second, smaller pool almost always contributes a stack of lodestone, or occasionally nothing at all.

Read as a checklist, that inventory sorts into two clean categories: tools to build and light a portal (flint and steel, fire charge, spare obsidian), and gold, in almost every form the game has: nuggets, ingots, blocks, golden food, golden gear. Gold is not a random treasure tier here. It is the one currency the Nether's inhabitants, the Piglins, actually respect: wear it and they leave you alone, and the bartering economy that governs the whole dimension runs on it (full detail in the Piglin lore piece). A chest that hands you portal-lighting tools next to a stack of gold nuggets reads, plainly, as someone's Nether kit: what you'd pack knowing exactly where you were headed, and knowing you'd need to buy your way through it.

That is an interpretation, not a fact the game states. But it is an interpretation the loot table supports at every line, and it is the strongest single piece of "somebody was here, and they were prepared" evidence in Minecraft.

Always broken, never finished

The decision to never generate an intact portal is a 1.16 design choice, worth treating as deliberate rather than assumed. A working portal frame is nine or more obsidian blocks in a precise rectangle, lit in the middle. Ruined portals are missing pieces of that rectangle by design: a corner gone, a whole side collapsed, blocks swapped for cracked stone or lava. You cannot walk into one and get teleported. You have to look at the wreckage and understand that it used to work.

That is the entire narrative function of the structure. An intact portal would just be a free convenience object. A portal that always generates broken is a scene: a door someone opened, or was trying to open, that is not open anymore. The obsidian is real obsidian, the frame shape a real frame shape; nothing about it is decorative filler. That's a much more specific image than "old ruin."

Working Nether portal Ruined portal
Frame Complete rectangle, minimum 4x5 Missing blocks by design, every generation
Function Teleports on activation Non-functional as generated
Obsidian source Player-placed World-generated, some converted to crying obsidian
Loot nearby None Chest: portal tools + gold
States generated 1 (complete) 13 designs, all incomplete

The generation logic backs this up further: individual frame blocks have a real chance to be swapped for crying obsidian, a block that cannot be crafted and does not belong in a functioning portal at all. The frame itself has started changing into something else. Whether that reads as time, corruption, or decoration is exactly the kind of gap Mojang leaves open.

Crying obsidian: the only sad block in the game

Crying obsidian deserves its own section because it is genuinely strange, and Mojang has been unusually candid about how arbitrary its origin was without ever explaining what it means.

Mechanically: a luminous obsidian variant, blast resistance 1,200 (the Ender Dragon cannot destroy it), immovable by pistons, light level 10, dripping purple particles from its underside continuously whether anyone is nearby or not. It cannot be crafted. You get it three ways: it generates naturally in ruined portals (roughly a 15% chance per obsidian block in the frame), it appears in bastion remnant chests, and Piglins occasionally hand it back through bartering.

Developer commentary reported around the 1.16 release says the team considered other origins, including obsidian exposed to a portal for a long time, or struck by lightning, before settling on bartering as the acquisition method. Telling detail: the name and the weeping visual design came first, the mechanical justification for obtaining it came second. It is, by name, the only block in Minecraft described as sad, placed specifically in the wreckage of broken doorways, and Mojang has never explained why.

Two-way doors: Overworld and Nether both

Ruined portals aren't an Overworld phenomenon that happens to reference the Nether. They generate independently on both sides, with their own block palettes: Overworld variants dress in stone, stone brick, and iron bars; Nether variants dress in polished blackstone and iron chains, matching Piglin bastion architecture rather than Overworld ruins. A door only generating on one side could be read as a culture reaching outward and never arriving. A door generating identically broken on both sides reads as two-way traffic: people going into the Nether, and evidently also trying to come back, often enough that the wreckage is common world generation, not a rare event.

The Piglin question

Ruined portals sit inside Piglin territory without being Piglin architecture. The frame material is obsidian and stone, not the blackstone-and-gold of bastion remnants, and the wiki records no mob spawns tied specifically to the structure. Worth holding onto: the portal builders and the Piglins read as two different presences, one that built doors and largely isn't here anymore, one that lives in the dimension now with bastions, brutes, and an economy built on the very metal the portal chests are full of. Full case in the Nether and Piglin lore article: the portal chests hand you the exact currency that governs the society standing next to the wreckage.

What is 1.16 design and what is in-fiction "old"

Two different timelines run through this structure, and they're easy to blur together.

As a game feature, ruined portals are recent: added in Java 1.16 (June 2020) as part of the Nether Update, alongside bastion remnants, Piglins, and the current multi-biome Nether. Before that, the Nether was a single wasteland biome with no ruined portals at all.

In-fiction, the structure is written to read as old. World generation places it as pre-existing wreckage: you never see one being built or destroyed, only the aftermath, already grown over, already looted down to the chest. Nothing dates the event. It could sit in the same notional era as the strongholds and Nether fortresses the Ancient Builders theory assigns to a vanished civilization, or it could be recent within the world's own history: other travelers who simply didn't make it. Mojang has not tied ruined portals to any specific era, and neither does this article.

What's canon, what's theory

Canon: ruined portals always generate damaged, with no intact variant. They spawn in nearly every Overworld biome and every Nether biome. Chest loot is weighted toward portal-building tools and gold in multiple forms. Frame obsidian has a chance to generate as crying obsidian, which cannot be crafted and is otherwise obtainable only from bastion chests and Piglin bartering. The structure was added in Java 1.16.

Theory, not confirmed: that crying obsidian "remembers" a failed portal activation; that the portal builders are the same civilization as the Ancient Builders behind strongholds and fortresses; that the missing blocks represent a specific in-fiction event rather than just the structure's designed decay state; any claim about who specifically built them or what happened after. The game gives you the wreckage and stops there.

Frequently asked questions

What is in a ruined portal chest?

Mostly two categories: portal-building tools (flint and steel, fire charge, spare obsidian, iron nuggets, flint) and gold in nearly every form the game has (nuggets, ingots, blocks, golden food, golden gear, occasionally an enchanted golden apple), plus a smaller pool that usually adds lodestone. See the full breakdown above.

Can you repair a ruined portal?

Not automatically. Mine out the damaged sections, fill them with your own obsidian, then light the frame with flint and steel (often found in the portal's own chest). A complete, correctly shaped rectangle then works exactly like any player-built portal.

Why is obsidian crying?

Nobody knows, in-fiction. Crying obsidian can replace regular obsidian in ruined portal frames, appears in bastion loot, and is won through Piglin bartering, but it can't be crafted. Developers considered a "portal exposure" origin and dropped it for bartering instead; the weeping design was never given a lore explanation. That it marks a failed portal activation is community theory, not canon.

Do ruined portals connect the Overworld and Nether when found?

No. They're non-functional as generated, even standing inside the frame. They have to be repaired first.

Were ruined portals always in the game?

No. Added in the Java 1.16 Nether Update (2020), alongside Piglins, bastion remnants, and the current five-biome Nether.

Are ruined portals connected to the Ancient Builders theory?

Not officially. The link is a community inference: both read as evidence of a civilization capable of dimensional travel. Full case in the Ancient Builders deep-dive.

The honest read

A ruined portal does not tell you a story so much as hand you a crime scene and walk away. The frame is real obsidian in a real, working shape, just missing pieces. The chest beside it is a coherent kit: light this door, and if you're headed into Piglin territory, carry gold. The obsidian itself is quietly rotting into a weeping variant Mojang built on purpose and never explained. And it happens on both sides of the door, which means whoever this was, they weren't making a one-way trip.

Nothing here is stated as fact. But nothing needed to be. A broken door, someone's belongings beside it, repeated in both directions, is already a complete sentence. Minecraft just never tells you who was speaking.

Sources & further reading: