World Downloader

World Downloader is a multiplayer world backup mod for Liteloader. The mod is currently available for Forge (1.14.4-1.16.4) and Base Edit (old and modern versions past 1.12.2) here.

For other older builds or other Liteloader mods check the Liteloader Archive here

dlaske 1.7.10 old version of World Download and other links to the old version

Archive of old versions (1.7.10 to 1.9 Liteloader builds)

















Clones a Minecraft multiplayer world from a remote server to your singleplayer folder

World Downloader v4

Makes a copy of parts of a multiplayer world for singleplayer use (EG, for backups or renders)

World Downloader is a mod that allows making backups of Minecraft worlds. You can view the Minecraft forum thread here. Project wiki; issue tracker.

This is a continuation dslake's original version.

How do I compile this?

You first need to set up begradle. Right now, this can be done by downloading from this repo and then running gradlew install. Later this'll be put into a maven repo so that it doesn't need to manually be installed, but at this phase in development, it needs to manually be done.

Once that is set up, you should be able to get everything to work by running gradlew setupDecompWorkspace build. Hopefully. If something doesn't work quite right, it may be a bug with begradle or another part of the build system; there should be a notification in the most common cases as to what you need to do.

To compile for a single Minecraft version, run gradlew :version:build (for instance, gradlew :1.11.2-litemod:build).

What is this branch?

I'm going to be putting v4 development in this branch.

Why a new version?

I have been working on cleaning up the build process so that I can build for all versions of Minecraft at the same time, rather than developing against one version (usually 1.8) and porting to all the other versions at once.

However, the actual code for the project will remain more or less exactly the same - just moved to a new location within the project. It's not a rewrite, just a refactoring.

Why v4 specifically?

There's already legacy and wdl2 branches separate from the master branch. v4 seems like the next version. Plus, 4 is the IEEE-vetted random number.

Where's the old code?

On separate branches - master, and 1.7.10/1.9/1.10...

Only old downloads missing from old forum thread that this info came from

World Downloader, abbreviated WDL, is a mod that allows saving of a world on a remote server for singleplayer use. Mainly, this means that it can be used to backup your creations on a server. This is a continuation of the older version by cubic72 and nairol.

Left out Downloads as part of archive or viewable still on the archived forum thread that this information came from.

Older versions

Older, non-actively maintained versions of WorldDownloader for versions of minecraft before 1.7.10 can be found in the old thread or via the GitHub releases page (within the 'src' download of very old versions).

Installation instructions
Follow the appropriate set of instructions for your intended method of installation.

Base edit

If you would like to contribute video instructions, leave a reply!

I recomend using MultiMC to automatically install the mod. MultiMC is a separate launcher that automates mod management. For older versions you may want to use magic launcher.

Based off of cubic72's instructions here.

Using new launcher:

(Replace 1.x.x with 1.8.9, etc in these instructions)

Note: If you have a recommendation for simplifying these, let me know. Do no just say MAKE IT FORGE COMPATIBLE. Forge does not have the hooks for directly capturing network and screen events.

Close the launcher

Copy the .minecraft/versions/1.x.x folder to .minecraft/versions/1.x.x.wdl

Go into folder 1.x.x.wdl.

Rename 1.x.x.jar to 1.x.x.wdl.jar

Rename 1.x.x.json to 1.x.x.wdl.json

Open 1.x.x.wdl.json with a text editor of your choice.

Change the "id" value to "1.x.x.wdl" (the name used elsewhere).

Scroll to the bottom of the JSON file and delete the entire "downloads" block near the bottom.

Before/after for above (click to show)

To clarify, since there are multiple "downloads" blocks, you want to scroll to the bottom of the JSON file and replace the following

"mainClass": "net.minecraft.client.main.Main",

"minimumLauncherVersion": 18,

"assets": "1.9",

"downloads": {

"client": {

"url": "https://launcher.mojang.com/mc/game/1.9/client/2f67dfe8953299440d1902f9124f0f2c3a2c940f/client.jar",

"sha1": "2f67dfe8953299440d1902f9124f0f2c3a2c940f",

"size": 8697592

},

"server": {

"url": "https://launcher.mojang.com/mc/game/1.9/server/b4d449cf2918e0f3bd8aa18954b916a4d1880f0d/server.jar",

"sha1": "b4d449cf2918e0f3bd8aa18954b916a4d1880f0d",

"size": 8848015

}

},

