Waxlight Wiki

The complete documentation for Waxlight — an independent open-source launcher for Vintage Story. Accounts, game versions, isolated instances, mods, backups, and playtime in one app for Windows and Linux.

GPL-3.0Windows x64Linux x6410 interface languagesOpen Source

Get startedDownload on GitHubDiscord server

What is Waxlight

Waxlight brings everything around Vintage Story into one desktop app: multiple accounts with TOTP/2FA support, side-by-side game versions, isolated instances with their own mods and settings, a built-in ModDB browser, backups, and playtime tracking.

The project is maintained by AmadoMuerte with help from contributors. Waxlight is not affiliated with the developers of Vintage Story, does not distribute the game, and does not bypass its licensing — a valid Vintage Story account is required to play.

Features

Accounts & sign-inMultiple Vintage Story accounts with TOTP/2FA and protected session storage.

Game versionsMultiple Vintage Story versions side by side, installed from the official version feed.

InstancesIsolated game environments with their own mods, settings, game version, and account.

Mods & ModDBA built-in Vintage Story ModDB browser — search, install, and update mods per instance.

OptimumInstalling Optimum, connecting it to Waxlight, and launching optimized instances.

Backups & recoverySnapshots, safety backups before changes, and restoration of a known-good state.

Instance packagesExport and import instances as portable packages with private-data sanitization.

Operations & downloadsTrack downloads and long-running work — progress, cancellation, history.

Launcher updatesStable and prerelease channels, SHA-256 verification, trusted-publisher control.

Policies & security

Waxlight keeps passwords and sessions only in the protected OS store, and telemetry is off by default. Details are in the project policies:

Privacy PolicyWhat is stored locally, which telemetry may be sent, and which services the launcher contacts.

SecurityThreat model, credential storage, and how to report a vulnerability privately.

Code signingCurrent Windows release signing status and artifact verification.

Community on Discord

Waxlight has an official Discord server: install help, feature discussions, development news, and feedback. Join us: discord.gg/CrRHvg9UVw

Join

For developers

The source code is open (GPL-3.0): Go + Wails 2 on the backend, React 19 + TypeScript on the frontend. Building from source, the layered architecture, tests, and contribution rules are covered in the Development section. The full list of repository documents is on the Repository documents page.