How To Use Trinity Mod Loader

You've got a fresh install of Hollow Knight. Maybe it's your fifth. Day to day, maybe it's your first run. Either way, you've heard the whispers — "just use Trinity" — and now you're staring at a GitHub release page wondering what any of it actually means Nothing fancy..

Been there. We've all been there.

Trinity Mod Loader isn't complicated. But the documentation assumes you already know how mod loaders work. Practically speaking, if you don't, the learning curve feels steeper than it is. Let's fix that Took long enough..

What Is Trinity Mod Loader

Trinity is a community-built mod loader for Hollow Knight on Windows, Linux, and macOS. It sits between the game and your mods, handling injection, load order, and compatibility so you don't have to manually edit assembly files or pray to the Unity gods.

People argue about this. Here's where I land on it.

Think of it like a plugin manager — but for a game that was never designed to support plugins Still holds up..

It started as a fork of the original ModInstaller project, back when the modding scene was still figuring out how to hook into Hollow Knight's IL2CPP build. Trinity added proper MonoMod support, a cleaner UI, and — this matters — actual dependency resolution. If Mod A needs Mod B, Trinity tells you before things break Not complicated — just consistent..

It's open source. Actively maintained. And as of this writing, it's the only loader that reliably works across all three major platforms without jumping through hoops The details matter here. Less friction, more output..

What It Actually Does

• Injects a custom MonoMod runtime into the game process
• Loads .dll mods from a Mods folder
• Reads mod.json manifests for metadata, versioning, and dependencies
• Provides a launcher GUI for enabling/disabling mods and adjusting load order
• Handles updates via a built-in repository browser (mostly community-curated)

It doesn't create mods. It doesn't write code. It just makes the whole ecosystem work.

Why It Matters / Why People Care

You can play Hollow Knight vanilla forever. Still, plenty of people do. But mods change what the game is.

Randomizer? That said, that's a mod. Boss rush? Think about it: mod. So custom charms, new areas, quality-of-life fixes like auto-map or quick-cast — all mods. Some are tiny tweaks. Others are essentially full campaigns built on Team Cherry's engine Which is the point..

Without a loader, installing them means:

• Downloading raw DLLs from Discord or GitHub
• Dropping them into Managed folders manually
• Editing doorstop_config.ini by hand
• Debugging load order conflicts by trial and error
• Re-doing it all every time the game updates

Trinity eliminates that friction. And you click "Install. So naturally, " It works. When it doesn't, it tells you why.

And here's the thing most guides skip: **modding extends a game's life.Plus, ** Hollow Knight came out in 2017. The mod scene is still producing major releases in 2024. Trinity is the infrastructure making that possible.

How to Install Trinity Mod Loader

Let's walk through it cleanly. No assumptions.

Step 1: Own the Game Legitimately

Trinity works with Steam, GOG, and Epic versions. It does not work with cracked copies — and the community won't help you if you're using one. And buy the game. It's worth it.

Step 2: Grab the Latest Release

Go to the official GitHub: github.com/Trinity-Mod-Loader/Trinity.Mod.Loader/releases

Download the asset matching your OS:

