How to install a Minecraft map: Java and Bedrock, step by step

What a Minecraft map is

A Minecraft map is simply a saved game world in the form of a file or folder. Every world you create by clicking "Create New World" is saved automatically as a separate folder holding information about the terrain, the player's inventory, mobs, block positions and every change you've made. A "custom" map (parkour, skyblock, adventure and so on) is a world someone else built and shared for download.

Map file formats

• World folder (Java Edition): the plain folder structure with a level.dat file and the subfolders region (pieces of the world), data, playerdata and so on. You drop the whole folder into saves.
• .zip (Java Edition): a compressed version of the world folder. The most common download format, and you have to extract it before use.
• .mcworld (Bedrock Edition): Bedrock's own format. Just double-click it and Minecraft Bedrock imports the map by itself.
• .mctemplate (Bedrock Edition): a world template: every player who imports it gets a fresh copy. Used for multiplayer minigames.
• .mcpack (Bedrock Edition): a resource pack or behavior pack. This isn't a world but an add-on that changes how the game looks or behaves.

Important: don't confuse a map with a "world" in the sense of a resource pack. Sometimes you'll download a .mcpack file thinking it's a map, when it's actually an add-on that changes textures or mobs. Check the description on the creator's page before you download.

Java vs Bedrock: format differences

The most important point: maps for Java Edition and Bedrock Edition aren't compatible. You can't drop a Java map straight into Bedrock or the other way around. This comes from differences in the game engine: Java and Bedrock use completely different save data formats and chunk systems, some mobs behave differently, and redstone works differently.

Converting maps between Java and Bedrock

Some programs (such as Chunker, MCC Toolchest and MCA Selector) can convert maps from Java to Bedrock and back. They aren't perfect: some blocks, redstone and command contraptions, NBT data and mob mechanics may not carry over. The free Chunker by Hive Games (funded by Mojang, but not a Mojang product) works best with vanilla maps. For step-by-step instructions, see our guide on how to move a world from Java to Bedrock. For maps with mods and resource packs, conversion is practically out of the question.

Save folder locations

The first thing to do before installing a map is to find Minecraft's saves folder. Here are the locations for each system:

Java Edition

On Windows, the quickest way is to press Win + R, type %appdata%\.minecraft\saves and click OK: the folder opens straight in File Explorer. On macOS the "Library" folder is hidden by default, so in Finder press Cmd + Shift + G and paste the path. On Linux, cd ~/.minecraft/saves in a terminal is all it takes.

Bedrock Edition

On Bedrock for Windows 10/11, the quickest way to open this folder is to type this into the Start menu: %localappdata%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang. On consoles (Xbox, PlayStation, Switch), direct access to the file system is locked, so you have to install maps through the Marketplace or through Microsoft Cloud Sync from a computer.

Installing a .zip map in Java Edition, step by step

This is the most common case. Most maps on CurseForge, Modrinth and PlanetMinecraft come as a .zip archive. Here's what to do:

1. Download the .zip file from a trusted source (CurseForge, Modrinth, PlanetMinecraft). Check that the creator lists a Minecraft version that matches yours (for example 1.21.x).
2. Open the saves folder: Windows: %appdata%\.minecraft\saves; macOS: ~/Library/Application Support/minecraft/saves; Linux: ~/.minecraft/saves.
3. Extract the .zip file: on Windows, right-click it → "Extract All" or "Extract Here". On macOS, double-click it and Archive Utility extracts the archive automatically. On Linux, use unzip map_name.zip.
4. Check the structure: after extracting, you should have a folder that directly contains the level.dat file and the subfolders region, data and playerdata. If you see a folder inside a folder (for example "MyMap/MyMap/level.dat"), move the inner folder up a level.
5. Move the map folder into saves: copy the whole folder (for example "Parkour-Paradise") into the saves folder.
6. Launch Minecraft Java Edition in a matching version (if the map is for 1.21, play on 1.21 or a newer, backward-compatible version).
7. Click "Singleplayer": the new map appears in the list. Select it and click "Play Selected World".

Installing a map as a world folder (Java), manually

Sometimes the creator shares the map as a ready-made folder (for example uploaded to Google Drive, or as an uncompressed .rar). Installation works exactly like a .zip, minus the extraction step:

