BrickVerse Installer

A single Electron/TypeScript application that installs, updates, repairs, launches, or removes the BrickVerse Game Client and BrickVerse Creator on Windows, macOS, and Linux. Electron bundles the required runtime; users do not need Node.js.

The installer is also the installed brickverse:// protocol handler and file handler for BrickVerse projects, worlds, models, animations, and addons. Product shortcuts route through it so an enabled product update is applied before launch.

Install directories

• Windows: %LOCALAPPDATA%\Programs\BrickVerse and %LOCALAPPDATA%\Programs\BrickVerse Creator
• macOS: ~/Applications/BrickVerse.app and ~/Applications/BrickVerse Creator.app
• Linux: ~/.local/share/brickverse/client and ~/.local/share/brickverse/creator

These locations are writable without administrator access. The setup UI can select a different location for either product. That location is stored with the product metadata and is used by launching, updating, and removal.

Product updates

Updates are installed as a complete staged replacement. The replacement is downloaded, extracted, and validated before the current directory is renamed. If activation fails, the previous directory is restored. Reinstalling first is not required, and uninstalling before an update is no longer supported or necessary.

Development

npm install
npm run dev

Build only the Windows installer:

npm run dist:win

Build all packages supported by the current operating system:

npm run dist

Output is written to release/.

GitHub Releases / auto-update

The electron-builder publish target currently points to:

BrickVerse-co/installer

Change build.publish.repo in package.json if the Electron installer is kept in another repository.

Push a version tag to publish:

npm version patch
git push
git push --tags

The packaged application checks GitHub Releases shortly after startup. Windows and macOS update metadata is generated by electron-builder.

macOS automatic updates require a signed application. Configure the signing and notarization secrets used by .github/workflows/release.yml.

Linux does not have the same native updater mechanism as Windows/macOS. The AppImage build can download updates through electron-updater when GitHub release metadata is available, while DEB installations should generally be updated by installing the next DEB package.

Build artifact names

The installer matches the current game workflows:

App	Windows	Linux	macOS package
Client	BrickVerse.exe	BrickVerse.x86_64	BrickVerse-macOS.zip
Creator	BrickVerseCreator.exe	BrickVerseCreator.x86_64	BrickVerseCreator-macOS.zip