Skip to content

v0.5.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 20 Oct 15:59
· 967 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.5.0
4fda1b8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Borea v0.5.0

Borea is the community content manager for Kitten Space Agency: find mods, install them with their dependencies into separate instances of the game, and launch through StarMap.

Website | Discord | Content index | Source and issues

Coming from v0.4.x

Click "Update now" on the Home banner, or run borea update-self.
Your instances, mods and settings stay as they are.

On macOS, Borea is now the app Borea.app, and "Update now" cannot install it over an older Borea: it stops with an unpack error and changes nothing.
Download the App archive once, drag Borea.app into Applications and delete the old Borea folder. Later updates install themselves.

Highlights

  • Borea finds KSA when you installed it with the new Ahwoo client, on Windows and on Linux.
  • Borea can now be translated by everyone, in the browser, see "Translate Borea" below.
  • A mod or pack whose stated game_max is older than your game is now Incompatible and cannot be installed, so a game update no longer installs content that its author marked as broken.
  • On macOS, Borea is a real app with its own name and icon in the Dock.
  • Smooth scrolling, and softer hover and dropdown animations, by @BarneyCompiler.
  • The Mods tab of a pack is a table, and from there you can use a newer release of a member.
  • Discover sorts by "Recently listed", shows what you installed at a glance, and filters by author.

Translate Borea

Borea is now on Hosted Weblate, and anyone can help translate it in the browser, without git and without writing code.
Pick your language, or start a new one, and translate the texts you can. A text that is not translated yet shows in English, so a partial translation already helps.
Weblate sends the changes to Borea as a pull request, which we review, and they reach Borea with the next release.
The pirate translation already has new texts from there, thanks to @Kiwi-Shark.
More about it in the translation guide.

For players

Ahwoo client
  • On Windows and Linux, Borea finds KSA when the Ahwoo client installed it, also when you never used the KSA installer.
  • If you have both, the old KSA installer and the Ahwoo client, Borea offers both game folders to pick from.
Compatibility
  • A mod or pack whose game_max is older than your game is Incompatible and cannot be installed, like one that needs a newer game. Content without a game_max stays Compatible.
  • Borea no longer shows Untested for content. The chip, the warning and the confirmation are gone.
  • A pack that pins a release above its game_max is Incompatible, and the pack page names that release and the last game version it supports.
  • A dependency whose newest release is above its game_max falls back to an older release that fits.
Discover and mod pages
  • Sort the Mods and Modpacks tabs by "Recently listed" to find new content first.
  • A mod or pack you installed has a green check and an "Installed" chip.
  • Click an author name on a row, or on a mod or pack page, to see only the content of that author. A "By " chip removes the filter.
  • The Versions tab of a mod page shows the downloads of each release.
  • The buttons of a mod or pack page move below the title when the window is too narrow for them, so no button is cut off.
Instances and mod packs
  • The lists of an instance line up like a table, also in a narrow window and while a mod updates.
  • The Mods tab of a pack is a table. From there you can use a newer release of a member in the instance made from the pack, also when you pinned it, and go back to the pack's version.
  • On Windows, changing an instance no longer fails now and then with an "access denied" message.
The App
  • Smooth scrolling keeps its speed from notch to notch, and the wheel over a field that cannot scroll moves the page.
  • On macOS, Borea opens from Applications with its own name and icon, without a Terminal window, opens borea:// links, and updates the whole app bundle.

For mod authors

  • The listing editor shows the dependencies of your mod.toml and helps you add bounds, and it checks the members of a modpack as the index does.
  • A fork or a SpaceDock mod can prove that you own it, as the index accepts it.
  • The listing editor reads and keeps tag_prefix, so the index takes only the releases whose tag starts with it.
  • Before the pull request, the editor checks the folder in your release zip, reads your listed images again and suggests a commit address for an image on a branch, and explains a refused value in words, as the index does.

For stewards

  • A Steward entry in the navigation rail.
  • Released archives that are gone from their host on the Watcher tab, and release changes and dependency removals on the author's behalf.
  • Comment on, close and reopen a report from the Reports tab.

Command line

  • The CLI says incompatible instead of untested. pack search and pack show rate a pack by its pinned releases too, and pack install and pack update name the bound that blocks.

Good to know

  • This version is tested with KSA 2026.10.19.5638.
  • Borea ships with the .NET runtime 10.0.13, as v0.4.1 does.
  • Borea is a community project by the KSA Modding team. It is not made by RocketWerkz.

Downloads

