Your mod
A.version file URL is better than a mod download link; it updates whenever you
update your version file and helps avoid unnecessary redownloads.
The Mod ID (from mod_info.json) combined with a
.version
file lets TriOS skip a mod that's already installed.
- Add your .version url. Paste the link to your mod's
.versionfile with a workingdirectDownloadURLor to your mod's.zipdownload. - Mod ID & version. From your
mod_info.json/.version. Lets TriOS skip the mod download if it's already installed.
.version or mod_info.json file
Dependencies
- Add dependencies (optional). Click Add dependency
and paste each required mod's
.versionor.ziplink and its mod id.
.version or mod_info.json
Output
Preview
- Copy & paste. Click Copy, and paste it into your forum post.
- Test it! Note: requires TriOS 1.6.0 or later.
FAQ
What does this tool do?
It generates a one-click Install with TriOS link (and a forum badge) for your Starsector mod. You then paste the button into your forum page (or paste the link onto Patreon or wherever).
When someone clicks it, TriOS launches, downloads, and installs your mod, along with any dependencies
you list,
automatically.
If they don't have TriOS, they will be prompted to install it, and you can ask them why they clicked "Install with TriOS" without having it.
What do players need for the link to work?
TriOS 1.6.0 or later. Clicking the link opens a small launcher page that hands off to TriOS. If TriOS isn't installed, that page falls back to ordinary manual download links.
Why would I use this?
It lets people install your mod without thinking about how to install it (or the dependencies).
Also, it's kinda neat. It's like living in the future, if the future was ~2013.
Should I use a .version URL or a .zip link?
A .version file URL if you can. It auto-fills the mod version. It also means you only have to
update
your .version file if your download links change, not this button.
A .zip (or .7z, .rar, etc) link works too.
What is the Mod ID and Version for?
The mod id and version let TriOS recognize a mod that's already installed and skip re-downloading it so players don't redownload LazyLib 100 times.
What happens when a dependency updates? Will my button break?
No, your button keeps working. What it installs depends on the kind of link you used:
If you used a .version link, players always get the newest version. When LazyLib releases an
update, the same button starts installing the new one.
If you used a .zip link, players always get that exact file. It won't change until you swap in
a new link yourself, so if the mod author breaks that download link, your download link will break.
Note: TriOS won't redownload mods the player already has unless you enter a version, check the "Require this version or newer" checkbox, and the player has an old version of the mod.
So, if you link to LazyLib 3.0 and don't check that box and they have LazyLib 2.7, it won't download LazyLib. But if you fill in the version as 3.0 and check the box, it will update their version of LazyLib.
Why doesn't the preview show my mod's name?
The preview reads your .version file in your browser to show the name. Once in a while a host
can't be reached and the name doesn't show. That doesn't mean your link is broken — it still works. It's
always good to test it, though!
Is anything uploaded to a server?
No. Everything runs in your browser; the link is built entirely client-side and nothing is sent anywhere. This is a static website with no server-side logic at all.