Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
A1 - Getting Started
Updated 3 weeks agoHow this wiki works
Foundations · everyone · start here. What Stitchwork is, whether you need it, how to install it. Five minutes.
The wiki is built in modules. Module A — Foundations (the A- pages) is the shared groundwork: what Stitchwork is, install, the Pack Manager, how replacement works, and what to do when things look wrong.
After Module A, the modules are optional and self-contained — take the ones your work touches: B Sprites · C Text · D Audio · E Video. Reference holds the lookups.
** Reading all of Module A first is recommended for all users — player or creator alike.** A player who reads only A can install and manage packs and stop there. A creator reads A, then jumps to whichever module(s) they need, in any order. Modules B–E are pick-and-choose by nature. You'll be able to: install Stitchwork, confirm it's running, and know where to go next.
What Stitchwork is
Stitchwork swaps Silksong's art, text, sound, font, and video on the fly without touching the game files — it intercepts what the game loads and hands back a replacement. Remove Stitchwork, and you're back to vanilla again with no fuss.
Stitchwork is a humble fork of Patchwork by Ashiepaws — the framework that pioneered this for Silksong, and to which this project owes great gratitude. Packs are collections of custom assets made by creators, structured as folders of replacement files — it could be a repainted Hornet or a creator's character of choice, custom music tracks and voicelines, a set of rewritten dialogue lines. Prior packs made for Patchwork load in Stitchwork unchanged. You may load many packs at once, toggle each one individually, and reorder whichever wins when two or more collide.
Who uses it
- Players install others' packs and live in the Pack Manager (lists and toggles packs).
- Creators make packs and live in the Dev Hub (a collection of tools for finding assets and previewing replacements).
Requirements
- Hollow Knight: Silksong. (Only tested on Windows platform)
- BepInEx 5 — the framework Silksong mods run on. Any other mod installed this already; if not, see the BepInEx setup guide (Troubleshooting has the link).
- A few hundred MB of free space on a storage device for large skin packs.
No need for Unity Editor, nor programming knowledge, nor a separate game build. (We made sure the install process is easy and as dependency-free as possible)
Installing
The DLL file, the ASSETBUNDLE file, and the Lang/ folder go together in one folder under BepInEx/plugins/. The recommended name for a manual install is StitchworkRoot — deliberately not Stitchwork, so the install never gets confused with the Stitchwork/ subfolder that packs use.
-
Download the latest release (Thunderstore or the community link).
-
Extract — you get a folder with
Stitchwork.dll,stitchwork.assetbundle, andLang/. -
Manual install: put it under
BepInEx/plugins/and name itStitchworkRoot:…/BepInEx/plugins/StitchworkRoot/Stitchwork.dll …/BepInEx/plugins/StitchworkRoot/stitchwork.assetbundle …/BepInEx/plugins/StitchworkRoot/Lang/(Thunderstore Mod Manager uses its own folder name — that's fine. Stitchwork finds itself wherever its DLL loads from, so the name is a tidiness recommendation, not a requirement.)
-
Keep one copy only. Upgrading? Replace the old files — a stray second
Stitchwork.dllelsewhere only confuses things. -
Launch the game.
Find a badge overlay bottom-left of your screen — the Status Overlay — seeing it means Stitchwork is alive.
First launch asks for one restart: Stitchwork enables a smoother-performance setting (incremental GC) that needs a single relaunch. One toast notification and one restart, then you are all set.
Packs start OFF
A new pack is disabled until you enable it in the Pack Manager.
This saves time from computing which assets are loaded and the replacement process.
It's 1 key press and 2 clicks to toggle a pack on.
Press 1 on the top row of number keys to bring up the Pack Manager GUI,
then find the skin pack you want to enable, click its toggle switch to ON, and click APPLY at the bottom of the Pack Manager GUI. Done.
Already using "Patchwork"?
Stitchwork is a fork of Patchwork, and the two can't run together (they fight over sprite loading). If Patchwork.dll is present, Stitchwork goes inert with a main-menu toast notification — remove Patchwork.dll to use Stitchwork.
From the Architect-Silksong editor? Architect does not need Patchwork and runs fine beside Stitchwork.
What now?
- Install a pack → Installing Packs
- Make a pack → Starting a Skin Pack, or the no-art-tools shortcut, Text & Dialogue
- Something's broken → Troubleshooting
Worth knowing
- Hot reload: save a PNG, see it in ~1s. (Only a new Stitchwork version needs a restart.)
- Quiet by design: packs activate on their own conditions; there's no in-world ON switch.
- Dev Hub is hidden — open it with the Hotkeys.
- Saves are safe: Stitchwork never writes any save data. Delete the Stitchwork components, and you're back to vanilla.
You can now install Stitchwork, confirm it's live, and pick your next page.
Pages
- A-0 Wikis
- A1 - Getting Started
- A2 - Installing Packs
- A3 - The Pack Manager
- A4 - How Stitchwork Works
- A5 - When Something Looks Wrong
- AEx1 - Conditional Activation
- B0 - Choosing a Workflow
- B1 - Starting a Skin Pack
- B2 - Finding Any Sprite
- B3 - Porting Prior Work — Spritesheets & CKC
- B4 - Texture2D (T2D) Sprites
- B5 - Bigger Art — Anchors
- B6 - Animation Canvas Workflow
- B7 - Sprite Paths Reference
- B8 - The Animation Controller
- BEx1 - Reused frames — one sprite, many animations
- BEx2 - Instance-specific paths — same name, different art
- BEx3 - Appliqué: Per-Clip Art
- C1 - Text & Dialogue
- D1 - Audio
- E1 - Video
- F1 - Priority & Conflicts
- F2 - Distributing Your Pack
- G1 - Dumping & Full Dump
- G2 - Companion Mods
- G3 - Hotkeys
- G4 - Pack Folder Structure
- G5 - Testing With Savestates (DebugMod)
- G6 - Troubleshooting