# Install a downloaded Minecraft map so it shows up in Singleplayer

> Markdown version of https://stella.sh/how/game-mods/install-minecraft-map for agents and LLMs.
> A downloaded map only appears in Singleplayer when its folder with level.dat sits directly in saves. Unzip it the right way by hand, or let Stella (stella.sh) put it in.

Unzip the download and find the folder that contains `level.dat`: that folder, not the one around it, goes into `.minecraft/saves`. Many map zips wrap it in an extra folder with a readme (and a `__MACOSX` folder from a Mac), so the game never lists it. Stella (stella.sh) unpacks the map, finds the real world folder, copies just that into saves, and tells you which game version the map was made for.

- Checked: 13 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 13 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: Installed in about 70 seconds. Checked afterwards against an answer key written before the run: the map sits one level below saves with its level.dat, all 8 map files intact, the two existing worlds untouched, no `__MACOSX` junk and no empty wrapper folder in saves. File-level check only: no Minecraft account was used and the game was never launched. The map is a stand-in made for this run, zipped the way many map sites ship them. The work is sped up 2×.

Video (45 s): https://stella.sh/media/proofs/game-mods/install-minecraft-map/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. A downloaded map zip is in Downloads.
- 0:01 The prompt: put Skyblock Classic in so it shows up in Singleplayer.
- 0:15 Stella replies that it will unpack it, copy the world into saves and say which version it's for.
- 0:21 Unpacking and installing, sped up 2×.
- 0:30 Done: the map will show as “Skyblock Classic”, made for 1.21.4, and the other worlds weren't changed.

What Stella does:

1. Finds the Skyblock Classic zip in Downloads and looks inside: the world sits a folder deeper than the game expects, next to a readme and Mac junk files
2. Finds your game folder; with more than one Minecraft install, it uses the one played most recently
3. Copies only the real world folder (the one holding `level.dat`) into saves, without the wrapper, readme or `__MACOSX` files
4. Reads the map's level.dat for the version it was made for (Java 1.21.4) and checks your launcher has it
5. Leaves your existing worlds and the original zip as they were

## The prompt to paste

```text
I downloaded a Minecraft map called Skyblock Classic. It's in my Downloads. Can you put it in so it shows up in my singleplayer worlds?
```

## Install it yourself

1. **Unzip the download.** Windows: right-click the zip, Extract All. Mac: double-click it. You get a folder; open it.
2. **Find the folder with level.dat.** Keep opening folders until you see `level.dat` alongside a `region` folder. The folder that holds those is the world. Ignore readme files, changelogs and any `__MACOSX` folder.
3. **Open your saves folder.** Windows: Win+R, `%appdata%\.minecraft\saves`. Mac: Finder, Go, Go to Folder, `~/Library/Application Support/minecraft/saves`. Linux: `~/.minecraft/saves`. Launchers with instances (Prism, CurseForge) have a `saves` folder inside each instance.
4. **Copy in the world folder.** Drag the folder that contains `level.dat` into saves. If a world with the same folder name already exists, rename the new one first so nothing is overwritten.
5. **Open Singleplayer.** Start the game (or go back to the title screen) and open Singleplayer. The map is listed by its own name. If the game warns the world was made in a newer version, update the game or choose a version of the map that matches.

## Where Stella stops

- Checked at file level only: no Minecraft account was used and the game wasn't launched.
- Java maps only. Bedrock maps come as `.mcworld` files, which you open by double-clicking.
- A map built for a newer version may not load in an older game. Stella reads the version from the map and tells you.
- Only download maps from sites you trust. Stella installs the file you give it; it doesn't vet the map maker.
- Recorded on Linux. On Windows and Mac the saves folder is in a different place (above); Stella looks in the usual places for each.

## Questions

**Why doesn't my downloaded map show up in Minecraft?**
Almost always it's one folder too deep: saves contains a folder that contains the world folder. Move the inner folder, the one with `level.dat`, directly into saves.

**Do I need to unzip a Minecraft map?**
Yes, for Java. The game reads world folders, not zips. (Bedrock's `.mcworld` files are the exception: double-click to import.)

**Can I play a map made for an older version?**
Usually yes; the game upgrades it when you open it. Make a [backup of the world](https://stella.sh/how/game-mods/back-up-minecraft-worlds) first, because you can't go back to the older version after.

**How do I turn on cheats in a downloaded map?**
Most adventure maps want cheats off. If you want them on for good, see [turn on cheats in an existing world](https://stella.sh/how/game-mods/turn-on-cheats-in-minecraft-world).

**Is Stella free for this?**
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.

**Can I control what Stella changes on my computer?**
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.

Sources: [Minecraft Wiki: Tutorial: Map downloads](https://minecraft.wiki/w/Tutorial:Map_downloads), [Minecraft Wiki: .minecraft folder](https://minecraft.wiki/w/.minecraft).

## Related problems

- [Back up all your Minecraft worlds and move them to a new computer](https://stella.sh/how/game-mods/back-up-minecraft-worlds.md)
- [Turn on cheats in a Minecraft world you already made, permanently](https://stella.sh/how/game-mods/turn-on-cheats-in-minecraft-world.md)
- [How to install a Minecraft resource pack that isn't showing up](https://stella.sh/how/game-mods/install-minecraft-resource-pack.md)
- [Install Sodium and Iris on Minecraft 1.21 (Fabric)](https://stella.sh/how/game-mods/install-sodium-iris-minecraft-1-21-fabric.md)
- [Minecraft modpack crashing with exit code 1? Find the real error](https://stella.sh/how/game-mods/minecraft-modpack-exit-code-1.md)
- [How to allocate more RAM to Minecraft and stop out of memory crashes](https://stella.sh/how/game-mods/allocate-more-ram-to-minecraft.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
