wplacer

A massively updated auto-drawing bot for wplace.live.

Features ✅

• Simple and easy-to-use web UI: For managing users and templates
• Advanced Multi-Account System: Run templates with multiple users simultaneously. The system intelligently prioritizes users with the most charges available to maximize efficiency.
• Multiple Drawing Modes: Choose from several drawing strategies (Top to Bottom, Bottom to Top, Edges First, Random Color, etc.) to optimize your approach for different templates.
• Automatic Upgrade Purchasing: If enabled, the bot will automatically purchase max charge upgrades or extra charges when running out for your accounts whenever they have enough droplets.
• Account Status Checker: A tool in the "Manage Users" tab allows you to quickly check if your accounts' cookies are still valid.
• Advanced Template Controls: Options such as restarting, replacing a template's image, or pausing on the fly make management more flexible as well as providing you with real time updates on the template's status.
• Automatic Captcha (Turnstile) Token Handling: Turnstile handling lets you babysit the bot much less
• Desktop Notifications: The program will now send a desktop notification when it needs a new Turnstile token, so you don't have to constantly check the console.

Installation and Usage 💻

Video Tutorial

Requirements:

• Node.js and NPM
• Tampermonkey
• git (optional, but recommended)

Installation:

1. Install the extension on each browser window with an account you want to be used by wplacer and to automatically solve Turnstiles (CAPTCHAs) by going to the extensions page of your browser, turning on developer mode, pressing load unpacked, and then selecting the LOAD_UNPACKED folder included with wplacer.
2. Download the repository using git (git clone https://github.com/luluwaffless/wplacer.git) or download the ZIP directly from GitHub (not recommended).
3. In the terminal, navigate to the project directory and install the dependencies with npm i.

• If you'd like, you can change the host and port of the local server by creating a .env file.

Usage:

1. To start the bot, run npm start in the terminal.
2. Open the URL printed in the console (usually http://127.0.0.1/) in your browser.
3. In each browser window with the extension installed, log into your account on wplace.live. If your account does not show up in the manager after refreshing it, you can press on the extension to manually send it to wplacer.
4. Go to the "Add Template" page to create your drawing templates.
   • The coordinates (Tile X/Y, Pixel X/Y) are for the top-left corner of your image. You can find these by clicking a pixel on wplace.live and inspecting the pixel request in the Network tab of DevTools. You can also use the Blue Marble userscript (user TamperMonkey) to see a pixel's coordinates.
   • You can assign multiple users to a single template.
5. Finally, go to "Manage Templates" and click "Start" on any template to begin drawing.
   • The script will occasionally refresh one of the active bot windows on wplace.live. This is required to refresh the Turnstile token needed for painting.

Notes 📝

Caution

This bot is not affiliated with wplace.live and its use may be against the site's rules. The developers are not responsible for any punishments against your accounts. Use at your own risk.

To-dos ✅

• Proxy support
• Add support for paid colors
• Support for painting between multiple tiles
• Easier multi-account support for one template
• Queueing system for multi-accounts
• Docker support

Credits 🙏

• Jinx (Donate here to help us develop the project :3)
• luluwaffless (Donate here to help us develop the project)

And to our amazing contributors!

License 📜

GNU AGPL v3