How to Make a Wplace Template

Decide what the template must communicate

Before opening an editor, write down three values: the final width in pixels, the final height in pixels, and the canvas coordinates of the template's top-left corner. These values prevent the most common overlay problem: a technically correct image placed at the wrong size or location.

A 64 × 64 image contains 4,096 pixel positions. That does not mean all 4,096 need placement—transparent areas and repeated background colors reduce the work—but it gives you a useful upper bound. If the project is too large, simplify it before color conversion rather than after.

Make the template in seven steps

1. Crop to the artwork, not the screenshot

Remove browser chrome, captions, borders, and empty margins unless the margin is intentionally part of the coordinate plan. Cropping first makes every later dimension easier to verify.

2. Choose final pixel dimensions

Resize once, using nearest-neighbor resampling for existing pixel art. For photographs or illustrations, test more than one small size: a face that works at 96 pixels wide may become unreadable at 48. Judge the image at 100% zoom, not only in a magnified preview.

3. Simplify details that cannot survive

Remove one-pixel noise, thin diagonal lines, tiny text, and subtle shadows that collapse during reduction. Strengthen important silhouettes. This editorial pass creates more value than simply accepting the first automatic conversion.

4. Convert to the enabled Wplace palette

Use the Wplace color converter and decide whether the paid color group is permitted for the project. Start without dithering. If a gradient becomes too flat, compare a dithered version at actual size and choose deliberately.

5. Mark pixels that should not be placed

Use transparency for “leave this area unchanged.” Do not use white as a substitute for transparency: white is a real palette color and can be interpreted as a pixel that should be painted.

6. Export PNG at exact size

PNG preserves hard pixel edges and transparency. After export, reopen the file and confirm its pixel dimensions. Avoid messaging apps or image hosts that may resize, compress, or strip transparency.

7. Record coordinates and version

Use a filename such as project-name_64x64_x123_y456_v03.png. Store the top-left coordinates, dimensions, palette decision, and revision number alongside the file. A versioned template prevents a team from following two different images.

Template quality check

Do this check before sharing the file or loading it into an overlay:

Common template mistakes

Load the finished template into Blue Marble

Once the PNG passes the checklist, follow the Blue Marble operating guide to load it, align the anchor point, filter colors, and test a small area. If you still need the userscript itself, start with the independent Blue Marble installation guide.