1. Download the map folder (for example from Google Drive with "Download" on the whole folder, which gives you a .zip that you then extract, or directly from a repository).
2. Open the saves folder (Windows/macOS/Linux, as in the section above).
3. Copy the map folder straight into saves. Make sure the structure is: saves/MapName/level.dat, saves/MapName/region/, saves/MapName/data/.
4. Launch Minecraft Java Edition and pick the map from the Singleplayer list.

Copying manually from a USB drive or the cloud

If someone sent you a map on a USB stick, Google Drive, Dropbox or OneDrive, make sure you're downloading the whole folder (not just level.dat!). Minecraft maps are complete folders, not single files. Google Drive usually offers "Download" on a folder, which packs it into a .zip automatically.

You can also use MultiMC or Prism Launcher, launchers that offer game instances and easy world management. In MultiMC you click "Worlds" in your instance and drag the .zip file or folder straight onto the list.

Installing a .mcworld map in Bedrock Edition

Bedrock Edition makes the process much simpler, since Mojang built it to be user-friendly. Here's how to install a .mcworld map:

Windows 10/11, iOS, Android

1. Download the .mcworld file from a trusted source.
2. Double-click the file (Windows), or open it in the Files app and choose to open it with Minecraft (iOS, Android).
3. Minecraft launches automatically and imports the map.
4. When the import finishes, you'll see the message "World imported successfully".
5. Go to "Play" → "Worlds": the new map appears in the list.

Xbox, PlayStation, Nintendo Switch

Consoles give you no direct access to the file system, so you can't install a map from a .mcworld file the usual way. The alternatives:

• Microsoft Cloud Sync: install the map on Windows 10 (or a mobile device), sign in to the same Microsoft account and turn on "Cloud Sync": the map syncs to your console.
• Realms: the owner of a Realms server can import the map and let console players join.
• Marketplace: official paid maps can be bought through the Marketplace right on the console.

Manual installation in the minecraftWorlds folder

If the automatic installation failed (for example because the .mcworld file is damaged), you can try the manual method:

1. Change the .mcworld extension to .zip.
2. Extract the archive (Windows: right-click → "Extract All"; macOS: double-click).
3. Copy the extracted folder into minecraftWorlds (the paths are in the "Save folder locations" section).
4. Launch Minecraft Bedrock: the map appears in the list.

How to share a map with friends

If you want your friends to play on the same map, you have a few options:

1. LAN (local network)

The simplest way for family games in one home. In Java Edition: load the map, press ESC, click "Open to LAN", choose the game mode and click "Start LAN World". Friends on the same network will see the game in the Multiplayer tab.

In Bedrock: open the map, and friends on the same Wi-Fi network will see it automatically under "Friends" → "LAN Games".

2. Dedicated server

For a bigger group (5+ players) or for playing over the internet, you set up your own server. You put the map folder in place of the world folder in the server directory. Details: how to make a Minecraft server.

3. Realms (paid, from Mojang)

Mojang's official hosting, 8 USD/month for 11 players. You upload the map through the built-in Minecraft client: no configuration, no ports, no IP. The most convenient choice for non-technical users.

4. Free hosting (Aternos, Minehut, Falixnodes)

For occasional games with friends, free server hosting is enough. You upload the map as a "custom world", the server imports it, and your friends connect through the IP the host gives you.

5. Sharing the file

