v0.3.1

Borea v0.3.1

A fix release for v0.3.0. Update with "Update now" on the Home banner, or with borea update-self.

Website | Discord | Content index | Source and issues

Fixes

• Play no longer needs the internet when the mod loader is installed. Borea chooses the loader from the content index it already has, so the game starts at once. Before, Play asked SpaceDock first, and when SpaceDock or your connection did not answer, it waited for 100 seconds and then showed an unexpected error. If Borea has no content index yet and cannot load one, Play now tells you why. The same applies to borea launch. Thanks to @Kiwi-Shark for the report.
• A click beside a text field, for example on the empty page next to the Discover search, now takes the focus from the field, so its cursor and its highlight go away and your keys no longer go into it. In a modal, Tab stays in the modal and Escape still closes it. Thanks to @LaurensDeV for the report.

Downloads

File	SHA-256
Borea-0.3.1-linux-x64.tar.gz	31cc6840611b56b8e5e44dc3fd31a60860031cedc15b7ce43a4c8b927fd14f9f
Borea-0.3.1-macos-arm64.tar.gz	4a4f8be7117b4ec5358773bdd4e5fa67d4427f36bbf0dd44149781d794c3df0d
Borea-0.3.1-win-x64.zip	96dc92e1300b5882aac8af072007c39178e5d833210ec67d9cef460434ac151c
Borea-0.3.1.cdx.json	4a55245984152814f10e05f8707d881c06361209867fd2a16ff149f210533cea
Borea-Cli-0.3.1-linux-x64.tar.gz	432ebe5ef957e474233fa7475fdef67a2e146948c6834ad0ced3977126b6817e
Borea-Cli-0.3.1-macos-arm64.tar.gz	e9fe33c2dc8e3cab545758927bc16a102714ec725a0b5539aa82e3c170046c49
Borea-Cli-0.3.1-win-x64.zip	73732abdc53414b0f82ffb7a5f26fc1e106dbdb11a632c50c7f7ed9b415e81ab
Borea-Cli-0.3.1.cdx.json	0d4089bd053457b39d5370d75cee1e63d0be4b3a984ec110c72fe513267f240a

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.3.1.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.3.1.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

• Start a launch from the held content index by @Maximilian-Nesslauer in #681
• Take the focus from a text field on a click beside it by @Maximilian-Nesslauer in #680
• Add the release notes of v0.3.1 by @Maximilian-Nesslauer in #682

Full Changelog: v0.3.0...v0.3.1