{"id":15026557,"url":"https://github.com/mircokroon/minecraft-world-downloader","last_synced_at":"2025-05-15T20:04:55.300Z","repository":{"id":37489523,"uuid":"185738848","full_name":"mircokroon/minecraft-world-downloader","owner":"mircokroon","description":"Download Minecraft worlds, extend server's render distance. 1.12.2 - 1.21","archived":false,"fork":false,"pushed_at":"2024-07-25T12:41:25.000Z","size":1658,"stargazers_count":1323,"open_issues_count":228,"forks_count":87,"subscribers_count":30,"default_branch":"master","last_synced_at":"2025-04-08T01:39:03.890Z","etag":null,"topics":["cross-platform","gui","minecraft"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mircokroon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mircokroon"}},"created_at":"2019-05-09T06:23:41.000Z","updated_at":"2025-04-07T11:26:43.000Z","dependencies_parsed_at":"2023-11-18T15:05:42.079Z","dependency_job_id":"5cc5d0ca-afdd-40ec-9e87-9f54ca073625","html_url":"https://github.com/mircokroon/minecraft-world-downloader","commit_stats":null,"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mircokroon%2Fminecraft-world-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mircokroon%2Fminecraft-world-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mircokroon%2Fminecraft-world-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mircokroon%2Fminecraft-world-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mircokroon","download_url":"https://codeload.github.com/mircokroon/minecraft-world-downloader/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254414499,"owners_count":22067272,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-platform","gui","minecraft"],"created_at":"2024-09-24T20:04:41.159Z","updated_at":"2025-05-15T20:04:53.155Z","avatar_url":"https://github.com/mircokroon.png","language":"Java","funding_links":["https://github.com/sponsors/mircokroon","https://github.com/sponsors/mircokroon?frequency=one-time\u0026amount=5"],"categories":["Java"],"sub_categories":[],"readme":"# minecraft-world-downloader\nA Minecraft world downloader that works as a proxy server between the client and the server to read \u0026 save chunk data. Download multiplayer worlds by connecting to them and walking around. Chunks can be sent back to the client to extend the render distance.\n\n\n### Downloads  \u003ca href=\"https://github.com/mircokroon/minecraft-world-downloader/releases/latest\"\u003e\u003cimg align=\"right\" src=\"https://img.shields.io/github/downloads/mircokroon/minecraft-world-downloader/total.svg\"\u003e\u003c/a\u003e\nWindows launcher: [world-downloader-launcher.exe](https://github.com/mircokroon/minecraft-world-downloader-launcher/releases/latest/download/world-downloader-launcher.exe)\n\nLatest cross-platform jar (command-line support): [world-downloader.jar](https://github.com/mircokroon/minecraft-world-downloader/releases/latest/download/world-downloader.jar)\n\n### Basic usage\n[Download](https://github.com/mircokroon/minecraft-world-downloader-launcher/releases/latest/download/world-downloader-launcher.exe) the latest release and run it. Enter the server address in the address field and press start.\n\n\u003cimg src=\"https://i.imgur.com/yH8SH5C.png\"\u003e\n\nInstead of connecting to the server itself, connect to `localhost` in Minecraft to start downloading the world.\n\u003cimg src=\"https://i.imgur.com/wKMnXfq.png\"\u003e\n\nIf you run into any problems, check the [FAQ](https://github.com/mircokroon/minecraft-world-downloader/wiki/FAQ) page for some common issues. \n\n### [Features](https://github.com/mircokroon/minecraft-world-downloader/wiki/Features)\n- Requires no client modifications and as such works with every game client, vanilla or not\n- Automatically merge into previous downloads or existing worlds\n- Save chests and other inventories by opening them\n- Extend the client's render distance by sending chunks downloaded previously back to the client\n- Overview map of chunks that have been saved:\n\n\u003cimg src=\"https://i.imgur.com/7FIJ6fZ.png\" width=\"80%\" title=\"Example of the GUI showing all the downloaded chunks as white squares, which ones from a previous download greyed out.\"\u003e\n\n### Requirements\n- Java 21 or higher\n- Minecraft version 1.12.2+ // 1.13.2+ // 1.14.1+ // 1.15.2+ // 1.16.2+ // 1.17+ // 1.18+ // 1.19.3+ // 1.20+ // 1.21+\n\n### Command-line\n[Download](https://github.com/mircokroon/minecraft-world-downloader/releases/latest/download/world-downloader.jar) the cross-platform `world-downloader.jar` and run it using the command-line:\n\n```\njava -jar world-downloader.jar\n```\n\nArguments can be specified to change the behaviour of the downloader. Running with `--help` shows all the available commands.\n```\njava -jar world-downloader.jar --help\n```\n\nThe GUI can be disabled by including the `--no-gui` option, and specifying the server address:\n```\njava -jar world-downloader.jar --no-gui -s address.to.server.com\n```\n\n### Running on Linux\nTo easily download the latest release using the terminal, the following commands can be used:\n```\nwget https://github.com/mircokroon/minecraft-world-downloader/releases/latest/download/world-downloader.jar\njava -jar world-downloader.jar -s address.to.server.com\n```\n\nWhen running headless Java, the GUI should be disabled by including the GUI option:\n```\njava -jar world-downloader.jar -s address.to.server.com --no-gui\n```\n\nSome linux distributions may require `-Djdk.gtk.version=2` for the GUI to work:\n```\njava -Djdk.gtk.version=2 -jar world-downloader.jar\n```\n\n\n### Building from source\n\u003cdetails\u003e\n  \u003csummary\u003eDependencies on linux\u003c/summary\u003e\n  \n  ### debian/ubuntu\n  \n  ```\n  sudo apt-get install default-jdk maven\n  ```\n\n  ### arch/manjaro\n  \n  ```\n  sudo pacman -S --needed jdk-openjdk maven\n  ```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eBuild project to executable jar file\u003c/summary\u003e\n  \n Building the project manually can be done using Maven:\n  ```\n  git clone https://github.com/mircokroon/minecraft-world-downloader\n  cd minecraft-world-downloader\n  mvn package\n  java -jar ./target/world-downloader.jar -s address.to.server.com\n  ```\n\n\u003c/details\u003e\n\n### Contact\n\u003cdetails\u003e\n  \u003csummary\u003eContact information\u003c/summary\u003e\n\n  For problems, bugs, feature requests and questions about how to use the application, please [open an issue](https://github.com/mircokroon/minecraft-world-downloader/issues/new/choose) or discussion on GitHub. \n\n  For other inquiries, email: mircokroon.github@gmail.com\n  \n  If you want to support this project, you can [donate through GitHub](https://github.com/sponsors/mircokroon?frequency=one-time\u0026amount=5)\n\u003c/details\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmircokroon%2Fminecraft-world-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmircokroon%2Fminecraft-world-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmircokroon%2Fminecraft-world-downloader/lists"}