Skip to content

v0.4.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Oct 16:57
· 57 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.4.0
3ff9d03
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.4.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.3.x

Click "Update now" on the Home banner, or run borea update-self.
Your instances, mods and settings stay as they are.
Pins and mods detached from a modpack are new in the record of an instance. An older Borea still reads such an instance, but it drops the pins and the detached mods when it saves that instance. So once you pin or detach a mod, do not go back to v0.3.x with that instance.

Highlights

  • Descriptions and release notes show all of their formatting: links open in the browser, and tables, lists, code and dividers look as the author wrote them.
  • Select and copy text across a whole description, through paragraphs, headings, lists, tables and code.
  • Pin a mod at its version, and Borea tells you when a pin holds back the update of another mod.
  • Detach a mod from its modpack to choose its version yourself, and attach it again later.
  • Mods that you installed by hand now show on the Content tab of the instance, below the mods that Borea manages.
  • Filter Discover by more than one license.
  • Mod authors see a preview of their description in the listing editor while they type.

For players

Descriptions and release notes
  • Links in descriptions and release notes open in the browser and show their address when you point at them. A bare address such as https://example.com is a link too.
  • Tables, dividers, nested lists, escaped characters, line breaks and <br> show as the author wrote them, with no Markdown characters left over.
  • Inline code and code blocks take the colors of the theme instead of a black bar.
  • A drag selects text across paragraphs, headings, list items, table cells and code blocks. Ctrl+C, or Copy in the right-click menu, copies the whole selection with a blank line between the blocks, and Ctrl+A selects the whole description. A press after the end of a line starts the selection there.
  • Headings can be selected too.
  • A link on the second or a later line of a long paragraph now opens on a click.
Instances
  • The Content tab now also lists the mod folders that Borea did not install, in a table "Not managed by Borea" below the mods that Borea manages. The "Manual installs" tab is gone.
  • Each of these rows says that Borea cannot update the mod. "Manage with Borea" is a button on the row, and "Replace with the latest release" is in its "..." menu.
  • That table always has "Open folder" in its header, also when it is empty, so you can still add a mod by hand. Thanks to @LaurensDeV for the report.
  • "Pin version" in the "..." menu of a mod keeps it at its installed version, and the row shows a pin mark. "Update all", the update of the mod itself and a pack update leave a pinned mod alone, and the other mods still move. "Unpin" takes the pin away.
  • A plan that needs another version of a pinned mod stops and names the pin.
  • When a pin keeps another mod from its newest release, the row of that mod says so, for example "2.0.0 needs Aircraft HUD >= 1.1.0, which is pinned at 1.0.0", instead of an update button. Home does not count it as an update.
Mod packs
  • "Detach from modpack" in the "..." menu of a pack mod makes it a mod you chose, and it moves to the Mods group. A pack update leaves it at its version, and a detached mod that you remove does not come back with a later pack update.
  • The instance header says how many mods differ from the pack, for example "2 mods differ from Tools Pack 1.0.0", and the pack update confirmation names each detached mod that it leaves alone.
  • "Attach to modpack again" undoes it. When the mod is at another version than the pack pins, Borea asks before it changes to the pack's version.
Discover and mod pages
  • The License filter shows each license once, such as MIT or CC-BY-SA-4.0, the most used first. You can select more than one, each selected license shows as a chip that removes it, and a mod or pack shows when its license names one of them. The Modpacks tab works the same way.
  • The "..." menu of a mod or pack page has "Copy share link" and "Report". Report opens the takedown form or the id dispute form of the content index on GitHub, with the listing filled in, and says in one line what each form is for.

For mod authors

  • The listing editor has a Preview switch next to the Description heading. The preview stands next to the description field, shows the description as the mod page shows it, with your images, and follows the text while you type.
  • Borea now shows links, tables, dividers, nested lists, escapes, entities and hard line breaks in a description. Raw HTML shows only as its text. What the preview shows is what players see.

Command line

  • borea pin and borea unpin pin a mod at its version and take the pin away.
  • borea pack detach and borea pack attach detach a mod from the pack of its instance and attach it again.

Good to know

  • This version is tested with KSA 2026.10.7.5541.
  • Borea is a community project by the KSA Modding team. It is not made by RocketWerkz.

Downloads

File SHA-256
Borea-0.4.0-linux-x64.tar.gz 03e8c033bb1b5f3190d8f851d857c4227641764a7dacf067158467c6836a383e
Borea-0.4.0-macos-arm64.tar.gz b0fdcc4ed94e2214fadc6e6607e41d70d154279b3a182491e2035b674a5aead4
Borea-0.4.0-win-x64.zip 92d0dd14746bed4fe6b01f74d15091368deff63686b28db3f83240bff358b8af
Borea-0.4.0.cdx.json a0bcbf786e40493db9a6c6af85aba6610271b3cb2cde9197e5a92514b3cfb5cc
Borea-Cli-0.4.0-linux-x64.tar.gz 2c4134f072e6a4c083c9d1c8bf66dace9ce7051f7d546e4e338f7c0bfe4d6ba4
Borea-Cli-0.4.0-macos-arm64.tar.gz 7e26cc279187b49f1b248e3b8f77e3cea32e42c4347d1d283c0d73ab10ab600d
Borea-Cli-0.4.0-win-x64.zip 572a54f3ba1ec0cfc0d55881a819f8b5bb16e17e7167ed81820e4171ecf1d284
Borea-Cli-0.4.0.cdx.json 5e6da54d73a4e8f13e48989364b62add8d19bc95825ef4c8f7d43d5c0d2479e0

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.
Put that folder where it can stay, for example %LocalAppData%\Programs\Borea on Windows or ~/.local/share/Borea on Linux, 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.

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. Unpack and start Borea from Terminal, not from Finder: tar -xzf <file>, then run ./borea inside the new folder of the App archive for the App, or ./borea --help inside the new folder of either archive.
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.4.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.4.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 will come in the future and is tracked in #76.

What's Changed

Full Changelog: v0.3.2...v0.4.0

Contributors

LaurensDeV and Maximilian-Nesslauer
Assets 12
Loading