Minecraft · mod

Diorama mod for Minecraft: versions, loaders and how to install (November 2026)

Diorama is a client-side minimap and world map mod that draws your world at an angle, for Fabric, NeoForge and Forge, with Minecraft versions from 1.20.1 to 26.3.

Facts last checked
Loaders
Fabric, NeoForge, Forge
Fabric and NeoForge cover many versions. Forge is 1.20.1 only, and needs Forge 47.1 or later. Fabric also needs Fabric API.
Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama
Minecraft versions
1.20.1 to 26.3
Fabric lists 1.20.1, 1.21 to 1.21.11 and 26.1 to 26.3. NeoForge lists selected versions from 1.21 to 26.3. The exact lists are in the versions section below.
Sources: Modrinth: Diorama · CurseForge: Diorama
Side and license
Client-side, MIT
The mod pages say it runs in your game and servers do not need it. The license is shown as MIT.
Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama

What the Diorama mod does

Diorama is a minimap and world map for Minecraft. It draws your world at an angle, like a small model on a table.

The map pages say towers, cliffs and trees show up with shape and shadows, instead of a flat top-down picture. Source: Modrinth: Diorama

Minimap: a corner minimap, square or round, with a compass, your coordinates and the biome. Sources: Modrinth: Diorama · CurseForge: Diorama

Fullscreen map: drag and zoom, out to about 10,000 blocks. Explored areas are saved, with fog over places you have not seen, and a world can have more than one map. Sources: CurseForge: Diorama · GitHub: SunkenInTime/diorama

Cave view and Nether view. The Modrinth page also lists day and night lighting, where torches and lava give light. Sources: CurseForge: Diorama · Modrinth: Diorama

Radar: shows players and mobs, colored by how hostile they are. Modrinth also lists dropped items. Sources: CurseForge: Diorama · Modrinth: Diorama

Waypoints with icons or letters, death markers, bed pins and folders, plus a right-click menu to add a waypoint or share a spot in chat. You can teleport from the menu if you have the /tp command. Sources: CurseForge: Diorama · Modrinth: Diorama

Drawing tools: freehand lines, shapes, notes and distance measuring. You can export the map, or a selected area, as an image. Sources: CurseForge: Diorama · Modrinth: Diorama

Default keys, changeable under Controls: M opens the fullscreen map, B adds a waypoint where you stand, U lists waypoints, and = and - zoom the minimap. On the fullscreen map, C switches between surface and cave view. Sources: GitHub: SunkenInTime/diorama · Modrinth: Diorama

The creator shown on CurseForge is SunkenInTime. The mod is MIT licensed and its source is on GitHub. Sources: CurseForge: Diorama · GitHub: SunkenInTime/diorama

Supported versions and loaders

Pick the line that matches your Minecraft version and loader. The lists below are what the CurseForge and Modrinth pages showed on November 17, 2026.

Fabric

Minecraft 1.20.1, 1.21 to 1.21.11, and 26.1 to 26.3. Needs Fabric API. Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama

NeoForge

Minecraft 1.21, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11, 26.1.2, 26.2 and 26.3. Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama

Forge

Minecraft 1.20.1 only, with Forge 47.1 or later. Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama

Latest version

CurseForge showed version 0.10.2, updated November 16, 2026. Versions change often, so check the file list for the current one. Source: CurseForge: Diorama

Requirements

Fabric players need Fabric API. The mod pages list no other required mods.

Fabric: install Fabric API next to Diorama. Sources: Modrinth: Diorama · GitHub: SunkenInTime/diorama

NeoForge: no extra mod is listed. Sources: Modrinth: Diorama · CurseForge: Diorama

Forge: Minecraft 1.20.1 with Forge 47.1 or later. No extra mod is listed. Sources: Modrinth: Diorama · CurseForge: Diorama · GitHub: SunkenInTime/diorama

Works with, not required: Xaero’s Minimap, radar icon packs, Waystones, Create copycats and FTB Chunks. Modrinth also names Pixelmon. Sources: CurseForge: Diorama · Modrinth: Diorama · GitHub: SunkenInTime/diorama

How to install the Diorama mod

