Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[Wispborne]

TriOS
All-in-one Starsector launcher, mod manager, and toolkit.
For Windows, Linux, and MacOS


alt. download link for Windows
requires Visual C++ redistributables
if it won't launch, make sure drivers are updated


alt. download link for Linux


alt. download link for MacOS
Mac users, see Known Issues section!

Tested only on latest OS versions. Compatibility info.
Linux version tested on Ubuntu.

Roadmap
Source Code • Changelog


(download count includes self-updates)

Installation
1. Download and extract wherever you want. C:\Program Files (x86)\Fractal Softworks works well.
2. Launch using TriOS.exe. Windows SmartScreen will probably warn you, just bypass that (More Info -> Run Anyway).

Optional: when TriOS is running, right-click it on the taskbar and pin it.

Features
- Launcher/Dashboard: Alternative game launcher.
- Version Checker: View mod updates and download them.
- Mod Manager: Swap mod versions on a large grid view. Auto-enables/disables mods based on dependencies. More features coming.
- JRE23/24 installer: Once-click install of Himemi's JRE 23 or 24.
- JRE Manager & RAM changer: Quickly swap your JRE version and RAM usage.
- Mod Profiles: Save and load your mod loadouts. Create profiles from save games.
- StarModder: Mod download catalog.
- rules.csv Autoreloader: Hot reload for your mod rules.csv. Enable it, turn on devmode ingame, and your rules.csv will reload on save.
- Self-update: no need to redownload. One click to update.
- Chipper: Logfile viewer.
- VRAM Estimator: Estimate how much VRAM each mod uses.
- Themes: Not all pretty, not all usable, but they're there, imported from SMOL.

- (TODO) Tip Manager: View tips added by mods and delete them.


Screenshots
Launcher


Mod Manager

More Screenshots

Chipper (log viewer)


rules.csv autoreload

[close]

Known issues
- Windows: You may need to Run As Administrator to use the JRE Manager feature, depending on your Windows user setup.
- MacOS: Self-update doesn't work. You'll need to manually download new versions.
- MacOS/Linux: Changing launch params on MacOS doesn't do anything.
- MacOS/Linux: JRE23 install (and all JRE mgmt) is only supported on Windows.

- MacOS: If you cannot install mods and self-update doesn't work ("Failed to load dynamic library"), run the following in Terminal:

Spoiler

Install brew if not installed:

Code

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install compression libraries:

Code

brew install xz zstd zlib

[close]

FAQ
Which mod manager should I use?
TriOS, MOSS, and SMOL all work together. You can use whichever, and swap as you like - though SMOL won't be getting further updates.
MOSS may complain about duplicate mods, however, because TriOS/SMOL allow multiple versions and MOSS doesn't (as of 2024).

Am I locked into using TriOS?
No! TriOS avoids making any changes that would force you to use it. You can manage your mods manually or launch the game directly as if TriOS didn't exist.

How is this different from the other mod managers?
There's a handy feature-by-feature comparison to MOSS and SMOL right here. Wow!
https://docs.google.com/spreadsheets/d/1vOKXZ8Ahlt-UqFBKJr2yO3z3ffWXFjsS0WA0BCPagKA/edit?gid=0#gid=0

Why not just work on SMOL (or MOSS)?
SMOL is big and slow and there's nothing I can do to fix that except rewrite it in something faster. Even the simplest program possible is big and slow in the framework SMOL is written with.
MOSS is light and fast, but it doesn't come with anything to make it easily look good, and I do not really want to use Rust.
TriOS is written using Flutter, which isn't quite as light or fast as MOSS, but is close enough.


For Mod Authors
tldr: nothing extra needed, but there are optional integrations

Spoiler

Mod Authors don't need to do anything to support TriOS.
It should work with all mods, and if it doesn't then please let me know.

That said, there are a few things that you can do for better integration.

- Add direct download and changelog links to your .version file. These will also be used by MOSS/SMOL/LunaLib/etc: https://github.com/wispborne/Starsector-IntelliJ-Template/blob/main/yourName_uniqueid.version#L48

- Add an icon.png (or ico/jpg) to the root of your mod folder
OR add an icon to LunaSettings.

[close]

