QuestMod

A BepInEx mod for Hollow Knight: Silksong that gives you full control over the quest (wish) system — unlock, accept, complete, rewind, and tweak quest targets from an in-game GUI.

Features

• Quest State Control — Accept, complete, un-accept, or un-complete any quest
• Chain Quest Grouping — Multi-step quest chains (Main Story, Citadel, etc.) collapsed into single rows with ◀/▶ step navigation
• Per-Save "All Quests" Mode — Unlock all quests on boards and NPCs for the current save (resets on title screen)
• Target Count Overrides — Edit quest completion targets (e.g. lower Silver Bells from 8 → 3) with per-target sliders, QoL presets, and a multiplier slider
• Checklist Toggles — Toggle individual sub-targets for multi-target quests (Grand Gate bellshrines, Flea Games, etc.)
• Silk & Soul Tab — Edit threshold requirements, quest point values, and track completion progress
• Mass Operations — Accept All / Complete All with undo support (gated behind config)
• Guaranteed Silver Bells — Force every bell drop to be a Silver Bell (overrides the 75/25 split)
• Quest Item Protection — Prevent delivery quest items from being destroyed by enemy attacks
• Act 3 Toggle — Manually toggle Black Thread World state
• Data-Driven — Quest registry, max caps, chains, and S&S data all loaded from QuestCapabilities.json

Installation

Via Thunderstore (recommended)

Install QuestMod from Thunderstore using a mod manager like Gale. Dependencies are installed automatically.

Manual

Put QuestMod.dll into BepInEx/plugins/QuestMod/.

Dependencies

Install these from Thunderstore first:

• BepInExPack_Silksong
• DataManager
• FsmUtil
• UnityHelper

Keybinds

Config Options

Found in BepInEx/config/com.silkmod.questmod.cfg, or via the Tools tab in the GUI.

Advanced (hidden by default):

Per-save toggles (set in the Tools tab, reset on title screen):

GUI Tabs

Known Issues

• Plasmium quests cannot be completed without the Needle Phial in All Wishes Mode
• Shakra does not appear when Trail's End is active in All Wishes Mode
• Junilana has missing NPC behavior in All Wishes Mode
• Mr Mushroom may not spawn at later locations in All Wishes Mode

Project Structure

QuestMod/
├── Core/
│   ├── QuestAcceptance.cs         # Quest state changes + chain registry
│   ├── QuestCompletionOverrides.cs # Persisted target count overrides
│   └── SilkSoulOverrides.cs       # Silk & Soul threshold/point overrides
├── Data/
│   ├── QuestDataAccess.cs         # Reflection helpers for RuntimeData
│   ├── QuestModSaveData.cs        # Per-save data via DataManager
│   └── QuestRegistry.cs           # Loads QuestCapabilities.json
├── GUI/
│   ├── QuestGUI.cs                # Main GUI window + tab routing
│   ├── QuestGUI.Quests.cs         # Quests tab (chain + standalone)
│   ├── QuestGUI.Targets.cs        # Targets tab (count overrides)
│   ├── QuestGUI.Checklist.cs      # Checklist tab (sub-target toggles)
│   ├── QuestGUI.SilkSoul.cs       # Silk & Soul tab
│   ├── QuestGUI.Tools.cs          # Tools tab (toggles, mass ops)
│   └── QuestGUISkin.cs            # Custom IMGUI skin
├── Patches/
│   ├── QuestStateHooks.cs         # FSM patching for quest availability
│   ├── QuestItemProtection.cs     # Delivery item invincibility
│   └── SilverBellPatch.cs         # Guaranteed Silver Bell drops
├── Util/
│   └── ReflectionCache.cs         # Shared reflection helpers
├── QuestCapabilities.json         # Quest definitions (embedded resource)
├── QuestModPlugin.cs              # Plugin entry point & config
└── QuestMod.csproj

Building

1. Clone the repo
2. Set your game path in SilksongPath.props:

<Project>
  <PropertyGroup>
    <SilksongFolder>C:\path\to\Hollow Knight Silksong</SilksongFolder>
  </PropertyGroup>
</Project>

1. dotnet build

To create a Thunderstore package: dotnet build -c Release -t:ThunderstorePack

Documentation

• Quest Modding Capabilities — detailed reference for all 82 quests, split by category: internal data, targets, prerequisites, and what QuestMod can modify

Contributing

Bug reports and feature requests welcome via GitHub Issues.

Pull requests are welcome! Please:

• Target the main branch
• Keep PRs focused on a single feature or fix
• Test in-game before submitting
• Check BepInEx/LogOutput.log for errors

SPECIAL THANKS

• TheMythical2046 - For the original mod request, quest research and testing, and feedback :3