Most “missing mod” and “plugin stopped working” problems trace back to the same root cause: something is out of date, or you’re looking for it in a place that no longer exists. Here’s where HS2 content actually lives now, and how to keep an install healthy instead of chasing dead links.
Start with Better Repack
If you’re setting up fresh, or your current install is a mess of half-updated files, Better Repack is the source to reach for first. It bundles the game, BepInEx, the core plugin set (Modding API, Sideloader, HSPlugins, and the rest), and a large mod library into one download that installs as a working whole. See installing HS2 for the actual install steps.
The reason this matters beyond a first install: updating Better Repack is also the fix for most “a mod is missing” or “everything broke after an update” reports. It refreshes the core plugin chain and the bundled mod library together, which avoids the version-mismatch problems you get from patching individual files by hand.
Finding one specific missing mod
When a character card or scene reports a missing zipmod, don’t guess at the name. Copy the exact mod name or GUID from the error message (or export it from KK Manager, which lists the GUIDs a card requires), and search that exact string on the Better Repack sideloader site. Searching the precise GUID in quotes is far more reliable than searching a mod’s display name, since names get reused or translated differently across posts.
If a GUID genuinely doesn’t turn up anywhere on the sideloader site, it’s most likely a paid mod distributed through a creator’s Patreon rather than a free public zipmod. Search the creator’s name alongside the mod name to confirm.
mods, separate from the folders Better Repack's own updater manages. The updater only touches its own managed content, so keeping manual downloads in their own folder means an update won't quietly delete them.Character cards
Character and coordinate cards are mostly shared through the bepis card database and individual creators’ own posts, rather than through GitHub or the sideloader. Once you’ve downloaded a card, drop it in the matching folder under UserData\chara (male or female) so the game picks it up; see installing a mod for the rest of the file-placement rules for cards, coordinates, and scenes. If a card loads with missing mods, treat it the same as any other missing-mod case and search the reported GUIDs as above.
Plugins moved off GitHub
The original illusionmods GitHub organization, which hosted the Modding API, BepisPlugins, HSPlugins, and IllusionFixes, was taken down. Old links to it now 404. If a guide or an old post points you at github.com/IllusionMods and it doesn’t load, don’t assume the plugin is dead or abandoned. A community mirror carries the same repositories forward under current releases, commonly referred to by the name gitgoon. Search for the current gitgoon mirror of the specific plugin you need rather than treating the dead GitHub link as the end of the trail.
See installing a plugin for how to actually install a plugin once you’ve got the archive: plugin .dll files go in BepInEx/plugins, and you generally want the contents of the release’s own BepInEx folder merged into yours, not the raw source download.
Keep plugins and the API updated together
A large share of “this plugin suddenly broke” reports happen right after a major game update (an R release, such as R16). The plugin itself hasn’t changed, but the modding API it depends on has moved on, and an outdated plugin against a newer API produces exactly the kind of silent failure that’s hard to diagnose: menus that won’t open, dropdowns that don’t populate, windows that do nothing when you press their hotkey.
| Symptom | Usual cause | Fix |
|---|---|---|
| Card/scene reports a missing mod | mod not installed | search the GUID on the sideloader site |
| Menu or hotkey window won’t open at all | outdated Modding API (KKAPI) | update IllusionModdingAPI, then the affected plugin |
| A plugin’s dropdown or panel is empty after a game update | plugin not yet updated for the new API | update that specific plugin to its latest release |
| Recording or export looks corrupted with certain features enabled | known bug in an old plugin build | update to the plugin’s current release |
When you hit any of these, update the whole dependency chain, not just the one plugin complaining. The Modding API, BepisPlugins, and HSPlugins tend to move together, so updating only one of them can trade one broken feature for another.
Rules that keep an install stable
Don’t mix installation methods either. Pick either a patched Steam install or a standalone Better Repack, not both, and if you’re switching from one to the other, do a clean install rather than layering one over the top of the other.
Back up before you touch any of this
Before a reinstall, a big Better Repack update, or a manual plugin swap, back up your UserData folder (cards, scenes, coordinates, presets) along with your BepInEx folder. See saving and backing up for what to copy and where it lives. It takes a minute and it’s the difference between an update going wrong and an update going wrong being a non-event.
If something does break after an update, a plugin that won’t load and pink or invisible characters cover the most common symptoms and how to trace them back to the specific outdated file.