Open the Ahwoo client from the new game build banner

Open
  • Is something wrong?
#770 0 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@Maximilian-Nesslauer is already working on this.

Since Oct 16, 2026.

Assessment

This issue has not been assessed yet.

Description

area:app
what

When the master server reports a newer KSA build, Borea shows a banner on Home with the download page the server names, today the Ahwoo web page (MainViewModel.GameBuild).
Ahwoo plans an ahwoo:// link scheme for its client (Discord, 2026-10-16).
With it, the banner can open the client on the KSA page or start the update, so a player updates before starting the game instead of starting, being told, updating and starting again.

Today Should be
The banner opens the web page, and GameBuildDownloadUrl accepts only http and https. When the client is installed, the banner opens it through ahwoo://; otherwise it opens the web page as today.

What we know: the KSA game is 0197f25e-1171-7476-944d-fdf8091a8edc with pageId 100000 on https://api.ahwoo.com/games, and its client package is 019f01fc-623a-773f-8d70-f0177b16a20c.
The client's manifests (#769) tell Borea whether the client has KSA installed.
Ahwoo also plans a public endpoint for the newest version of an app; https://api.ahwoo.com/games has no version yet, so Borea keeps asking the master server until it does.

The Neutrino beta (client 2026.9.45.1068, checked 2026-10-16) does not register ahwoo as a URL scheme yet, neither under HKCU nor under HKLM\Software\Classes.

Before we build this, check against the real client how the scheme is implemented: its exact form for KSA (the page id or the package id), whether it can start the update, and whether the client registers it on every system.

Tests
  • With the client installed, the banner action opens the ahwoo:// link of KSA.
  • Without the client, it opens the web page.
  • A link of another scheme is still refused.
Depends on

The ahwoo:// scheme of the Ahwoo client, and #769 to know that the client is installed.

Dominant language
C#
Stars
29
Forks
3
Avg merge
17h 21m
Merged PRs (30d)
291

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from KSAModding/Borea

All issues in KSAModding/Borea

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.