Skip to content

Install the userscript

mia-riezebos edited this page Sep 16, 2026 · 3 revisions

Install the userscript

Install a userscript manager in your browser, then add Caelestis from GitHub. The example below uses Violentmonkey.

1. Install a userscript manager

Choose Violentmonkey or Tampermonkey and follow its link for your browser.

Use the extension store's install button and approve the browser's confirmation.

Violentmonkey's extension-store page with Add to Chrome visible.

On Chromium browsers, open the manager's details in the browser's Extensions page and enable Allow user scripts if present. Older versions may require extension developer mode instead. Tampermonkey documents the Chromium setting here.

Allow user scripts enabled in the extension's browser settings.

Greasy Fork is a script directory, not a userscript manager. Caelestis releases are on GitHub.

2. Open the latest release

Open the latest Caelestis release. Look for the userscript release marked Latest.

A Caelestis userscript release with the Latest badge.

3. Open the script asset

Under Assets, click caelestis.user.js. Choose the script file, not Source code.

The caelestis.user.js asset outlined in orange.

4. Confirm the installation

Your userscript manager opens an installation page. Check that the script is Caelestis and its matching site is https://wplace.live/*. Click Install.

Violentmonkey's Caelestis installation page, with Install outlined in orange.

5. Open Wplace

Open Wplace, or reload it if it was already open. Click the Caelestis button among the map controls to open the panel.

The Caelestis map button outlined in orange.

Follow Getting started to import and place your first template.

Optional: connect to a server

Local templates work without a server. For a group's shared artwork, ask its owner for the server address and a token.

Open Settings in the panel header.

The Settings gear outlined in orange.

Enter the owner's server address and click Add.

An example address and the Add button.

Expand the server if needed. Paste the token and click Connect. A connected server shows Update when changing its token.

The access-token field beside Connect. The masked value is an example.

Connect to a server has the full connection instructions.

Clone this wiki locally