Minecraft Bedrock: Upload Your World (.mcworld included)

Use Minecraft's own export: in your worlds list, open the world's settings (the pencil icon), go to General Settings, and under File management click Export world. The next screen has its own Export world button; click it, choose where to save the .mcworld file, then go to Step 2.

If you would rather grab the files directly, press Win + R and paste the path for your version:

• Newer versions: %appdata%\Minecraft Bedrock\Users, then open the numbered folder inside and go to games\com.mojang\minecraftWorlds.

• Older versions: %LocalAppData%\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftWorlds (on newer versions this folder may be empty, because the game moved your worlds to the folder above).

Each world is a folder with a scrambled name; open levelname.txt inside (or sort by date modified) to find yours. You can also zip the whole Minecraft folder, your Users folder, the game's Packages folder or the Android games folder: we find your world however deep it is. Zip that whole folder, or drag the folder itself into the upload box in Step 2 and your browser zips it for you (folders under 2 GB only; zip bigger ones yourself).

Minecraft on iPhone and iPad has no export button, so use the Files app: open On My iPhone (or On My iPad), then Minecraft, games, com.mojang, minecraftWorlds. Find your world's folder (same levelname.txt trick), long-press it, and choose Compress. That gives you a .zip. Go to Step 2.

If the world was saved with File Storage Location set to External, plug the phone into a PC with a USB cable and copy the world folder from Android > data > com.mojang.minecraftpe > files > games > com.mojang > minecraftWorlds, then zip that folder on the PC and go to Step 2. Mojang documents this copy in their Android world transfer article. Worlds left on Application storage are not browsable that way, so those need the Realms route below.

Consoles cannot export a world to a file. That is a Minecraft platform rule, not something we control. The one official route is Minecraft Realms, which needs an active Realms subscription or a free trial: upload the world from your console to a Realm, then download it from the Realm onto a Windows PC or iPhone/iPad, where you can export or zip it as above. Mojang documents the steps in Use Realms to Transfer a Minecraft: Bedrock Edition World to Another Device.

There are two places to upload, depending on whether the server exists yet:

• Creating a new server? Click Add Server, pick Minecraft Bedrock, and on the configure step switch on Upload Existing World and drop your .mcworld or ZIP there. The server starts on your world instead of generating one.

• Server already exists? Power the server down first: until it is off, Upload World stays greyed out and says "Power down the server before uploading a new world." Then on your server's card click Detail view, click the Backups card's title to expand it, and click Upload World next to New Backup. On a phone, tap the server, swipe to the Backups pane, and tap Upload World.

The Upload a new world window opens. Drag your .mcworld file or ZIP into the upload box, then confirm with Upload and replace world (on a server that has no world yet the button says Upload world). Before your world is installed, we save the server's current world in Backups as "Backup before world upload", marked Old world, so you can roll back any time. Uploads can be up to 10 GB.

A .mcpack or .mcaddon file is an add-on, not a world, and the upload box says so. Add-ons on CurseForge are added with the search on the Mods card, and your own pack is installed by hand over SFTP.

On a friend's server, Upload World only shows if the owner gave you access that includes replacing the world (Server Admin does). If it is missing, the owner can upload the world or change your access under Account > Manage Friends.

Progress tracking, interrupted uploads, and retries work the same for every game and are covered in Upload an existing world to your server.

A Bedrock world is a folder holding a level.dat file, a db folder, and levelname.txt. This message, shown in the red block on your server card with what your file held, means the upload had no world we could use, which almost always means the wrong thing was uploaded. A .mcworld that Minecraft exported always contains a world, so this mostly happens with hand-zipped folders. The usual causes:

• An add-on (a behavior pack, resource pack, .mcpack or .mcaddon file) is not a world. A lone .mcpack or .mcaddon file is turned away by the upload box. For a ZIP or folder that holds only add-ons, the card shows a different message instead: it names the add-ons it found and says where your worlds are. Add-ons on CurseForge are added with the search on the Mods card, and your own pack is installed by hand over SFTP.

• A db folder on its own is only part of a world. Zip the whole world folder, the one that holds level.dat, levelname.txt and the db folder.

• A world folder without its level.dat can't be loaded with its seed and settings. Zip it again with Minecraft closed, or upload a backup.

• A com.mojang folder whose minecraftWorlds folder is empty came from an older location. Newer Minecraft for Windows keeps worlds in another folder, so use Export world.

