WishUtil

版本 v0.2.0·更新於 2026-02-24

Library for creating custom Wishes

模組介紹 作者原文

Wish Util

This library provides utilities necessary for

creating custom Wishes.

Creating your Wish

First, you need to make your custom Wish object by

inheriting from CustomQuest.

The constructor will need to pass in a name that

serves as your Wish's in-game ID, as well as

LocalisedStrings for the Wish's display name and

location.

Your object will also need to override 3 properites:

  • GiveAtStart tells the game whether or not to assign

the Wish to the player on startup.

  • QuestType defines what type of Wish this is:

Hunt, Gather, etc.

  • You can use one of the default quest types by

calling GetQuestType.GetType.

  • Alternatively, you can submit a custom type

using GetQuestType.BuildCustomType. You will need

to provide a LocalisedString for the type's

display name, the type's text color, as well as 4

Sprites for the various icons.

  • You can find examples for these icons in the

Resources folder of this mod's Git project

(link).

  • GetDescription gives the textual description of

the Wish, as shown in the Task journal.

Adding your Wish to Silksong

After you've created your Wish, you need to add it to

the game. In the Start method of your mod, create an

instance of your Wish and use QuestData.AddQuest to

add it to WishUtil's custom Wish list.

You should probably store the Wish as a variable in

your mod for ease of reference, but you can find it

by name using QuestData.GetQuest.

Interacting with your Wish in Silksong

With your Wish now in the game, you can manipulate it

in your HarmonyPatches. CustomQuest currently has 3

methods you can call to change your Wish's status:

  • Accept() adds the Wish to the Task journal. You can

skip this part if you set GiveAtStart to true.

  • Update() signals the player that they have

progressed the Wish.

  • Complete() tells the game to log the Wish as

completed.

Special Thanks

the.ant.57 and MistDZX for testing and feedback

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack_Silksongsilksong_modding-I18Ndanielstegink-DanielSteginkUtils

檔案與校驗

檔案名稱
WishUtil-0.2.0.zip
檔案大小
2.3 MiB