Wplace live GuideWplace live Guide
Blue Marble

How to Use Blue Marble - Wplace Plugin Guide

Step-by-step tutorial to install and use Blue Marble userscript for template overlays, coordinates and pixel placement on wplace.live.

What is Blue Marble Plugin?

Blue Marble is a popular wplace plugin (userscript) that enhances your wplace.live experience with template overlays, coordinate helpers and drawing assistance.

This Blue Marble tutorial covers installation and usage across major browsers and provides best practices for precise pixel art.

What You'll Learn

  • Blue Marble installation on Chrome, Firefox and Edge
  • How to use template management effectively
  • Coordinate system and advanced tips
  • Transparent pixels handling and settings

Installation Guide - Step by Step

Chrome
  1. Install TamperMonkey for Chrome
    Install button
  2. Open Extension management
    Blue Marble install step
  3. Enable Developer Mode
    Blue Marble install step
  4. Download BlueMarble.user.js from GitHub releases
  5. Open TamperMonkey Dashboard
    Blue Marble install step
  6. Drag BlueMarble.user.js into dashboard
    Blue Marble install step
  7. Click Install
    Blue Marble install step
  8. Enable the script
    Blue Marble install step
  9. Refresh wplace.live
Edge
  1. Install TamperMonkey from Edge Add-ons
    Blue Marble install step
  2. Open Extension management
    Blue Marble install step
  3. Download BlueMarble.user.js
  4. Open TamperMonkey Dashboard
    Blue Marble install step
  5. Drag to install
  6. Refresh wplace.live
Firefox
  1. Install TamperMonkey from AMO
    Blue Marble install step
  2. Download BlueMarble.user.js
  3. Open Dashboard
    Blue Marble install step
  4. Drag to install
    Blue Marble install step
  5. Click Install
    Blue Marble install step
  6. Enable and refresh wplace.live
    Blue Marble install step

Template Instructions

  1. Find the pixel of the top-left corner and fill Tl X/Y and Px X/Y
    Find template coordinates
  2. Upload a PNG or WEBP image
  3. Click Enable to display the template

Template Settings

Transparent Pixels

If a pixel should be the 'Transparent' color, set it to #deface in the template; truly transparent pixels are ignored.

Coordinates

Wplace uses tile-relative coordinates. Use the on-canvas display (tile and pixel) for precise alignment.

How Versioning Works

Blue Marble follows Semantic Versioning (X.Y.Z).

  • X: major (breaking changes or wplace updates)
  • Y: minor (stable fixes and non-breaking features)
  • Z: patch (development builds)

Licenses

Most of the userscript is licensed under MPL-2.0; the NASA 'Blue Marble' image is under CC0 1.0.

Frequently Asked Questions

Is Blue Marble safe?
Yes. The source code is available to review; it contains no malicious code.
Does Blue Marble auto-place pixels?
No. It assists with overlays and coordinates while respecting wplace.live terms.
How to hide the overlay?
Disable the userscript in TamperMonkey and refresh wplace.live.