Import an Existing World

Usage: /world import <path> [options...]

Permission: worlds.command.import

See the Permissions page for all command permissions.

To import an existing world, you can use the /world import <path> command.

The given path is relative to the server's world container folder which can be changed.

Additional options

The import command also supports the following additional options:

dimension - Specifies the dimension type. Defaults to normal.
directory - Copies the given path to a new directory before importing.
Useful for importing multiple dimensions from the same level.
generator - Specifies the world generator plugin to use for generating the world.
key - Sets the key for the world. Creates a key representation of the world name if not provided.
name - Sets the name for the world. If not provided, the world will be imported with its original name.
preset - Specifies the world preset to use for generating the world.

Options are specified as option value pairs, and can be used in any given order.

The preset and generator options are mutually exclusive and cannot be combined.

You can use the the-void preset instead of relying on a void generator plugin.
Learn more about why you should stop using void generator plugins.

Examples

Automatic import

To import a world without any custom options, you can use:

/world import Survival

This tries to determine the world's dimension automatically.
If the detection is wrong, you have to unload the world and reimport it with the correct dimension manually.

Multiple Dimensions

To import multiple dimensions from the same world level, you can use the directory option to copy each dimension to its own folder:

/world import "New World" key new:world
/world import "New World" directory "New World Nether" dimension nether key new:world/nether name "New World Nether"
/world import "New World" directory "New World End" dimension end key new:world/end name "New World End"

The directory option is particularly useful when you want to import a world whose level.dat is already managed by Worlds, as it creates a copy instead of requiring manual file editing or restoring from a backup.

Specific Dimension

To import a specific dimension of a world, you can use the following command:

/world import End key worlds:end dimension end

Different Name

To import a world with a different name, you can use:

/world import "My World" name "New World Name"

Custom Generator

To import a world with a specific generator, you can use the following command:

/world import "My World" generator TheGeneratorPlugin

Custom Preset

To import a world with a specific preset, you can use the following command:

/world import "My World" preset the-void

Import an existing world