Privacy Policy
No personal information is ever collected.
If you choose to allow it, device information (e.g. OS and screen resolution), mod list, and TriOS errors will be collected and uploaded to servers managed by Sentry.io. The information is associated with a randomly generated id and is used to fix bugs. Example of collected data: https://i.imgur.com/k9E6zxO.png.
If you do not choose to allow this, TriOS only uses the internet for obvious things like version checker updates, mod updates, etc.


Credits
AtlanticAccent: For pushing me to do the best I can. Go and check out MOSS!
Thank you to everyone who has given bug reports, suggestions, and feature requests!

The Unwitting QA
Astarat: For using tabs in the mod_info.json file (my fault for using a yaml parser).
ceruleanpancake: For the infinitely looping direct download link in SCVE - very useful for testing download error handling.
Lukas04: For releasing SiC and showing that TriOS thinks "1.0.0beta" is newer than "1.0.0" (but "1.0.0b" is newer than "1.0.0"!)
Nia: For using Bitbucket for version checker, which showed a bug.
Timid: For version names like 1.1813ae and 1.193aj.
theDragn: For putting a link to a website where the Version checker .zip download link should be.
shoi: For putting two mods and a text file in the Arma Armatura download.
Yui: For putting "null" as the Version Checker download link.

------------

Licensed under GPLv3, meaning anyone may use this code, but only to GPLv3 projects (cannot create a closed-source version of TriOS).
Individual code snippets are totally fine to use without asking or copylefting the license - I only mean to protect the greater program itself from being forked to closed-source.

[Dal]

Congrats Wisp on the launch! Looks super slick! Makes me want to try out Flutter.

[nathan67003]

Should probably list the minimum system requirements (or lack thereof) for each OS.

[Wispborne]

Should probably list the minimum system requirements (or lack thereof) for each OS.

True, added.
The hardware requirements should be pretty minimal (100MB of RAM and an extant CPU) - with the exception of VRAM Estimator, which uses a lot of RAM when you do a scan (1GB+), but I can probably fix that in the future.

[Wispborne]

JRE 23 is currently not implemented intuitively. You can use TriOS to install it, but as of now you need to launch it from your game folder (unintentional).

I'll clean this up; it should show up like the other JREs, with the installer right in that card, and then you should be able to switch to it by clicking it and Launch will launch it.

Done.

[Alex]

Just wanted to say, this is extremely cool! And very impressive, though that almost goes without saying

[Wispborne]

Just wanted to say, this is extremely cool! And very impressive, though that almost goes without saying

Thank you!

I decided that there was a niche that neither SMOL nor MOSS nor the vanilla launcher quite filled; something as simple, easy, and intuitive as the vanilla launcher, but with Version Checker built seamlessly in.

I'd already written a couple of other tools using Flutter (Chipper and StarModder), so creating a "toolkit" rolling those in felt like a natural evolution!
(still need to add StarModder...)

[theit8514]

Very cool!

One of the mods is showing a yellow exclamation point, but there's no info when I hover over it. Just the one mod though, everything else loads fine.

[Vundaex]

Looks awesome!

[Niten]

Spooky

[Hexallium]

In the future, is there a possibility to have a friendly UI function for editing setting.json?

[Psyentific]

cool mod but i refuse to use any tri-tachyon branded product

[Alex]

I decided that there was a niche that neither SMOL nor MOSS nor the vanilla launcher quite filled; something as simple, easy, and intuitive as the vanilla launcher, but with Version Checker built seamlessly in.

(That makes a ton of sense, yeah.)

[Dadada]

That's freaking awesome! You are a hero! 

[Wispborne]

Very cool!

One of the mods is showing a yellow exclamation point, but there's no info when I hover over it. Just the one mod though, everything else loads fine.

Thanks, I'll improve the error handling, there, to display the root cause better.

In this case, the problem is that that mod set up Version Checker incorrectly.

Code

 "masterVersionFile":"https://github.com/CaymonJoestar/Diable-Avionics/releases/download/DiableV.2.9.0/Diable-Avionics-v2.9.0.zip"

In the future, is there a possibility to have a friendly UI function for editing setting.json?

Maybe for a few choice settings, like vsync and fps, but it's not high on the priority list - it's easy to edit with a text editor (easier than changing vmparams, I think), and a bug that breaks that file could potentially be very difficult to fix.

Spooky

Antivirus won't like this, no. New, unsigned executables make them nervous.

cool mod but i refuse to use any tri-tachyon branded product

Hmm..alternative branding is a good theme idea...