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

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


Download Minecraft worlds

Services available


Need anything else?

Contributors list

# 465,144
216 commits
# 80,949
10 commits
# 129,468
1 commit


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.


  • 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:


  • 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

Then connect to

in Minecraft to start downloading the world. The world will be saved to the
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 -r 16


| 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:

java -jar world-downloader.jar -s

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

java -jar world-downloader.jar -s --gui=false

Building from source

Dependencies on linux


sudo apt-get install default-jdk maven


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
cd minecraft-world-downloader
mvn assembly:assembly
java -jar ./target/world-downloader.jar -s

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.