Press the arrows to reveal the option you want.
I want to download Red Planet. (Click to Expand)
Click here to view the installation instructions.I want to ask questions about Red Planet. (Click to Expand)
Click here for the Discord server invite to the Red Planet support server.Click here for the GitHub help & question page for Red Planet.
I want to report a bug. (Click to Expand)
Click here to report a bug, then choose the "Bug Report" option.I want to suggest a feature. (Click to Expand)
Click here to suggest a feature, then choose the Feature Request" option.I want to contribute. (Click to Expand)
Click here to read the contributing guidelines.I want to report a vulnerability. (Click to Expand)
Click here to submit a vulnerability report.Welcome to Red Planet! Red Planet is a userscript for the website wplace.live. The purpose of Red Planet is to allow you to take an image, and layer it onto the canvas! That way, you can easily trace the image of your art, without having to look back and forth between multiple tabs/monitors. In addition, Red Planet supports some neat extra features such as:
- Displaying the number of pixels you need to level up
- Displaying a simple coordinate system (tile coordinats & pixel coordinates)
- Allowing you to move the color palette to the top of the screen when placing pixels
- Allowing you to use the eyedropper on the template image, provided the colors are correct
- ...and more!
docs/.
Red Planet has been verified to work on mobile devices. Red Planet was designed on Chrome, but Red Planet might work on "unsupported" browsers not listed above. Some versions/forks of Firefox work. Some versions/forks of Firefox do not work.
Installation instructions for Red Planet are below. Click the arrows to expand the instructions you want to see. Blue text is a link.
Install Chrome (Click to expand)
- Install the TamperMonkey extension for Chrome.
- Right-click the extension.
- Left-click "Manage Extension."
- Enable "Developer Mode."
- Enable "Allow user scripts."
- One-click install: Click this link to Install Red Planet directly: Install Red Planet
TamperMonkey will automatically detect the userscript and prompt you to Install it. - Refresh the wplace.live webpage.
Install on Microsoft Edge (Click to expand)
- Install the TamperMonkey plugin for Microsoft Edge.
- Right-click the extension.
- Left-click "Manage Extension."
- Enable "Developer Mode."
- Download the BlueMarble.user.js file in the "Assets" of the latest release.
- Open the TamperMonkey Dashboard.
- Drag the
BlueMarble.user.jsfile inside the dashboard of TamperMonkey.
- Click the "Install" button to Install Red Planet.
- Enable Red Planet inside the TamperMonkey dashboard.
- Refresh the wplace.live webpage.
Install on Firefox (Click to expand)
- Install the TamperMonkey plugin for Firefox.
- One-click install: Click this link to Install Red Planet directly: Install Red Planet
TamperMonkey will automatically detect the userscript and prompt you to install it. - Refresh the wplace.live webpage.
Red Planet will display your template as the same size. If your image is 500 pixels tall and 300 pixels wide, the template will be 500 pixels tall and 300 pixels wide. Here is the instructions to display a template image on the canvas:
- Find the pixel of the top left corner. Fill in
Tl X,Tl Y,Px X, andPx Ywith the coordinates. You can use the "Pin" icon to auto-fill the coordinates after clicking the pixel.
- Upload a PNG or WEBP image.
- Click the "Enable" button.
There are many settings available for the Red Planet userscript! Through these settings, you can control how the script behaves.
Templates for Red Planet work slightly different from normal. Since there is a "Transparent" color, and transparent pixels in templates are typically ignored, your template should have a custom color to signify "Transparent" colored pixels. If a specific pixel can be any color, it should be transparent in the template. If a specific pixel should be "Transparent" color, it should have the #deface hex color. Any #deface colored pixel in your template will be interpereted as the "Transparent" color. Any transparent colored pixel in your template will be interpereted as ignored.
The coordinate system for wplace.live is unique. Instead of all pixels having a global coordinate number (x, y), the coordinate number is relative to the tile. This means you need to know the tile number and the coordinate number to do anything. In Red Planet, the tile coordinates and the pixel coordinates are displayed when you click on a pixel. These are the coordinates you should use for aligning a template.
The template is aligned from the top left corner of the template. You can auto-fill this position using the "pin" icon next to the coordinate input boxes.
The versioning system for this userscript follows the Semantic Versioning rules. As such, it is formatted in an X.Y.Z format where:
- X is the major version. This is incremented when a non-backward compatible update is pushed. This is for new features that break previous versions of the userscript. Additionally, if wplace.live breaks the userscript, this will be incremented.
- Y is the minor version. This is incremented whenever I push to GitHub. This is for stable bug-fixes and new (non-breaking) features.
- Z is the patch version. This is incremented whenever I launch a development version of the userscript to test a patch. This is for unstable bug-fixes/features.
A: Red Planet does not contain malicious code. The Red Planet code can be found in the src/ folder. If you worry about Red Planet being malware, you can read the code, then bundle it yourself using the tools in build/.
A: Unfortunately, Red Planet will not support the automatic placement of pixels without user interaction because it is not allowed by Wplace.
A: Turn the userscript off and refresh the page.
A: Game notifications only appear when they need immediate attention. Therefore, they have priority over the overlay (which typically needs no attention).