Installation1. 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.
-
(0.97a only!) 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.
-
Tip Manager: View tips added by mods and delete them.
-
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.
ScreenshotsLauncher
Mod Manager
More Screenshots
Chipper (log viewer)
rules.csv autoreload
- Windows: You may need to Run As Administrator to use the JRE Manager feature, depending on your Windows user setup.
- Linux: If installing mods/self-update doesn't work due to your distro, try
downloading the 1.1 Prerelease instead, which uses 7zip.
- 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 ("Failed to load dynamic library"), try
downloading the 1.1 Prerelease instead, which uses 7zip.
Otherwise, to stay on 1.0, run the following in Terminal:
MacOS-only instructions
Install brew if not installed:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install xz zstd zlib
TriOS can easily download and install Himemiko's
Mikohime Java 23 and 24.
To install it, go to the TriOS Dashboard tab, open the Performance section (under the Launch button), and select one of the 23 or 24 options. Once installed, make sure it's set to Active by clicking it. The Dashboard shows which version of Java is being used.
The program follows the exact same steps as a manual installation. It downloads the JDK specified on the Mikohime Java page, the same Mikohime Java .zip, and extracts them to the game's install folder.
Once finished, you do not need to use TriOS to launch the game; it's just the same as if you had installed it without TriOS (this is the case for everything; I don't want you to be unable to play or mod the game if TriOS isn't working!).
Setting Java 23/24 to Active in TriOS simply means that TriOS will use it when you press the Launch button; you could launch the game using Starsector.exe (Java 7/8/17, depending on your setup) or Mikohime.bat (Java 23/24).
FAQAm 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.
Other Questions
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).
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=0Why 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 much to make it easily look good, and I do not really want to use Rust. The developer experience of Flutter is also far superior (changing the code doesn't require restarting the program to see how it affects the app)
TriOS is written using Flutter, which isn't quite as light or fast as MOSS, but is close enough.
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.
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.
CreditsAtlanticAccent: For pushing me to do the best I can.
Go and check out MOSS!tomatopaste: For suggesting the TriOS name.
Thank you to everyone who has given bug reports, suggestions, and feature requests!
The Unwitting QAAstarat: 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.