• Windows: Trinity.Practically speaking, mod. Loader.Even so, windows. On the flip side, zip
• Linux: Trinity. On the flip side, mod. Loader.Linux.tar.gz
• macOS: `Trinity.Mod.Loader.macOS.

Don't download source code. You want the pre-built binary Not complicated — just consistent..

Step 3: Extract Next to the Game Executable

This is where people mess up.

Steam (Windows):

.../steamapps/common/Hollow Knight/
├── hollow_knight.exe
└── Trinity/          ← extract here

GOG (Windows):

.../GOG Games/Hollow Knight/
├── hollow_knight.exe
└── Trinity/

Linux (Steam):

.../steamapps/common/Hollow Knight/
├── hollow_knight
└── Trinity/

macOS (Steam): Right-click the app → Show Package Contents → Contents/MacOS/ → drop Trinity folder there Not complicated — just consistent..

The Trinity folder must sit beside the executable. On top of that, not inside Managed. Not in Documents. Right next to it.

Step 4: Run the Launcher Once

Windows: Double-click Trinity.Launcher.exe inside the Trinity folder Surprisingly effective..

Linux/macOS: Open a terminal in the Trinity folder and run:

./Trinity.Launcher

A window opens. Think about it: it creates a Mods folder. So naturally, it detects your game. It downloads the latest MonoMod runtime. You'll see a green checkmark next to "Game detected" and "Runtime ready Not complicated — just consistent. Worth knowing..

Close it. You're installed.

Step 5: Launch the Game Through Trinity

You have two options:

Option A: Use the launcher every time. Open Trinity.Launcher.exe, hit "Play." Mods load. Done.

Option B: Configure Steam/GOG to launch via Trinity.
Right-click Hollow Knight in Steam → Properties → General → Launch Options:

"C:\Program Files (x86)\Steam\steamapps\common\Hollow Knight\Trinity\Trinity.Launcher.exe" --play

Adjust the path. Now "Play" in Steam launches modded And that's really what it comes down to..

GOG Galaxy: Game → Configure → Custom executable → point to Trinity.Launcher.exe with --play flag Simple, but easy to overlook..

Linux Steam: Same launch option syntax. macOS: You'll need a wrapper script or just use the launcher directly.

How to Install Mods

Two ways. One's easier. One's necessary sometimes.

Method 1: In-Launcher Repository (Easiest)

Open the launcher. Click the "Repository" tab (globe icon). Also, click "Install" on any mod. Browse or search. Trinity downloads the DLL, reads its manifest, pulls dependencies automatically, and enables it Surprisingly effective..

Most popular mods are here: Randomizer 4, Hall of Gods, Pantheon+, Custom Knight, QuickMap, Benchwarp, DreamWielder...

But not everything is in the repo. Some authors host elsewhere. Some mods are too new. Some are private Easy to understand, harder to ignore..

Method 2: Manual Install (Still Easy)

Download a mod's .dll (and any dependencies) from GitHub, Nexus, or the author's Discord.

Drop the .dll file into:

.../Hollow Knight/Mods/

That's it. Next launcher refresh, it appears in the "Installed" tab. But enable it. Done That alone is useful..

Pro tip: If a mod has a mod.json inside a zip, extract the contents into Mods/ModName/, not the zip itself. Trinity reads folders, not archives But it adds up..

Load Order Matters

Some mods override the same methods. Load order decides who wins.

In the launcher's "Installed" tab, drag mods up/down. General rule:

1. Core libraries first (

…Core libraries first (e.g.Also, content‑heavy mods that introduce new areas, bosses, or items (Hall of Gods, Pantheon+, Dream Wielder). UI/quality‑of‑life tweaks that sit on top of the game’s existing screens (QuickMap, Benchwarp, Custom Knight HUD).
, MonoMod, Harmony, any shared framework DLLs).
Plus, foundation mods that add new systems or APIs (Randomizer Core, Modding Utilities, etc. 5. But 3. 2. In practice, 4. That's why ). Pure override or patch mods that deliberately replace or tweak existing behavior (certain cheat trainers, difficulty adjusters, or visual shaders) Surprisingly effective..

If you’re unsure where a mod belongs, check its description or the author’s notes—many will explicitly state “load after X” or “requires Y placed before.” The launcher’s “Installed” tab also highlights potential conflicts: a red warning appears when two mods edit the same method and neither is clearly ordered above the other. In that case, manually adjust the order until the warning disappears, or consult the mod’s discussion thread for community‑recommended sequencing Most people skip this — try not to..

Keeping Mods Up‑to‑Date

• Repository mods: Click the “Refresh” button in the Repository tab; the launcher will pull the newest version and prompt you to update if a newer release exists.
• Manual mods: Replace the old .dll (and any accompanying dependency folders) with the fresh files in Mods/ModName/. The launcher detects the change on its next scan and updates the version number shown in the Installed list.
• Dependency updates: Some mods bundle their own copies of shared libraries (e.g., a specific Harmony version). When you update a mod, verify that you aren’t unintentionally downgrading a shared dependency; the launcher will warn you if a DLL version conflict is detected.

Troubleshooting Common Issues

Removing or Resetting Mods

1. Disable first: In the Installed tab, toggle the switch off for the mod you wish to remove.
2. Delete files: Remove the mod’s folder from Mods/ (or just the .dll if it was a loose file).
3. Clean cache (optional): Trinity stores a small metadata cache in Trinity/cache/. Deleting this folder forces a full rescan on the next launch, useful after bulk removals.
4. Verify integrity: If you suspect leftover files are causing issues, you can delete the entire Mods/ directory and let the launcher repopulate it from the Repository (or re‑add your manual mods manually).

Final Tips for a Smooth Modding Experience

• Backup your save files (…/Hollow Knight/GameData/) before experimenting with major overhauls like Randomizer 4 or Pantheon+.

• **Use the launcher’s “Launch

• Launch safely: Use the launcher’s built-in “Launch” button to ensure all mod dependencies are resolved before starting the game. If you encounter instability, try the “Safe Mode” option, which temporarily disables non-essential mods to isolate conflicts That's the part that actually makes a difference..

• Stay updated: Regularly check the Trinity Repository and individual mod pages for updates. Compatibility patches are often released after game updates, and applying them promptly prevents unexpected behavior Turns out it matters..

• Document your setup: Keep a log of your mod list and load order, especially for complex configurations. This makes troubleshooting easier and helps you restore a working setup if something goes wrong That alone is useful..

• Respect mod licenses: Always follow the terms set by mod creators, whether they require attribution, prohibit redistribution, or mandate specific installation steps.

Conclusion

The Trinity Launcher transforms Hollow Knight’s modding experience into a streamlined, user-friendly process. By leveraging its intuitive interface, reliable dependency management, and troubleshooting tools, you can confidently explore the vast array of modifications available—from quality-of-life tweaks to transformative overhauls. Whether you’re a newcomer or a seasoned modder, the key to success lies in thoughtful configuration, proactive maintenance, and a willingness to experiment within the safety net the launcher provides. With these practices, your journey through Hallownest can be as limitless as your imagination.