File SHA-256
Borea-0.5.0-linux-x64.tar.gz 3dad6ef0ed92bd1a4e891e7fedb4f304440a576212c0748a7477dac5c3c74c72
Borea-0.5.0-macos-arm64.tar.gz 35817c2f96f89500c62853ba56126daff337b0a6c5d2b64a2501c011f22aa3ff
Borea-0.5.0-win-x64.zip 1b3c0e68cbe66caa20bff737d1e6a96192c81a3772251e94f6214cc03e49dd30
Borea-0.5.0.cdx.json 101d5d04c76856103a2d21cfe5b1e28aa33ec5551c0a106437395a1c2c001571
Borea-Cli-0.5.0-linux-x64.tar.gz ef5309c509dd3f73207492c633a2007841ab7ded347a8975b3a162a5c8006a73
Borea-Cli-0.5.0-macos-arm64.tar.gz 28286f97d564e09b17225748fe5ca9ef7993cf14fe9ce442832cca67f6b04133
Borea-Cli-0.5.0-win-x64.zip ffa67f7386c2853acd2a02efac0d66c936dde68cbb612533c146b98e7982419c
Borea-Cli-0.5.0.cdx.json 177059caef5df4e76f337b6d71508521841785c542ffc80b83a23adacff998e3

Each platform has two archives.
The App archive, for example Borea-<version>-win-x64.zip, contains the program borea.
Without arguments, borea opens the desktop App, and with arguments, it runs a command.
Most users want this archive.
Archives whose names start with Borea-Cli- are a smaller download that contains only the command line.

The builds include the .NET runtime and are self-contained, so there is nothing to install first.

Each archive contains borea (borea.exe on Windows), LICENSE and THIRD-PARTY-NOTICES.txt, in a folder named Borea, or Borea-Cli for the CLI archive.
The App archive also contains BRANDING.md, because the Borea logo in the App is not covered by the MIT License.
On macOS, the App archive unpacks into Borea.app instead, with the same files inside.
Put that folder where it can stay, for example %LocalAppData%\Programs\Borea on Windows, ~/.local/share/Borea on Linux or Applications on macOS, because Borea updates itself into the folder it runs from.

First start

These builds are not code signed, so the first start might take an extra step on Windows and macOS. The README has the long explanation.
Code signing policy: https://ksamodding.github.io/Borea/code-signing.html

Windows. Right-click the zip, open Properties and select Unblock.
Then unpack the App archive and start borea.exe, or run .\borea.exe --help in PowerShell in the unpacked folder of either archive.
Without that step, Windows shows "Windows protected your PC". This is because the file might not be downloaded often and is not signed. Select "More info", then "Run anyway".

Linux. Unpack the App archive and run ./borea for the App, or run ./borea --help in the unpacked folder of either archive.
After the App has started once, Borea is in the application menu and starts from there without a terminal.
Both need the ICU and OpenSSL libraries of your distribution, and only the App also needs the X11, ICE, SM and fontconfig libraries. Most desktop installs already have them. See Readme.

macOS. Double-click the App archive to unpack it, drag Borea.app into Applications and open it.
macOS says that Apple could not verify Borea. Select Done, then open System Settings, Privacy & Security, and select "Open Anyway" there.
For the command line, run /Applications/Borea.app/Contents/MacOS/borea --help, or unpack the CLI archive and run ./borea --help in the new folder.
The macOS builds are for Apple silicon. Intel Macs are not supported.

Provenance

To check that a file came from this workflow:

gh attestation verify <file> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml

Borea-0.5.0.cdx.json is the software bill of materials for the App archives, in CycloneDX JSON.
The App contains the command line, so this list includes the NuGet packages of the App and of the CLI.
Borea-Cli-0.5.0.cdx.json is the software bill of materials for the CLI archives and includes only the packages of the CLI.
Each list includes the version, license and hash of every package.
Each list is attested only to the archives that it describes, and you can use this command to prove that it belongs to one.
With --format json, the output includes the attested list.

gh attestation verify <archive> --repo KSAModding/Borea \
  --signer-workflow KSAModding/Borea/.github/workflows/release.yml \
  --predicate-type https://cyclonedx.org/bom

Signing is prepared in #678. Until it is in place, the checksums and the attestation above are how a file is checked.
Code signing policy: https://ksamodding.github.io/Borea/code-signing.html

What's Changed

New Contributors

Full Changelog: v0.4.1...v0.5.0

Contributors

weblate, dependabot, and 5 other contributors
Assets 12
Loading