What Blue Marble does
It displays a reference image over the canvas so you can see where pixels belong. It does not place pixels automatically, bypass cooldowns, or replace the need to verify every placement.
1. Prepare the template file
Use PNG when the template needs transparent areas. Confirm the file's width and height after export, and make sure each visible pixel uses a color available to the project. The template-making guide covers cropping, scaling, palette conversion, and version naming in detail.
Good input
- • exact final pixel dimensions
- • palette-safe visible pixels
- • transparency where nothing should be placed
- • version and coordinates recorded
Risky input
- • a screenshot with browser borders
- • a resized or compressed preview
- • semi-transparent edge pixels
- • a file with no revision identifier
2. Load and align the overlay
- Open Wplace and navigate close to the intended canvas location.
- Open the Blue Marble panel and choose the template file.
- Enter or select the planned anchor coordinates. Use the same corner convention as the person who prepared the template.
- Lower the overlay opacity so both the template and existing canvas remain visible.
- Check at least two distant landmarks before placing anything.
Use two-point verification
Checking only the top-left corner confirms position but not scale. Check a second landmark near the opposite side. If the first point matches and the second drifts, the template was probably resized or imported at the wrong scale.
Green point: confirms the anchor position.
Purple point: confirms scale and orientation.
3. Work one color at a time
Dense templates are easier to read when the overlay shows a single target color. Disable all color filters, enable one color, and place or verify that group before moving to the next. This reduces repeated palette switching and makes missed pixels easier to spot.
A useful order is:
- Outline colors to establish boundaries and recognizable shapes.
- Large flat regions to create stable visual progress.
- Interior shading after the silhouette is correct.
- Highlights and isolated details last, when neighboring pixels can be checked.
Keep an audit trail for team projects
Record the active template version, anchor coordinates, and completed color groups in a shared note. Do not silently replace the template file while other people are following it. Publish a new revision and describe what changed.
Blue Marble troubleshooting
The Blue Marble panel does not appear+
Confirm the userscript manager is enabled for the current Wplace URL, then refresh the page. Check the userscript manager dashboard for an error and compare your installed release with the project’s current instructions.
The image loads but no overlay is visible+
Check that the overlay is enabled, opacity is above zero, and at least one color filter is active. Then zoom or navigate to the recorded canvas coordinates.
The overlay is shifted by a constant amount+
The anchor coordinate or the source crop is wrong. Recheck the intended top-left point and remove any unintended transparent margin around the source image.
One corner matches but the other does not+
The file dimensions or scale changed after coordinates were recorded. Re-export the template at exact size and do not use a compressed preview copy.
Some template pixels are missing+
A color filter may be disabled, or those pixels may be transparent or outside the configured palette. Inspect the source at high zoom and compare it with the color reference.
The overlay colors do not match the canvas palette+
Convert the source using the enabled Wplace palette, then export again. Do not rely on visually similar RGB values from an unrestricted image editor.
The mobile interface is unusable+
Support varies by browser, operating system, userscript manager, and release. Check the project release notes; use a desktop browser if the mobile environment cannot run the script reliably.
Uninstall or temporarily disable Blue Marble
To hide the template temporarily, disable the overlay in the Blue Marble panel. To stop the script, disable it in the userscript manager and refresh Wplace. To remove it completely, uninstall the userscript from the manager. Removing the userscript should not require deleting your original PNG templates.
Security and compatibility notes
Blue Marble is maintained outside Wplace Toolkit. A public repository makes inspection possible, but it is not a guarantee that every release is safe, compatible, or permitted by another platform. Review requested permissions, source changes, open issues, and Wplace's current rules before installing or updating it.
Use the links in the installation guide to reach the project repository. Avoid re-uploaded userscript files and shortened download links from unknown sources.
Before loading the overlay
Verify dimensions, colors, and transparency
A clean template eliminates most alignment and missing-pixel problems before they happen.