WplaceWplace live Guide
Back to Wplace Wiki

Wplace Blue Marble: The Ultimate Userscript for Enhanced Pixel Art Creation

Blue Marble is a revolutionary userscript designed specifically for Wplace.live that transforms your pixel art creation experience. This powerful tool provides advanced template overlay functionality, precise coordinate systems, and enhanced visual aids to help you create stunning collaborative pixel art with unprecedented accuracy.

🎨 What is Blue Marble?

Blue Marble is a free, open-source userscript that enhances your Wplace.live experience by adding professional-grade features for pixel art creation. Whether you're working on complex artwork, participating in collaborative projects, or simply want more precision in your pixel placement, Blue Marble is the essential tool for serious Wplace.live artists.

✨ Key Features

  • 🖼️ Template Overlay System: Display custom PNG/WEBP templates directly on the canvas
  • 📍 Advanced Coordinate System: Precise tile and pixel coordinate tracking
  • 🎯 Pin-Point Accuracy: Auto-fill coordinates with the pin tool
  • 🔧 Customizable Settings: Extensive configuration options for personalized workflow
  • 📱 Cross-Platform Support: Works on desktop and mobile devices
  • 🌐 Multi-Browser Compatibility: Supports Chrome, Edge, and Firefox

🚀 Why Use Blue Marble on Wplace.live?

Enhanced Pixel Art Creation

Blue Marble transforms Wplace.live from a simple pixel canvas into a professional pixel art studio. The template overlay system allows you to:

  • Create Complex Artwork: Overlay detailed templates for intricate designs
  • Collaborate Effectively: Share template coordinates with team members
  • Maintain Consistency: Ensure accurate placement across large projects
  • Save Time: Reduce manual pixel counting and placement errors

Professional-Grade Tools

Unlike basic pixel art tools, Blue Marble provides:

  • Transparent Pixel Support: Handle transparency with the special #deface color system
  • Real-Time Coordinate Display: See exact tile and pixel positions instantly
  • Template Alignment: Precise top-left corner alignment system
  • Visual Overlay Management: Toggle overlays on/off as needed

📥 Installation Guide

Prerequisites

  • Browser: Chrome, Microsoft Edge, or Firefox
  • Extension: TamperMonkey userscript manager
  • Platform: Windows, Mac, Linux, or Mobile

Step-by-Step Installation

For Chrome Users

  1. Install TamperMonkey

  2. Configure TamperMonkey

    • Right-click the TamperMonkey extension icon
    • Select "Manage Extension"
    • Enable "Developer Mode"
    • Enable "Allow user scripts"

  3. Download Blue Marble

  4. Install the Script

    • Open TamperMonkey Dashboard
    • Drag the BlueMarble.user.js file into the dashboard
    • Click "Install" to complete installation
    • Enable Blue Marble in the dashboard

  5. Activate on Wplace.live

    • Navigate to Wplace.live
    • Refresh the page to activate Blue Marble

For Microsoft Edge Users

  1. Install TamperMonkey

  2. Follow Similar Steps

    • Enable Developer Mode in extension settings
    • Download and install BlueMarble.user.js
    • Activate on Wplace.live

For Firefox Users

  1. Install TamperMonkey

  2. Install Blue Marble

    • Download BlueMarble.user.js from releases
    • Install through TamperMonkey Dashboard
    • Refresh Wplace.live to activate

Note: Some Firefox versions may have compatibility issues. Blue Marble is primarily optimized for Chrome and Edge.

🛠️ How to Use Blue Marble

Template Setup

  1. Prepare Your Template

    • Use PNG or WEBP format
    • Template displays at actual pixel size (500x300 image = 500x300 pixels on canvas)
    • Use transparent pixels for areas to ignore
    • Use #deface hex color for "Transparent" pixels on Wplace.live

  2. Set Coordinates

    • Find your desired top-left corner position on the canvas
    • Click the pixel to see tile and pixel coordinates
    • Use the "Pin" icon to auto-fill coordinate fields
    • Enter values in Tl X, Tl Y, Px X, and Px Y fields

  3. Upload and Enable

    • Upload your template image
    • Click "Enable" to activate the overlay
    • Your template now appears on the canvas

Understanding the Coordinate System

Wplace.live uses a unique tile-based coordinate system:

  • Tile Coordinates: Large grid sections (Tl X, Tl Y)
  • Pixel Coordinates: Specific pixels within tiles (Px X, Px Y)
  • Template Alignment: Always from top-left corner

This system ensures precise placement across the massive Wplace.live canvas.

Advanced Features

Transparent Pixel Handling

  • Transparent pixels: Ignored during template overlay
  • #deface colored pixels: Interpreted as Wplace.live "Transparent" color
  • Custom color mapping: Define specific colors for different purposes

Script Settings

Blue Marble offers extensive customization options:

  • Overlay opacity: Adjust template transparency
  • Coordinate display: Toggle coordinate information
  • Visual aids: Enable/disable various helper tools
  • Performance settings: Optimize for your device

🔧 Troubleshooting

Common Issues

Q: Is Blue Marble safe to use? A: Yes! Blue Marble is open-source with all code available in the repository. You can review the source code in the src/ folder and even build it yourself using tools in build/.

Q: Can Blue Marble automatically place pixels? A: No, Blue Marble does not support automatic pixel placement. It's designed as a visual aid and coordination tool that requires manual user interaction.

Q: How do I hide the overlay? A: Simply turn off the userscript in TamperMonkey and refresh the Wplace.live page.

Q: Why do game notifications appear over the overlay? A: Game notifications have priority over overlays since they require immediate attention, while overlays are typically informational.

Browser Compatibility

  • ✅ Chrome: Fully supported and recommended
  • ✅ Microsoft Edge: Fully supported
  • ⚠️ Firefox: Partial support (some versions may not work)
  • ✅ Mobile browsers: Verified to work on mobile devices

🌟 Why Choose Blue Marble for Wplace.live?

Community-Driven Development

Blue Marble is actively maintained by the community with regular updates and new features. The project welcomes contributions and follows semantic versioning for reliable updates.

Professional Features

  • Template overlay system for complex artwork
  • Precise coordinate tracking for collaborative projects
  • Cross-platform compatibility for any device
  • Open-source transparency for security and trust

Enhanced Wplace.live Experience

Transform your Wplace.live sessions from casual pixel placement to professional pixel art creation. Whether you're:

  • 🎨 Creating detailed artwork
  • 👥 Collaborating with teams
  • 🏆 Participating in pixel art competitions
  • 📚 Learning pixel art techniques

Blue Marble provides the tools you need for success.

🔗 Get Started Today

Ready to enhance your Wplace.live experience?

  1. ⭐ Star the Repository: Show support on GitHub
  2. 📥 Download Blue Marble: Get the latest version from releases
  3. 🚀 Start Creating: Visit Wplace.live and begin your enhanced pixel art journey

Contributing to Blue Marble

Interested in contributing? Check out the CONTRIBUTING.md file in the project documentation.

Blue Marble is licensed under the Mozilla Public License Version 2.0 (MPL-2.0), with the Blue Marble image courtesy of NASA under Creative Commons 0 1.0 Universal (CC0 1.0) license.

Transform your Wplace.live experience today with Blue Marble - the ultimate userscript for pixel art enthusiasts! 🎨✨

Recommended Tools
View More Articles
Thanks for reading!