Install a loader, then put the matching Diorama file in the mods folder. The steps are the general ones for any mod.
  1. 1Pick your version and loaderDecide which Minecraft version you play and whether you use Fabric, NeoForge or Forge. Check it against the versions section above. Forge works only on 1.20.1.
  2. 2Install the loaderInstall Fabric, NeoForge or Forge for that exact Minecraft version, and start the game once with the new profile. For Fabric, also get Fabric API.
  3. 3Get the Diorama file from the official pageOpen the Diorama page on CurseForge or Modrinth, or the GitHub project, and download the file for your Minecraft version and loader. Do not use re-upload sites.
  4. 4Put it in the mods folderCopy the file into the mods folder of the profile or instance you will play. Do not unzip it.
  5. 5Check the dependency listFabric needs Fabric API in the same mods folder. Then start the profile and press M in a world to open the fullscreen map.

Compatibility and known issues

Diorama runs in your own game. Servers do not need it, but they can limit it.

On servers: each world gets its own map and waypoints. Servers can limit Diorama with the same chat codes Xaero’s Minimap uses, where “fair play” turns off the radar and “no minimap” turns off the map. Sources: GitHub: SunkenInTime/diorama · Modrinth: Diorama

Worlds that share a seed share a map, unless the server sends level IDs. In singleplayer, the map can fill in from the world save. Source: GitHub: SunkenInTime/diorama

A server can also run the mod to host a map you view in a web browser. The GitHub project points to a web-map doc for this. Source: GitHub: SunkenInTime/diorama

Settings are saved in .minecraft/diorama/config.json, and maps and waypoints are saved in .minecraft/diorama/, one folder per world. On slower computers, the Modrinth page suggests setting Quality to Fast in Settings. Sources: GitHub: SunkenInTime/diorama · Modrinth: Diorama

The GitHub project showed 36 open issues on November 17, 2026. Report bugs there, not in the comments of a download site. Source: GitHub: SunkenInTime/diorama

Other mods with “Diorama” in the name

This page covers the minimap mod above. A different mod uses a similar name.

SableCraft: Diorama on CurseForge is by a different creator, sablednah. It turns a server into an isometric web map that players view in a browser, and it lists NeoForge for Minecraft 1.21.11 and 26.1 to 26.3. It is not the minimap mod on this page. Source: CurseForge: SableCraft: Diorama (a different mod)

Safety

Get the file only from the mod’s own page. Never from a re-upload or mirror site.

The official places are the CurseForge page, the Modrinth page and the GitHub project, all linked below. Search results also show other sites that copy mod listings. Skip them. Sources: CurseForge: Diorama · Modrinth: Diorama · GitHub: SunkenInTime/diorama

Match the file name to your Minecraft version and loader. A file for the wrong loader will not load.

A mod is a program file. Keep a backup of your world before you add a mod to it.

Frequently asked questions

What is the Diorama mod for Minecraft?

It is a minimap and world map mod that draws your world at an angle, like a model on a table. It has a fullscreen map, radar, waypoints and drawing tools.

Which loaders and versions does Diorama support?

Fabric (1.20.1, 1.21 to 1.21.11, 26.1 to 26.3), NeoForge (selected versions from 1.21 to 26.3) and Forge (1.20.1 only). Fabric needs Fabric API. We checked this on November 17, 2026.

Does a server need the Diorama mod?

No. The mod pages say it runs in your game and servers do not need it. Servers can limit it with the same codes as Xaero’s Minimap.

Does Diorama need Fabric API?

Only on Fabric. The pages list no required mod for NeoForge or Forge.

Is the SableCraft Diorama mod the same thing?

No. SableCraft: Diorama is by a different creator and makes a browser web map of a server. The minimap mod on this page is a separate project.

Sources and last check

Every fact above links to one of these pages. We last checked all of them on . Rumors are not stated as facts on this page.
  1. OfficialCurseForge: DioramaChecked
  2. OfficialModrinth: DioramaChecked
  3. OfficialGitHub: SunkenInTime/dioramaChecked
  4. PlatformCurseForge: SableCraft: Diorama (a different mod)Checked

Not affiliated with or endorsed by the Diorama mod’s creator or Mojang. We offer no downloads and link only to the mod’s own CurseForge, Modrinth and GitHub pages.

More Minecraft games