Scarab Hollow Knight Mod Installer Guide

The Knight, the playable character modded through Scarab in Hollow Knight
Mod Installer / Hollow Knight (PC)

Scarab, now continued as Lumafly, is the one-click mod installer and manager for the PC version of Hollow Knight.

Type: Mod managerMods: 300+Platform: PC only

"Scarab Hollow Knight" refers to The Knight icon Scarab, the community mod installer for the PC version of Hollow Knight. It downloads, installs, and toggles mods without any manual file copying, which is why it is the standard starting point for modding the game.

Scarab has since been continued as Lumafly (formerly Scarab+), a maintained fork that does the same job with newer fixes. According to the Lumafly documentation, it automatically downloads the Modding API that mods require, then pulls its list from the official modlinks feed of 300+ mods.

The Hollow Knight modding wiki recommends a manager like this over hand-installing files, since the API version has to match the game and dependencies have to load in order. In practice, Scarab and Lumafly handle both automatically, so a mod is usually one search and one click away.

This guide covers what Scarab is, how to download and run it, how to add and enable mods, the most popular mods worth grabbing, and how to disable everything cleanly if you want the vanilla game back. None of it touches the console versions, which cannot be modded.

  • What it is Mod manager icon A mod installer and manager for PC Hollow Knight, now continued as Lumafly.
  • What it does Mods icon Downloads the Modding API and 300+ mods, with one-click enable and disable.
  • Where mods show Title screen icon In the top-left corner of the title screen once installed.
  • Platform PC icon PC only (Steam, GOG); console versions cannot be modded.

What Scarab Is

Scarab is a standalone app, not an in-game menu. According to its documentation, it is a mod loader, installer, and manager rolled into one, built so that getting the 300+ available Hollow Knight mods takes a search and a click rather than manual file work.

The key thing it handles is the Modding API icon Modding API. Mods cannot load without it, and its version has to match the game. Scarab downloads and installs the correct API for you, which is the step most hand-modding guides get wrong.

It also reads the official modlinks feed, so the in-app list stays current. Per the project docs, you can search mods by name, tag, author, description, or dependency, and right-click to pin a mod so the manager never removes it on an update.

FeatureDetail
TypeMod loader, installer, and manager
Handles APIDownloads the matching Modding API
Mod count300+ from official modlinks
Manual installsSupported for off-list mods
Offline modeToggle mods without internet

How to Install Scarab

Setup is short. The manager points itself at the game folder and handles the rest.

  1. Download the app. Grab the latest Scarab or Lumafly release from its official page. It runs on Windows, and the same project ships Mac and Linux builds.
  2. Point it at Hollow Knight. On first launch it locates the game; if not, set the path so the folder with Hollow Knight game icon the game data sits inside it.
  3. Let it fetch the API. The manager downloads and installs the Modding API automatically the first time you add a mod.
  4. Confirm it loaded. Launch the game; a mod list appears in the top-left corner of the title screen when the API is active.
Build Tip

Keep the base game updated to the current version before installing. In actual play, most load failures trace back to a Modding API that does not match the game build, which the manager fixes once both are current.

Adding and Enabling Mods

Once Scarab is running, mods are managed entirely from its window. According to the docs, the workflow is search, download, then toggle.

  1. Search the list. Filter the 300+ mods by name, tag, or author, or read the descriptions to find what you want.
  2. Download to install. Clicking download installs the mod and any dependencies it needs to run.
  3. Toggle on or off. Each mod has an enable/disable switch, so you can leave mods installed but inactive without deleting them.
  4. Update when prompted. An orange update button appears for outdated mods; clicking it pulls the newest version from modlinks.

For mods that are not on the official list, Scarab provides a manual install button that places the files correctly. In practice, this covers test builds and niche mods that never shipped to modlinks.

A few mods show up in almost every modded Hornet icon Hollow Knight setup. These are the common starting picks once Scarab is running.

ModWhat it does
Custom KnightSwaps in custom skins for the Knight and more
Randomizer 4Shuffles item and ability locations for a new run
DebugModAdds noclip, save states, and testing tools
SatchelA shared menu framework many other mods rely on
QoLQuality-of-life tweaks to the base experience

The Randomizer in particular gives the game roguelike-style replay value, reshuffling where the charms icon charms, keys, and movement upgrades hide. Per the modding wiki, it is one of the most-installed mods in the whole catalog.

Disabling Mods and Going Vanilla

Mods never overwrite the base game files, so going back to vanilla is simple. According to the docs, every mod can be switched off from Scarab without uninstalling it.

  1. Toggle mods off. Flip each switch to disabled to play vanilla while keeping the mods installed for later.
  2. Disable the API. Turning the Modding API off restores the unmodded game entirely.
  3. Use offline mode if needed. Scarab can launch offline to toggle mods and the API when there is no connection.

In practice, this matters for achievements and for boss runs you want to keep legitimate. Toggle the mods off, beat the Grimm boss icon bosses, even the hardest boss, on a clean save, then switch the mods back on afterward.

Common Mistakes

  1. Expecting it to work on console. Scarab is PC only. The Switch, PlayStation, and Xbox versions of Hollow Knight cannot run mods.
  2. Hand-installing the API. Letting Scarab fetch the Modding API avoids the version mismatch that breaks manual setups.
  3. Ignoring dependencies. Some mods need a framework like Satchel. The manager installs these, but disabling them can silently break the mods that need them.
  4. Modding the only save. Some mods alter save data. Keeping a clean save slot protects a vanilla run and any achievements tied to it.
  5. Skipping updates after a game patch. A new game version can need an updated API and mods. The orange update button is the fix.

Scarab FAQ

What is Scarab in Hollow Knight?

Scarab is a mod installer and manager for the PC version of Hollow Knight. It downloads the Modding API and lets you install, enable, and update mods from one window.

Is Scarab the same as Lumafly?

Effectively yes. Lumafly, formerly Scarab+, is the maintained continuation of Scarab. It does the same job with newer fixes and the same modlinks catalog.

Does Scarab work on console Hollow Knight?

No. Modding is PC only. The Switch, PlayStation, and Xbox versions cannot load mods, so Scarab has no effect there.

Do I need the Modding API for Scarab?

Yes, and Scarab installs it for you. According to the docs, the API must match the game version, which is why letting the manager handle it avoids errors.

How do I uninstall or disable mods?

Toggle each mod off in Scarab, or disable the Modding API to go fully vanilla. Mods stay installed but inactive until you switch them back on.

Where do installed mods appear in the game?

In the top-left corner of the title screen. A mod list shows there once the Modding API is active, confirming the install worked.

What are the best mods to install first?

Custom Knight for skins and Randomizer 4 for fresh runs are common first picks. DebugMod adds testing tools, and Satchel backs many other mods.

Will mods disable Steam achievements?

Some can affect them. Keep a clean save slot and toggle mods off for legitimate runs to protect achievements you still want to earn.

More Hollow Knight Guides

Once the mods are running, the base game is still the best place to start. These guides cover the charms, bosses, and economy a modded run builds on.

Sources

Scarab and Lumafly are community-made tools and are not affiliated with Team Cherry. Mod compatibility and feature details follow the official project documentation, which is updated by its maintainers.