Description
Diorama draws your world as a map seen from above at an angle, so it looks like a model on a table. Towers stand up, cliffs have faces, and trees cast shadows. You get a minimap in the corner and a fullscreen map you can pan and zoom.
How the map looks
The map looks north and down at 50°, so you see the tops of blocks and their south faces. Diorama ray traces every pixel through the actual blocks, so overhangs, bridges and tree canopies come out right instead of flattening into their top layer.
- A low sun casts long shadows, and the ground under trees and overhangs is darker.
- Higher ground is a little brighter, so hills still read as hills when you zoom far out.
- Water gets darker the deeper it is.
- If you'd rather have a flatter map, turn off Depth shading in the settings.
Zoom runs from single blocks out to about 10,000 blocks across. Diorama saves everything your game loads, per world and dimension, so the map is still there next time and you can zoom out over everywhere you've been. Places you haven't explored sit under drifting fog.
Caves and the Nether
Underground, the map switches to a cave view: a slice through the world a few blocks above your head, lit by torches and other block light. PgUp and PgDn move the slice up and down. In the Nether, the map shows everything under the bedrock roof.
Radar, waypoints and overlays
- Radar. Other players and mobs show on the map as their own faces, framed red, yellow or green for hostile, neutral or passive, with a marker if they're above or below you.
- Waypoints. They show on the map and as labels in the world, and you get one wherever you die. You can share a waypoint in chat. Shared waypoints, including ones from Xaero's Minimap, get an [Add] link. If you're allowed to use
/tp, you can teleport to a waypoint. - Overlays. The fullscreen map can show the chunk grid, slime chunks (singleplayer only) and the spots where monsters can spawn.
Keys
| Key | What it does |
|---|---|
M |
Open the fullscreen map. Drag to pan, scroll to zoom, right-click to add a waypoint. |
B |
Add a waypoint where you're standing |
U |
List your waypoints |
= / - |
Zoom the minimap |
C |
Switch the fullscreen map to the cave view |
Space |
Center the fullscreen map on you again |
Every setting is behind the Settings button on the fullscreen map. On a slower computer, set Quality to Fast: the map fills in faster and the fog costs less to draw.
On servers
Diorama runs entirely on your side. You install it in your game, and servers don't need it. Each world on a server gets its own map and waypoints, even several worlds behind one address, like a network's lobby and survival worlds.
Servers can limit it with the same chat codes Xaero's Minimap uses:
- Fair play turns the radar off, and the cave view only shows blocks you've actually seen.
- No minimap turns the map off.
Requirements
- Minecraft 26.3 or 1.21.11. Download the file for your version.
- Fabric Loader 0.19.5 or newer
- Fabric API
- Java 25 for Minecraft 26.3, Java 21 for 1.21.11. The Minecraft launcher brings the right one.
Bug reports and source code live on GitHub.


