☰

Wplace chunk downloader

Easily download chunk images from wplace.live using multi-point selection and highlighting

Author
NotNotWaldo
Daily installs
1
Total installs
50
Ratings
3 0 0
Version
2.2.1
Created
2025-08-19
Updated
2025-08-28
Size
38.2 KB
License
MIT
Applies to

WPlace Chunk Downloader

Overview

This userscript makes it easier to download chunk images from wplace.live.

How the Multiple Chunk Downloader Works

  • You can set 1 or 2 points on the canvas.
  • These points serve as opposite corners of a rectangle (or square).
  • The downloaded image will include all chunks inside that area.
  • Setting another point after you've already set 2 will move the second point into the first slot, and assign the new point as the second slot.

Steps:

  1. Press “Set point” to mark a corner.
  2. After setting one or two points, press “Download chunks” to download all the chunks within the selected area.

Pixel Region Downloader

The Pixel Region Downloader lets you download a custom pixel area instead of entire chunks.
It can be found under the “Multiple Chunks Downloader” tab.

How it works:

  • You set points for the pixel region in the same way as you set points for the multiple chunk downloader — it uses the same "Set point" button.
  • Once two points are set, you can then click the Download Region button and the downloader will capture all pixels within that rectangle.
  • A safety option is automatically enabled, which works just like the one in the manual chunk downloader:
    • By default, it prevents downloading more than 70 chunks at once to avoid overload.
    • If disabled, this restriction is ignored.

Highlighting Chunks

The “Highlight chunks” option helps you visualize which area your selected points cover.

Important notes:

  • The highlights will only appear when the canvas image is re-fetched/reloaded/updated.

How it works:

  • If you have at least one point set, you can click “Highlight chunks” to see the highlighted area.
  • If you add a second point while highlighting is enabled, it will automatically highlight all chunks within the two points.
  • If you press “Remove points”, highlighting will also be turned off automatically.

Manual Chunk Downloading

With manual chunk downloading, you can enter coordinates directly instead of setting them on the canvas.

How it works:

  • Input the X and Y coordinates of the first chunk.
  • Input the X and Y coordinates of the second chunk.
  • Optionally, add a fifth value to toggle safety on or off.
    • If safety is set to true, the script prevents downloading more than 70 chunks in one go.
    • If set to false, this restriction is ignored.

Example input:

400, 300, 401, 301, true
  • The first 4 numbers represent the chunk coordinates.
  • The last value (true) enables the safety check.

Additional Features:

  • You can drag the tab/box around the screen.
  • Sections can be collapsed or expanded using the “–”/“+” buttons.

Notes

  • If you get rate-limited by the website, the script will do a 10 seconds cooldown before proceeding with downloading chunks.
  • If you are using other overlay scripts and those overlays are positioned over the chunks being downloaded, they will also appear in the saved chunk images.

Planned Features

  • Nothing for now.

Changelog

  • 2.2.1
    • Should be able to use other overlay scripts (like Blue Marble or Wplace Overlay Pro) without breaking it. Hopefully...
  • 2.2.0
    • Added Pixel Region Downloader under the Multiple Chunks Downloader tab.
    • Works just like multiple chunk downloading but lets you download pixel-perfect areas.
    • Includes automatic safety checks to prevent downloading more than 70 chunks at once.
  • 2.1.5:
    • Fixed broken image stitching due to image scaling caused by overlays. It now automatically resizes it back to 1000 x 1000 pixels.
  • 2.1.4:
    • Fixed the manual and multiple chunk downloader bug.
  • 2.1.3:
    • Small bugfixes
    • Now allows the use of Wplace Overlay Pro without breaking this script or their code. (Haven't tested it with other overlays)