Skip to content

Updates

monil2233 edited this page Jun 1, 2026 · 5 revisions

Keeping Up to Date

Genie 5 has a built-in updater so you can keep three things current without hunting for downloads: the app itself, your zone maps, and your plugins. It's an in-process update system — distinct from Genie 4's separate Lamp.exe updater.

The Updates dialog

Open it from the Help menu (a badge appears there when something is available). It has three tabs:

Tab Updates Source
Core The Genie 5 application. GitHub Releases.
Maps Community zone maps. The community Maps repository.
Plugins Installed plugins. Each plugin's configured release feed.

The updater uses your system's default network settings, so OS-level proxy configuration is honored automatically.

Core (the app)

On Windows, application updates are delivered via Velopack: the updater fetches the new build from GitHub Releases and applies it in place, so the next launch is the new version. Release builds are code-signed (see the README's code-signing section).

🚧 macOS and Linux update channels are scoped but not yet wired — the per-platform paths and the updater abstraction are in place; what's missing is a packaging target (a .app bundle on macOS, an AppImage or similar on Linux) and a release source for each. Until then, update by pulling the latest build the way you installed it (see Installation).

Maps

The Maps tab (equivalently File → Update Maps from Official Repo…) pulls the latest zone XML from the community repository and merges it with your local data — upstream layout fixes come down while your stamped room ids survive. This has its own page: Updating Maps & Scripts.

Plugins

The Plugins tab checks each installed plugin against its configured release feed and offers updates. See Plugins for installing and managing them.

Under the hood

The updater is built around small, swappable pieces: a file-list source and a release source (with implementations for GitHub Contents and GitHub Releases), plus per-domain updaters for the app, maps, and plugins. That design is what lets the same dialog drive three very different update flows, and what will let macOS/Linux app updates slot in without reworking the UI.

What it never does

  • No silent auto-update that resumes your game. Updating is something you initiate; it doesn't run unattended while you're logged in and playing. This keeps Genie on the right side of policy and avoids surprises mid-session.

Related

Clone this wiki locally