Are mods safe?

Mods are made by other players. This page explains what a mod can and can't do on your computer, so you can decide which ones to install. The short answer: ordinary mods are data and can't run anything; mods with code are off unless you switch them on, and run locked away from the rest of the game.

Two kinds of mods #

Data mods Code mods
Examples Boards, repair challenges, puzzles, knowledge packs, fault types, meter profiles, diagnostic rules New circuit solvers, importers for other file formats, panels such as a coach
Runs anything? No. The game reads them like a board file you drop on the bench. Yes, inside a sandbox (below).
Available Everywhere Website and desktop app, when you switch on Mods → Code mods (experimental). Not in the iOS app.
Marked — Runs code, with its permissions, on install and on its card

What a data mod can change #

A flag unlocks only after a real repair: it's locked to the repaired board's wiring, not to anything a mod or a solver says.

Turning a mod off undoes everything it changed. Mods → Loadout → Official runs the game as shipped, without uninstalling anything.

What keeps code mods in #

When you switch on code mods, each one runs:

The game also checks everything a code mod sends back: solver results number by number, panel content node by node, imported boards through the game's own importers. Panels are drawn by the game, so a mod can't put its own HTML on your screen.

Permissions you may see on install:

Permission What it allows
(none) Run, read the board on the bench, offer a solver or importer.
panel Show panels in the side panel's Mods tab, select a part, show short messages.
storage Keep up to 64 KB of its own settings.
network:localhost Talk to programs on your own computer.
network:https://example.org Talk to that one site.

How we test it #

We attacked the sandbox with a probe mod in Chrome. It tried every route out we could think of: network requests of every kind (taken back from the browser's internals too), loading scripts and modules, eval, storage, the page, nested workers. No request got out. Two ways out turned up on the way, both through module loading in Chrome; both are closed, and the game now refuses any mod that could use them.

Bench check (on every mod's card) tests what a mod does on the simulator before you rely on it. For a code solver it compares every reading with the official solvers.

What's still open #

We're honest about the limits:

If something looks wrong #