QuestMod

BepInEx mod for Hollow Knight: Silksong. F9 opens a panel for managing quests (wishes): accept, complete, undo, tweak target counts, bypass story gates, and apply custom rules.

Current release: v2.2.0

What it does

• All Wishes Mode (Tools): Disabled (vanilla), Adjusted (recommended — opens wishes but keeps chain order, exclusions, and edge-case patches), Pure (raw, no checks; Advanced only). See docs/AllWishesModes.md.
• Per-quest Accept / Drop / Complete / Undo Complete, plus Available + AutoAccept toggles with bulk reset.
• Remote Complete (Tools, per-save): when ON, Complete mirrors NPC turn-in (deduct targets, grant rewards, cascade). When OFF (default), Complete is flag-only — only QuestData flags flip. See docs/CompleteAndUndo.md.
• Auto-Accept Available (Tools): each scene load accepts wishes that pass natural availability (chain-aware). Unlike Accept All, story-locked wishes wait for their gate.
• Chain quests collapse into one row with step navigation.
• Mass-accept / mass-complete available wishes with Undo Last Mass Operation.
• Granular prereq bypasses per save: Fleatopia, Mandatory Wishes, Faydown Cloak, Needolin, Bonebottom Quest Board, plus Quest Boards Always Available (all three wishwalls).
• Target count overrides (Targets tab): sliders, presets (Set to 1, Half, Default), category multiplier.
• Checklist UI for multi-target / sequential wishes (Mr Mushroom, etc.).
• Delivery tab: Gourmand timer freeze, quest item invincibility.
• Custom requirements presets from Tools; optional BepInEx/config/QuestMod/QuestRequirements.user.json overlay. See docs/CustomRequirements.md.
• Save state Copy/Paste via clipboard.

Destructive features are gated behind a one-way safety override per save. Legacy saves stay vanilla until you confirm.

Removed in 2.2.0

• Silk & Soul tab / point overrides
• Tags editor tab (rules still work via presets + user JSON)
• Wish Location Reassignment scaffold (never implemented)
• One-click Act 3 (blackThreadWorld) Tools toggle

Install

Use Gale or any Thunderstore mod manager. Dependencies pull automatically (BepInExPack_Silksong, DataManager, FsmUtil, UnityHelper).

Manual: drop QuestMod.dll into BepInEx/plugins/QuestMod/ (or DatUub-QuestMod/).

Keys

F9 opens the Quest Manager. Rebindable in BepInEx config (GuiToggleKey).

Config

BepInEx/config/com.silkmod.questmod.cfg or the Tools tab.

The cfg file has full descriptions for each entry.

Tabs

Complete / Undo (support)

Full detail: docs/CompleteAndUndo.md.

Default world-state list (flag-only refuse): Flea Games, Flea Games Pre. Extend via worldStateComplete in embedded QuestCapabilities.json if you maintain a fork.

Known issues

• With Quest Boards Always Available, the Fixer NPC may briefly play his hammering animation before the FSM rewrite catches him (Addressables load; patch retries for ~30s). The kiosk stays interactable.
• Flag-only Complete does not advance minigame / world FSM wishes — see Complete / Undo above.
• Undo Complete clears completion flags only; it does not refund abilities or minigame progress.

Docs

Building

git clone <repo>
# Optional: SilksongPath.props with your install path for post-build copy
dotnet build -c Release

Thunderstore package:

dotnet build -c Release -t:ThunderstorePack

Dev harness (not in Thunderstore builds)

SelfTest + GuiShots compile only when explicitly enabled:

dotnet build -c Release -p:COMPILE_SELFTEST=true

Do not ship SelfTest builds to Thunderstore. Local harness sources are gitignored.

Contributing

Issues and PRs welcome. Target main. Test in-game; check BepInEx/LogOutput.log when something misbehaves.

Thanks

TheMythical2046 for the original request, quest research, and testing.