• A server's settings files without its worlds folder have no world in them. If your upload holds only the settings files, the card shows a different message instead: it names them and says your server's settings, operators and allowlist are on its Overview card. Upload the world's folder from worlds, or the whole server folder.

Nothing on the server changed when this error appeared, so there is nothing to undo.

Zip the whole server folder, or just worlds and your add-on folders. We import the world your server.properties loads (level-name). Add-ons the world uses from the server's development_behavior_packs, behavior_packs, development_resource_packs or resource_packs folders come along inside the world, and your server card lists them. Add-ons a Haptic server installed from its Mods card are not copied: add them on this server's Mods card. Operators and the allowlist are not imported; set them on the Overview card's Admins tab.

If the upload has a server.properties file (from another host's server folder, a panel backup or a Haptic backup download), we import the world it loads, even when another copy of that world was saved later. Otherwise we import the world you played most recently and name the others on your server card. A world template never wins over a saved world. To use another world, upload a file that holds only that world.

The upload stops before anything on your server changes, and the message says why:

• This is a Minecraft Java Edition world. Java and Bedrock worlds are different formats, and a Bedrock server can't load a Java world. Upload it to a Minecraft Java server, or convert it to Bedrock first (for example with Chunker) and upload the converted world. A world from a Nukkit server is saved in Nukkit's own format, which the official Bedrock server can't load either: convert it to the Bedrock format first.

• The world has its level.dat file but not its db folder. The db folder holds the terrain, builds and players. Zip the whole world folder (the one with level.dat, levelname.txt and the db folder), or use Export world, and upload that. A level.dat on its own would start a new world.

• The world's files are empty. They were copied before they finished downloading from OneDrive or iCloud. Make sure the world folder is fully downloaded on your computer (in OneDrive, right-click it and choose Always keep on this device), then zip it again and upload it. If only level.dat is empty but level.dat_old is fine, we use level.dat_old instead (see below).

• The world is from an old version of Minecraft Pocket Edition. Worlds saved before Pocket Edition 0.9 keep their terrain in chunks.dat, and current Bedrock servers can't load them.

• The level.dat file can't be read. level.dat holds the world's seed and settings. Close Minecraft, zip the whole world folder again and upload it. If it still fails, upload a backup of the world.

• The world data can't be read. The server would replace it with a new, empty world. Worlds from the Minecraft Marketplace are locked to the account that bought them and can't run on a server. If it is a world you made, close Minecraft, zip the whole world folder again and upload it.

• The server is pointed at the uploaded world automatically; there is no setting to edit. In Files or SFTP it lives under /worlds/ in your server's own world folder (usually Bedrock level), whatever the world is called in Minecraft and whatever folder you zipped. That is what lets Backup before world upload put your old world back. Your world itself is unchanged.

• Experiments and Education Edition features. If your world was saved with experiments on (such as Beta APIs for script add-ons) or with Education Edition features, we turn the same switches on for your server, so the first start keeps them. If your server has one on that the world was saved without, your server card says so before you start: turn it off on the Overview card's Details tab unless an add-on on your Mods card needs it.

• World Seed. The World Seed on the Overview card shows your uploaded world's seed after its first start.

• Game Version. If your server is set to a specific Game Version that is older than the version your world was last played in, your server card says so. Set Game Version to Latest on the Overview card's Basic tab before you start.

• World templates. A world made from a world template whose creator locked its settings runs with the game mode and difficulty set on the Overview card's Details tab; your server card says which game mode the world was made for.

• If your world's level.dat was empty, damaged or missing but its level.dat_old was fine, we use level.dat_old and say so on your server card. Your terrain, builds and players are unchanged; the world's settings and time of day may be from a little earlier.

• If the server won't start because of an add-on list: if your world's world_behavior_packs.json or world_resource_packs.json is broken and the server has add-ons from the Mods card, the server does not start and the card names the file. Fix or delete that file on the Files card, or upload the world again, then start the server.

• If the server won't start because your uploaded world isn't on the server, Minecraft would have started a new world in its place, so we stopped the start. Restore the Uploaded backup from the Backups card, or upload the world again, then press Start. If it happens again, contact us.

• If the world came from single player, your own player data (inventory, position) is stored under a local identity that a server does not recognize on its own. The dashboard detects this during import and shows a notice on your server's card: "This world's local player isn't attached yet." Join the server once, then click Attach my character on that notice and pick your player from the list. Builds and everything else in the world import either way.

Reach us on Discord or at support@haptic.gg. Include which device the world came from and a screenshot of the message on your server card or under the upload box.