☰

Wplace chunk downloader

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

当前为 2025-09-06 提交的版本，查看 最新版本。

作者
NotNotWaldo
评分
0 0 0
版本
2.3.2
创建于
2025-08-19
更新于
2025-09-06
大小
41.5 KB
许可证
MIT
适用于

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).
  • You can start a download with only one point set, or use both for a rectangular selection.
  • The number of chunks currently selected is shown below the coordinates.

Steps:

  1. Press "Set 1st point" or "Set 2nd point" to mark corners.
  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 with multiple chunks, using the "Set 1st point" and "Set 2nd point" buttons.
  • Once two points are set, you can then click the Download Region button and the downloader will capture all pixels within that rectangle.

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.

Misc

Download instances

  • You can see the current number of download instances. Download instances control how many images the script downloads at the same time.
  • Use the + / – buttons to increase or decrease it.
  • The number of download instances also applies to manual chunk downloading.

Highlighting chunks

  • The "Highlight chunks" option helps you visualize which area your selected points cover.
  • Highlights appear only when the canvas image is re-fetched/reloaded/updated.
  • 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.

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.
  • You can modify the script itself if you want to increase the maximum download instances. The variable name is maxDlInstances
    • Warning: setting this number too high may result in getting rate limited by the website.

Planned Features

  • Nothing for now.

Changelog

  • 2.3.2
    • Adjusted image file naming convention for Pixel Region Downloads
  • 2.3.0
    • Updated chunk point setting: now uses "Set 1st point" and "Set 2nd point" buttons.
    • Added display for the current number of selected chunks.
    • Removed the safety limit from Pixel Region Downloader (replaced with chunk count display).
    • Added Download instances option (with adjustable + / – controls).
    • Download instances now also apply to manual chunk downloading.
    • Moved Highlight chunks option under the new Misc section.
  • 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)