The simplest option: pack the map folder into a .zip and send it through Google Drive, WeTransfer or Discord. Each friend installs the map locally and you all play in your own separate worlds (progress isn't synced).

The map doesn't show up: troubleshooting

The most common problem after installing: you launch Minecraft and the map isn't in the Singleplayer list. Here's a checklist to fix it:

1. Check the folder structure

Open saves/MapName/. Do you see level.dat right there? If not, and you see another folder instead (for example saves/MapName/MapName/level.dat), that's the cause. Move the inner folder up one level.

2. Check whether you're playing Java or Bedrock

.zip maps are for Java, .mcworld maps are for Bedrock. If you downloaded a .zip and you're trying to play it in Bedrock, it won't work. Check the map description and the Minecraft version you play.

3. Check your Minecraft version

A map made in version 1.21 may not work in 1.15 (the new blocks are missing). The other way around (old map, new game) usually works thanks to world upgrading. Make sure your Minecraft version is the same as or newer than the one the map requires.

4. Check that you launched the right installation

The Minecraft Launcher lets you have many installations (modded, vanilla, different versions). The saves folder is shared, but if you're playing on a modded installation, some maps may refuse to load (a "missing mod content" error). Launch a clean vanilla installation.

5. Restart Minecraft

Not every change to the saves folder is picked up right away. If Minecraft was running while you copied the files, close it completely and start it again.

6. Check the folder name

Special characters such as Polish diacritics (ą, ę, ś, ć, ź, ż, ó, ł, ń) in the folder name can cause problems on some systems. Rename the folder to a name without them (for example "ParkourLatwy" instead of "ParkourŁatwy").

Minecraft version requirements

Every map is made in a specific Minecraft version and uses the blocks, mobs and mechanics available in that version. These are the basic compatibility rules:

• Old map, new game (backward compatibility): usually works. Minecraft automatically upgrades older structures to newer ones (for example, a map from 1.12 will work in 1.21). Minor issues sometimes show up (such as outdated villages or changed crafting recipes).
• New map, old game (forward compatibility): usually doesn't work. A map from 1.21 (with Copper Grate blocks) won't load in 1.17: you'll get an error or missing blocks. In that case, update Minecraft.
• Snapshot / experimental version: maps made in a snapshot may not work in the stable release. Check the creator's description.

How to check a map's version

Open the map folder and open the level.dat file in an NBT editor (such as NBTExplorer): you'll see the field Version → Name, which shows the exact Minecraft version the map was last saved in. You can also check the description on the creator's page, which usually lists compatibility.

How to check your Minecraft version

In the Minecraft Launcher, you'll see the current version in the bottom-left corner. You can also launch the game and check the number in the bottom-left corner of the main menu. To play a different version, create a new installation ("Installations" → "New installation" → pick the version).

Common errors and how to fix them

"World failed to import" (Bedrock)

A typical error with .mcworld files. Causes:

• Broken download: the file didn't download completely. Delete it and download it again.
• Map version too old: the map was made in a very old version of Bedrock that needs upgrading.
• The file isn't a real .mcworld: check that the creator didn't upload a .mcpack by mistake (that's a resource pack, not a world).

The fix: rename the extension to .zip, extract it and copy it manually into the minecraftWorlds folder.

"Corrupted world" / "Chunk error" (Java)

An error caused by damaged chunks. Causes:

• The map got damaged while downloading (check the MD5 checksum if the creator provides one).
• The game was shut down incorrectly (a crash while saving).
• The map was edited with an external tool (MCEdit, Amulet) that introduced errors.

The fix: download the map again, restore a backup, or try MCC Toolchest to repair the chunks.

"Out of memory" (OOM): Java

Minecraft Java Edition gets 2 GB of RAM by default, which isn't enough for large maps. If you get a crash with the message "java.lang.OutOfMemoryError", raise the allocation:

1. Open the Minecraft Launcher.
2. Go to "Installations", pick your installation and click "Edit".
3. Click "More Options", and in the "JVM Arguments" field change -Xmx2G to -Xmx6G (6 GB) or -Xmx8G (8 GB, if you have 16 GB of RAM).
4. Save and launch the game again.

More in our guide on how to increase FPS in Minecraft.

"Missing blocks"

The map loads, but you see pink-and-black "missing texture" blocks or missing elements. Causes:

• The map needs a resource pack you don't have installed.
• The map needs a mod (for example blocks from Tinkers' Construct), and you're playing vanilla.
• Your Minecraft is too old for some of the blocks.

Check the map description for requirements and install the packs you need.

"Map won't load past 0%": stuck on loading

The map starts loading but stops at 0%. Causes: not enough RAM, a corrupted chunk at spawn, a version mismatch. The fix: add more RAM, check the logs (.minecraft/logs/latest.log), update Minecraft.

The map needs mods or a resource pack

Some maps, especially adventure maps and Skyblock modpacks (SkyFactory, Stoneblock), need specific mods or resource packs. Without them you get missing blocks, broken NPCs or crashes. How to install them:

1. Install the required mods

Check the map description for the list of required mods and their versions. The most common are OptiFine, Forge, Fabric, JEI and Create. You install mods through a modding launcher (CurseForge App, Modrinth App, Prism Launcher, MultiMC). Details: the mods section.

2. Install the resource pack

On Java you put resource packs in the resourcepacks folder; on Bedrock you install a .mcpack by double-clicking it. After launching the game, go to Options → Resource Packs and activate the pack. See also: Minecraft resource packs.

3. Install a modpack instead of separate mods

For large maps (SkyFactory, Stoneblock, RLCraft), creators publish ready-made modpacks with the complete list of mods, the configs and the map. You install the whole modpack through the CurseForge App or Modrinth App: one click and everything is ready.

Safe sources for downloading maps

Minecraft maps are just data files, so on their own they can't carry viruses the way a classic .exe can. However, some "maps" from shady sources are actually infected installers or archives with extras bundled in. These sources are trustworthy:

1. CurseForge (curseforge.com)

The largest repository of maps and mods. Creator verification, antivirus scanning of files, community reviews. We recommend it without hesitation: it's the industry's trusted choice.

2. Modrinth (modrinth.com)

A younger alternative to CurseForge. Open source, good filtering, fast downloads. Aimed at maps and modpacks popular in the modding scene.

3. PlanetMinecraft (planetminecraft.com)

The classic community repository. Less verification than CurseForge, but a huge map database. Pay attention to the download count and the comments: a low rating means a potential problem.

4. Minecraft Maps (minecraft-maps.com)

A curated map database with categories. A good choice for parkour, adventure maps and minigames.

5. Creators' official sites

Some creators (for example Noobcrew for Skyblock, Hypixel for server maps) have their own sites. Always make sure you're on the creator's real site and not a phishing clone.

What to AVOID

• Mediafire or Mega without verifying the creator: file hosting platforms aren't bad in themselves, but if you found a Mediafire link through a suspicious blog, first check that the creator is real.
• Sites with "free download" ads: they often spread modified files with malware.
• Sites offering a pirated version of Minecraft: pairing pirated launchers with "free maps" is a typical attack vector. Always buy Minecraft from the official store at minecraft.net.
• Torrents: this is where the risk is highest. Don't download maps through torrents, even if they seem legitimate.

FAQ: common questions

Can I install a Java map in Bedrock Edition?

No, the formats aren't compatible. You need a converter (such as the free Chunker by Hive Games), but the results aren't guaranteed: some blocks, redstone and mob mechanics may not carry over.

Are maps legal?

Yes. Custom maps that creators share on platforms such as CurseForge, Modrinth or PlanetMinecraft are legal, and Mojang supports the community and custom content. Pirated copies of Minecraft itself aren't legal, so if you're using a cracked copy, buy the game at minecraft.net.

Can I modify someone else's map?

For personal use, yes. For redistribution, it depends on the creator's license. Many creators allow remixes, others require a credit such as "original: [creator]". Always check the map description.

How do I delete a map?

Java: launch the game, go to Singleplayer, select the map and click "Delete". Alternatively, delete its folder from saves. Bedrock: under "Play" → "Worlds", select the map, click the edit icon and choose "Delete World".

Can I back up a map?

Yes. Copy the map folder from saves (Java) or minecraftWorlds (Bedrock) to a safe place (an external drive, the cloud). Minecraft Java also has a built-in option: go to Singleplayer → select the map → "Edit" → "Make Backup".

How many maps can I have at once?

As many as fit on your drive. Minecraft has no limit. A typical map is 20-200 MB, large adventure maps 500 MB-2 GB, and mega bases even 5+ GB.

Can a map damage my game?

The map itself can't. But mods the map needs can cause crashes. Always back up your .minecraft folder before installing a large modpack.

How do I quickly rename a map?

Java: in Singleplayer, select the map → "Edit" → change the "World Name". Bedrock: in "Worlds", select the map → edit icon → change the world name.

Does a map keep progress and inventory?

Yes. Once installed, a map remembers everything: the creator's inventory (if they left one), the structures, the state of mobs and player positions. Many parkour and adventure maps start at a specific spawn point with the scenery already set up.

Where can I find free maps in Polish?

PlanetMinecraft and CurseForge have filters for the Polish community: look for the "Polish" or "PL" tags. Polish forums (such as the minecraft.pl forum, Wykop and Discord) often share links to maps by Polish creators.