Step 1 of 3

Install a userscript manager

A manager is a browser extension that runs small scripts on pages you allow. Pick one, either works.

Violentmonkey

Open source. Recommended.

Tampermonkey

The one most guides assume.

Greasemonkey

Firefox only, and best effort. The loader has no value-change listener there, so cross-tab sync runs over a BroadcastChannel fallback. If you are on Firefox, use Violentmonkey.

Step 2 of 3 · branches by browser

Allow user scripts

This is the step that fails quietly. On Chromium the manager is installed, the loader is installed, the game loads, and nothing happens, with no error anywhere, because the browser is holding the script back behind one setting.

Find your browser below and do only that block.

Chrome, Edge, Brave, Opera

Required · do not skip

  1. Open chrome://extensions and click Details on your manager.
  2. Scroll to Allow User Scripts, below Site access, and turn it on. Chrome warns that the extension will be able to run code it has not reviewed, which is exactly what a userscript is.
  3. Reload the game tab. The setting does not apply to tabs that are already open.
The Allow User Scripts row on a Chrome extension's details page, switched on, with Chrome's own warning that the extension will be able to run code which has not been reviewed by Google.
Chrome 150 · the toggle you need, on

Wording and placement move between Chrome versions. On builds that have no such toggle, the equivalent is Developer mode at the top right of the extensions page.

Checked against Chrome 150, July 2026.

Firefox

Nothing to do

Firefox has no equivalent setting. Your manager can already run scripts. Go to step 3 →

On Greasemonkey there is still nothing to switch on here, but see the caveat in step 1.

Safari

Not tested

The loader has never been run on Safari, so there are no instructions here worth following. Safari's userscript managers are separate paid apps rather than the extensions above, and recommending one for a browser nobody has tested this against would be a guess.

If you get it working on Safari, say so in an issue and this section can become real.

Step 3 of 3

Install the loader

One file. Your manager will show you the source and ask you to confirm.

Did it work?

  1. Open the game and log in until you are in the world.
  2. Press Esc.
  3. The Game Menu has an Addons entry at the bottom.

Nothing is installed by default. Open Addons → Browse and pick something.

The in-game Game Menu listing Key Bindings, Controller, Graphics, Interface, Audio, Performance Overlay, Report a Bug, Unstuck, Logout and Return to Game, with a new Addons entry at the bottom, above the game's version readout.
Game Menu · Addons, added by the loader

If something is wrong

Keyed on what you can see, not on what went wrong internally.

SymptomCause and fix
No Addons entry in the menuThe HUD only exists after world entry. Log in first, then press Esc.
The manager's popup has no Addons commandThe userscript is not running on this page at all. Go back to step 2.
The entry is there, the window is emptyThe bridge did not connect. Open Diagnostics, then file an issue with what it says.
Everything works, no addons listedNothing is installed by default. Open Browse, then install.

Still stuck? Open an issue, including your browser version and what Diagnostics reported.