"assetIndex": {

"totalSize": 120490344,

"id": "1.9",

"known": true,

"url": "https://launchermeta.mojang.com/mc-staging/assets/1.9/092c59b361816c7fa7f000587caa977c515b179c/1.9.json",

"sha1": "092c59b361816c7fa7f000587caa977c515b179c",

"size": 137075

}

}

with this:

"mainClass": "net.minecraft.client.main.Main",

"minimumLauncherVersion": 18,

"assets": "1.9",

"assetIndex": {

"totalSize": 120490344,

"id": "1.9",

"known": true,

"url": "https://launchermeta.mojang.com/mc-staging/assets/1.9/092c59b361816c7fa7f000587caa977c515b179c/1.9.json",

"sha1": "092c59b361816c7fa7f000587caa977c515b179c",

"size": 137075

}

}

(You don't want to replace it with exactly that text; this only shows the layout). This is needed because otherwise the launcher thinks you ahve an out-of-date version.

Open 1.x.x.wdl.jar with 7-zip or another archive manager.

Delete the META-INF from within 1.x.x.wdl.jar (this folder is used to check if the jar has been modified).

Copy all of the files from within the World Downloader zip file into the jar, overwriting files and merging folders if prompted.

Restart the launcher, "edit profile" (or make a new profile) and "use version" 1.x.x.wdl.


 * You can the .minecraft folder on ...

Windows by entering %APPDATA%\.minecraft in an Explorer window or in the start->run dialog.

Linux by opening ~/.minecraft/ in a file manager of your choice.

Mac OS X by opening ~/Library/Application Support/minecraft in Finder.

Liteloader

Note: DO NOT EXTRACT THE .LITEMOD FILE! The .litemod file is what is manually loaded. Some browsers may automatically attempt to open it; if you use safari either you can find the original zip in the trash, or the automatic opening in Safari's Preferences (Safari —> Preferences... Untick "Open 'safe' files after downloading").

Video instructions (by Minecraftech)

Video

Text Instructions
Quote from TheOneAlex»

Start with a clean download of Minecraft, making sure to save any necessary files (the 3 I saved were servers.dat, resourcepacks folder, and options.txt).

Download liteloader-installer-1.8.0-00-SNAPSHOT.jar (Mac) or liteloader-installer-1.8.0-00-SNAPSHOT.exe (Windows) HERE.

Quit Minecraft (if it's open right now), and install LiteLoader from the .jar/.exe you just downloaded.

Run minecraft, join a server or something, and then quit Minecraft again.

Download the appropriate .litemod file from the downloads section.

Place the downloaded .litemod file inside the minecraft/mods/1.8 folder:

For Mac users, get to your minecraft folder by opening Finder and then pressing shift + command + G.

Enter ~/Library/Application Support in the box and press "Go".

For Windows users, type %appdata% in your search bar thingy

Download Java Development Build using the links below, courtesy of UltiNaruto. Make sure to choose .dmg for Mac users, and .exe for Windows users.

Quote from UltiNaruto»

Get JDK 1.8.0 here : http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Check "accept license" and click on "jdk-8u45-macosx-x64.dmg"

You can get JDK 1.7.0 here (if you need) : http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

Go to "Java SE Development Kit 7u80" section

Check "accept license" and click on "jdk-7u80-macosx-x64.dmg"

If you run mac or linux, you need to also do the following:

Open the Minecraft launcher, select "LiteLoader 1.8" under "Profiles", and click "Edit Profile"

Under "Java Settings (Advanced)", make sure you have the box for "Executable" checked, and type /usr/bin/java into the box (YES, PASTE IT IN EXACTLY LIKE THIS)

Hit "Save Profile"

Run Minecraft using your LiteLoader 1.8 profile, join a server, hit Esc, click "Download World", run around to load the chunks you want to download.

Forge
There is no forge version of World Downloader. However, you can use the Liteloader version with Forge, which will generally work. Look on the liteloader thread for instructions on how to install with forge, and then insert the .litemod file as described above.

Disclaimer
World Downloader has an automatic update checker that fetches an update list from GitHub. No personal information is sent appart from the current version as part of the User Agent (which is standard for any HTTP request). This update check also performs some basic validation to ensure that the download is not corrupt. You can view more information on how the updater works, both internally and visually, on the project wiki.

This mod does communicate with the server for permission checks. These are intended to add permission requests to the mod to adress the concerns some server owners have about misuse. A few servers do automatically ban users when it detects the mod being installed; while I do not support this action in any way, it is important to be wary of the fact that some servers do this. The vast majority, however, either do not use this system or implement the in-mod permission request system. Please contact a moderator on your server for details (they generally like being notified before you install the mod as to what you wish to download).

I cannot be held responsible for any issues caused by the use or misuse of the mod. As per the license:

The User accepts the following liability:

The Mod is provided 'as is' with no warranties, implied or otherwise.

The Author is not responsible for dragon, troll, pirate, or ninja attacks.

Slaying any and all mythological creatures is the sole responsibility of the User.

The Author takes no responsibility for any damages incurred from the use or misuse of the Mod.

The Mod may alter fundamental parts of the Game.

The User is liable for any and all damages resulting from the use or misuse of the Mod.

The Author may not be held responsible for the incompetency or sadism of a Modpack Creator.

TL;DR: To make use of the mod, simply join a server, pause the game, and click "Start download". If the server is multiworld (has more than the 3 vanilla minecraft dimensions), make sure to indicate as such. Travel around the world, making sure to load the parts you want to save, and opening any chests / other containers, and when you are done, pause, and click "Stop downloading".

Detailed usage
Join a server, and then pause and select "Download this world". If this is your first time using the mod on that server, make sure to chose the appropriate multiworld mode -- if the server *only* has 3 worlds (the overworld, nether, and end), multiworld is not needed, but if it has any more worlds or has worlds beyond those official worlds, multiworld is required or you may end up overwriting data from one world with that of another. After that, you may wish to pause again and click the 3 dots next to the download button, allowing you to further configure the download options for that world.

Once you've started the download, you need to travel around the world. World Downloader will only save chunks that you can see -- if the game never loads it, it will not be saved. (However, once a chunk is loaded, the entire vertical section is saved.) For most servers, this is a range of 10 chunks (160 blocks), but it might be more or less depending on the server. You will need to open chests and some other blocks for them to be saved. See this section for more info.

When you are done, pause the game and then hit "Stop downloading".

What World Downloader saves
World Downloader automatically saves some things, but other things must be manually saved, and still other things can't be saved at all.

Automatically saved
World terrain

Entities (may need range configuration on some servers)

Most tile entities, such as signs and banners

Your inventory, position, and gamemode

The server spawnpoint

Manually saved
Chests and other containers -- they must be opened to save

Villager trades (must be viewed to save)

The server seed -- must be manually entered (will be filled in if /seed is performed, but you must be op)

Not saved at all
Your bed respawn

Other players

Jukebox contents

Compatibility with other mods
If you want to use World Downloader with other mods, note that it might not save everything from other mods. For instance, it most likely will not save containers such as chests. However, it'll still probably save most of the downloaded world. World Downloader has not been tested with other mods.

No guarantees can be made about functionality with other mods. If you experience crashes, feel free to report them, though.

Information for server owners
World downloader is a mod that is mainly intended for use by players to make copies of their own creations. However, you may be afraid that someone will use the mod to create a copy of your own map, or another thing that they didn't build, and then put it on their own server. While I can't say that that isn't a risk, it doesn't mean you should entirely ban use of the mod (or players who use the mod).

Additionally, it only downloads the area that a player travels to -- it is impossible to download the entire map without traveling through it. World Downloader requests no more data than a vanilla client -- it simply writes the data that is normally sent.

Please send me a private message if you want to chat about use of this mod on your server.

Detailed information on how World Downloader works

Bug reporting
It's preferred to report bugs on the GitHub issue tracker, but if you're not sure or don't want to register an account there, feel free to post in this thread and I'll create a ticket. For issues that pertain to both the base edit version and the liteloader version (or just the base edit one), use this tracker. For ones that you know for sure are only in the litemod version, use this one.

Please include the full log file in the crash report, along with any other information (such as the server IP) as necessary.

Wiki
There is wiki here, which is somewhat bare but covers most of the GUIs and some other information.

License
WDL is licensed under the MMPLv2. Among other things, this means that you must request permission before redistributing this mod. Also, custom versions must be open source. However, you may redistribute it in a modpack, so long as you give credit and do not generate revenue from that modpack. For more information, please read the license page.