Multiworld

Because some servers have more than one world, World Downloader needs extra logic to handle them. The multiworld system does this.

Background

The vanilla Minecraft server has precisely one world. Within that world, there are several dimensions: the Overworld, the Nether, and The End.

Within the world folder, these dimensions are represented with the sub-folders region , DIM-1, and DIM1, respectively. Similarly, the client receives a number stating which dimension they are in (this, among other things, effects whether the nether's red fog or the end's static sky are displayed). As such, the dimensions can be differentiated easily.

However, not all servers are vanilla servers. [Bukkit] supports servers with multiple worlds (when added by plugins). The simplest example is the [multiverse plugin] , but many other plugins also use this - for instance, [A Skyblock] creates its own second sky world. These worlds may have the same dimension IDs as the vanilla worlds (and in fact, must), so World Downloader can't automatically deal with them.

To make things even more complex, there is [BungeeCord], which allows linking multiple servers together. This means that you can have multiple servers (each potentially with multiple worlds) that you connect to with the same IP. If the server you play on has a "hub" with portals to various games (or has the /server command), it most likely is using BungeeCord.

Due to it being impossible to automatically solve this, World Downloader uses a somewhat simple system: asking the player.

How it works

The very first time you join a server, the Multiworld GUIs will be displayed, prompting you whether the server is multiworld. If it isn't, you can start downloading imediately and dimensions will be automatically worked out.

If the server is multiworld, you'll need to specify which world you are in each time before you can start downloading. Whenever you open the options GUI or start downloading, you will first need to chose the world using the Multiworld GUIs. This displays a list of names you have created, and also allows creating a new name or searching through the names.

When multiworld is not enabled, the downloaded world is named the same thing as the server. With it enabled, the name is instead the server followed by the sub-world, which creates a unique name. The World Downloader configuration is saved inside of that folder, as are all downloaded files.

Should I create separate sub-worlds for each dimension?

Sometimes.