Need help with minecraft-world-downloader?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

mircokroon
168 Stars 10 Forks GNU General Public License v3.0 265 Commits 10 Opened issues

Description

Download Minecraft worlds

Services available

!
?

Need anything else?

Contributors list

# 465,144
Objecti...
C
216 commits
# 80,949
Windows
mac
c-plus-...
random-...
10 commits
# 129,468
Electro...
til
Angular
IPFS
1 commit

minecraft-world-downloader

A Minecraft world downloader that works by intercepting & decrypting network traffic between the client and the server to read & save chunk data. Chunks can be sent back to the client to extend the render distance.

Features

  • Requires no client modifications and as such works with every game client, vanilla or not
  • Automatically merge into previous downloads or existing worlds
  • Save chests and other inventories by opening them
  • Extend the client's render distance by sending chunks downloaded previously back to the client
  • Overview map of chunks that have been saved:

Requirements

  • Java 8 or higher
  • Minecraft version 1.12.2+ // 1.13.2+ // 1.14.1+ // 1.15.2+ // 1.16.2+

Basic usage

Download the latest release and execute the jar file using the commandline by running:

java -jar world-downloader.jar -s address.to.server.com

Then connect to

localhost
in Minecraft to start downloading the world. The world will be saved to the
world/
by default.

Extending render distance

The downloader can be used to extend the render distance by sending chunks that were downloaded previously back to the client. For this, simply include the

-r [distance]
argument when running the program. For example:
java -jar world-downloader.jar -s address.to.server.com -r 16

Options

| Parameter | Default | Description | | --- | --- | --- | | --server | required | Server address | | --port | 25565 | Server port | | --local-port | 25565 | Port on which the downloader will run. | | --output | world | World output director | | --gui | true | Enable or disable the GUI, which shows an overview of all chunks known to the downloader | | --render-distance | 0 | When larger than the server's render distance, send known chunks back to the client | | --minecraft-dir | %appdata%/.minecraft | Path to your Minecraft installation, used for Mojang authentication | | --mark-unsaved-chunks | true | When enabled, marks unsaved chunks red in the GUI. |

Additional options are available by running

java -jar world-downloader.jar --help
.

Running on Linux

To easily download the latest release using the terminal, the following commands can be used:

wget https://github.com/mircokroon/minecraft-world-downloader/releases/latest/download/world-downloader.jar
java -jar world-downloader.jar -s address.to.server.com

When running headless Java, the GUI should be disabled by including the GUI option:

java -jar world-downloader.jar -s address.to.server.com --gui=false

Building from source

Dependencies on linux

debian/ubuntu

sudo apt-get install default-jdk maven

arch/manjaro

sudo pacman -S --needed jdk-openjdk maven
Build project to executable jar file

Building the project manually can be done with the Maven assembly plugin:

git clone https://github.com/mircokroon/minecraft-world-downloader
cd minecraft-world-downloader
mvn assembly:assembly
java -jar ./target/world-downloader.jar -s address.to.server.com

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.