v5.0.0-alpha.3.5

Genie 5 v5.0.0-alpha.3.5

- In-app AutoMapper editor (select/move/remove rooms, New/Save/Record,
  Edit Room properties) + grab-to-pan + collision-aware labels (#53)
- Windowed (MDI) document mode with Genie 4-style window decorations,
  plus Log / ItemLog panels (#52)

v5.0.0-alpha.3.4

alpha.3.4: connection modes, CLI startup, #goto, portable, parser fix

Connection
- Connect dialog: Direct SGE / Lich proxy mode dropdown; profile remembers the mode
- CLI startup parameters --host/--port/--profile/--mode (bare host:port = Lich proxy)
- Per-profile data directory + folder picker
- Portable mode: genie5.portable marker + writable-location guard
- TLS SGE auth (port 7910, pinned certificate; plaintext fallback)

Mapper / quality of life
- #goto / #go2 command — attended, roundtime-gated walk by id, label, or title
- Default numpad movement macros seeded on a profile's first run
- Open Scripts Folder opens the folder the script engine actually loads from
- Auto-walk unfocus pause is now opt-in (off by default)

Parser
- Recover server-merged game text appended to held-item updates instead of dropping it

Docs: policy posture reframed around the DR Scripting Policy; alpha.3.4 notes.
Update channel now defaults to beta so prerelease builds are visible in-app during alpha.

Closes #6, #37, #38, #39, #41

v5.0.0-alpha.3.2

v5.0.0-alpha.3.2 — Polish + parity (docking, settings, #config, hands…

v5.0.0-alpha.3.1 — cross-platform companion (Linux + macOS)

What this is

v5.0.0-alpha.3.1 is the cross-platform companion to v5.0.0-alpha.3. Same codebase, plus Linux + macOS (Apple Silicon + Intel) binaries that weren't ready when alpha.3 first shipped.

If you're already on Windows alpha.3 via the in-app updater, you'll be offered this as a tiny delta package — nothing changes for you behaviourally.

What's new for Linux / macOS users — first-ever native Genie client

🐧 Linux x64

• Genie5.AppImage — single-file executable. Run chmod +x Genie5.AppImage && ./Genie5.AppImage. Works on Ubuntu / Fedora / Debian / Arch / etc.
• In-app auto-update works via the integrated updater on subsequent releases.

🍎 macOS Apple Silicon (M1+)

• Genie5-osx-Setup.pkg — Apple .pkg installer.
• Genie5-osx-Portable.zip — drag-the-app-to-Applications portable bundle.

🍎 macOS Intel (pre-2020 Macs)

• Genie5-osx-x64-Setup.pkg / Genie5-osx-x64-Portable.zip — same as above, x86_64 binary.

Downloads — pick one

Windows:

• Genie5-win-Setup.exe (recommended) — installs, registers for auto-update
• Genie5-win-Portable.zip — portable / no-install

Linux:

• Genie5.AppImage — universal portable executable

macOS (Apple Silicon, M1 / M2 / M3+):

• Genie5-osx-Setup.pkg (recommended)
• Genie5-osx-Portable.zip — drag to Applications

macOS (Intel, pre-2020):

• Genie5-osx-x64-Setup.pkg (recommended)
• Genie5-osx-x64-Portable.zip

The other assets (*-full.nupkg, releases.{platform}.json, etc.) are the per-platform Velopack feed manifests that the in-app updater reads. You don't download these directly.

Important caveats — read before you run

macOS users — Gatekeeper warning expected.

This binary is unsigned (Apple Developer ID + notarization is on the post-alpha roadmap). First-time launch will be blocked by Gatekeeper. Two ways past it:

1. Right-click → Open (instead of double-click). Confirm "Open" in the dialog. macOS remembers and stops asking.
2. Or run in Terminal: xattr -d com.apple.quarantine /Applications/Genie5.app (substitute the actual path)

Linux AppImage users — manual permissions.

AppImage needs execute permission and (often) FUSE support:

chmod +x Genie5.AppImage
./Genie5.AppImage

If you get a "FUSE not installed" error, on Debian/Ubuntu: sudo apt install libfuse2. On Fedora: it should work out of the box.

The AppImage doesn't auto-register in the apps menu. Use AppImageLauncher if you want desktop integration.

Minimal Linux distros may need fontconfig.

Avalonia uses the system's font configuration. Modern Ubuntu/Fedora handle this fine. On bare-bones distros, you may need sudo apt install fontconfig or equivalent for proper text rendering.

Windows users — SmartScreen warning unchanged from alpha.3.

This release is still unsigned for Windows too. Click "More info" → "Run anyway." SignPath Foundation onboarding is in progress; the next release is expected to be the first signed one.

What hasn't changed from alpha.3

Everything in the alpha.3 release notes — integrated updater, plugin system, per-profile layouts, the whole feature set. This release adds platforms; it doesn't add new features.

In-app upgrade path

From alpha.3 (Windows) → alpha.3.1 (Windows): in-app, via Help → Check for Updates. Tiny delta download (only the bytes that changed, which is just the Velopack manifests).

For first-time installs on Linux / macOS: download Setup.pkg or AppImage from this release page. After that, in-app updates handle subsequent releases.

Thanks

@dylb0t (Kzin) for documentation contributions and the Profiles issue diagnosis.

Reporting issues

Linux and macOS are alpha-tier brand-new platforms for this project. CI builds them cleanly but no live-app smoke test has happened on either OS yet. First-tester reports — what works, what's broken, what shows a weird font — are extremely welcome. File a GitHub issue or drop a note in Discord (shared community server with Genie 4).

v5.0.0-alpha.3 — Integrated updater

Highlights

Integrated updater

End users no longer have to download a fresh zip every release. Three update channels in one Help → Check for Updates dialog:

• Core (the app itself) — Velopack-backed CoreAppUpdater; binary-diff updates, install, restart from inside the app. Now active as of this release — install via Genie5-win-Setup.exe below to get auto-updates from v5.0.0-alpha.4 onward.
• Maps — pulls zone XML refreshes from the community Maps repo.
• Plugins — pulls plugin DLLs from configured release feeds. New #plugin CLI for inspect / install / remove.

Pluggable design via IFileListSource + IReleaseSource over GithubContentsSource and GithubReleasesSource — adding a new update channel (a sounds pack, a script-bundle subscription, etc.) is just another implementation.

Help menu now shows a badge when an update is available.

Architectural note: this is a from-scratch in-process update system. Genie 4 used a separate Lamp.exe binary that the main client shelled out to; Genie 5 runs the updater inside Genie.exe itself. Same problem, different design.

Code-signing pipeline (in progress)

• PRIVACY.md — standalone privacy policy.
• README.md — "Code signing policy" section: attribution text, Author / Reviewer / Approver roles, privacy summary.
• .github/workflows/release.yml — tag-triggered pipeline that builds the Windows artifact, submits it to SignPath Foundation for manual approval, and attaches the signed binary to the GitHub Release.

This v5.0.0-alpha.3 binary is UNSIGNED — SignPath Foundation onboarding is in progress; the next release (v5.0.0-alpha.4) is expected to be the first signed one. Windows SmartScreen may warn about an unrecognized publisher when you run this build; that's the lack of a signing certificate, not a sign of tampering.

Verify against these checksums (the binary was built in GitHub Actions, run 26723454346):

SHA-256 (Genie.exe inside the zip):                17cf46014f7f27707397fc9f883dec5f2c1c54e5c96b0a0f986ba46883e2eddd
SHA-256 (Genie5-v5.0.0-alpha.3-win-x64.zip):       30babe64cbc9af412f4505bc86eb89f168aa017a58bd03010f31722d37ad9387

Documentation

• docs/ROADMAP.md — graduates Plugin system (alpha.2) and Integrated updater (this release) from Planned → Shipped. Adds "macOS / Linux update channels" as the remaining work.
• docs/GENIE4_VS_GENIE5.md and docs/mapper.md — updated for the new update framework and the MapRepoUpdater refactor.
• wiki/Updating-Maps-and-Scripts.md — reflects the new in-app flow.

Downloads — pick one

This release ships in three forms:

Download	When to pick this
Genie5-win-Setup.exe (recommended)	First-time install on Windows. Registers the app for auto-updates; future versions land via "Help → Check for Updates" inside the app. Installs to %LocalAppData%\Genie5\.
Genie5-win-Portable.zip	Portable, no-install. Extract anywhere, run Genie.exe. No auto-update — you'll need to download each new release manually.
Genie5-v5.0.0-alpha.3-win-x64.zip	Legacy hand-rolled zip with the raw Genie.exe. Functionally identical to the Portable.zip above — kept for users who downloaded earlier this session.

The other assets (*-full.nupkg, RELEASES, releases.win.json, assets.win.json) are the Velopack feed manifests and packages that the in-app updater reads. You don't need to download these directly.

No .NET runtime install needed for any option — the .NET 8 runtime and all native dependencies are bundled inside the EXE.

Upgrading from v5.0.0-alpha.2

Manual (recommended for now): download Genie5-win-Setup.exe, run it. Your existing profiles, scripts, maps, and layouts in %APPDATA%\Genie5\ are unaffected by the new install location.

In-app: not from alpha.2 → alpha.3. The previous release (alpha.2) didn't have Velopack assets attached, so the in-app updater can't find them. Install Setup.exe once and the next release (v5.0.0-alpha.4) will arrive automatically via Help → Check for Updates.

Closes

• Plugin system → graduated from Planned to Shipped on the roadmap (actually landed in alpha.2; the roadmap entry was overdue).
• Integrated updater → graduated from Planned to Shipped on the roadmap.

Known issues this release

• Windows SmartScreen will warn about an unrecognized publisher (unsigned binary). Click "More info" → "Run anyway." Resolved when SignPath Foundation onboarding completes (expected v5.0.0-alpha.4).
• In-app Core updater from alpha.2 installs: alpha.2 installs can't be auto-upgraded to alpha.3 (alpha.2 didn't ship with the Velopack manifest). Install Setup.exe from this release manually; from there, alpha.3 → alpha.4 + will be in-app.

Next release

v5.0.0-alpha.4 will be the first signed release. From this alpha.3 install onward, the in-app Core updater finds, downloads, and applies updates automatically.

Thanks

@dylb0t (Kzin) for ongoing developer documentation contributions in docs/ and wiki/.