How to Import an Existing World in Multiverse-Core

This article explains step by step how to import an existing Minecraft world into your server using Multiverse-Core.

Step 1: Prepare Your World Folder

1. Locate your world files.

   • If you downloaded a world from anywhere, it may be in a zip file.

   • If you are transferring from another server, copy the world folder from that server’s main directory.

2. If the world is zipped, extract it inside the home directory . The folder must contain files such as:

   • level.dat

   • region (folder)

   • data (folder, sometimes optional)

3. Make sure the folder name has no spaces. Example:

   • Correct: SkyWorld

   • Incorrect: Sky World

Step 2: Upload the World Folder to Your Server

1. Connect to your server’s file manager (via SFTP, FTP, or your hosting panel’s file manager).

2. Go to the root directory where your server jar file is located. This is the same location as folders like:

   • world

   • world_nether

   • world_the_end

   • plugins

3. Upload your world folder (for example, MyCustomWorld) into this root directory.

Step 3: Restart Your Server

1. Stop your server from your hosting panel.

2. Wait until it is completely stopped.

3. Start your server again so the new folder is recognized.

Step 4: Import the World with Multiverse-Core

Log in to your server with operator permissions and run the following command:

/mv import <worldname> <environment>

Replace <worldname> with the name of the folder you uploaded, and <environment> with one of the following:

• normal = Overworld

• nether = Nether

• end = The End

Examples:

• /mv import MyCustomWorld normal

• /mv import CustomNether nether

Step 5: Teleport to the Imported World

After a successful import, teleport to your world:

/mvtp <worldname>

Example:
/mvtp MyCustomWorld

Step 6: Set the World Spawn (Recommended)

To make sure players spawn in the correct place:

1. Stand at the desired spawn location.

2. Run /mv setspawn

Troubleshooting

Problem: World folder not found
Solution: Check the folder name for exact spelling and capitalization. Remove spaces from the name.

Problem: Players spawn in the void
Solution: Stand at the correct location in the world and use /mv setspawn.

Problem: Server crashes after import
Solution: Ensure the world was fully uploaded. If it is large, upload it as a zip file and extract it on the server.

Problem: Wrong world type
Solution: If you imported as normal but it is actually a Nether map, delete the world and re-import using nether.

Problem: World Import Failed
Solution: Restart your server then try re-importing the world.