ValheimQuickFill

ValheimQuickFill

一鍵裝滿熔爐與炭窯。按住 Ctrl 再按 E 與熔爐、炭窯（或風車磨坊）交互，即可把礦石或燃料一次性裝到容量上限。不按 Ctrl 時保持原版逐個裝入的行爲，兩者互不影響。

Valheim 裏往熔爐塞礦石、往炭窯塞木材都要一個一個點，長按 E 的灌注速度又很慢。這個 mod 只是把"點很多次"變成"一次點滿"，不改變任何配方、產量或遊戲規則。

功能

• 裝礦：對準熔爐，按住 Ctrl + E，把背包中的可熔礦石一次裝滿（上限 10）。
• 加燃料：對準熔爐或炭窯，按住 Ctrl + E，把燃料一次裝滿（上限 10）。同時安裝了 ValheimResinFuel 時熔爐會優先裝填樹脂（效力與木炭相同），不夠再裝木炭；未安裝該 mod 時只裝木炭/木材，與原版一致。
• 不按修飾鍵時，完全是原版行爲（裝了 ValheimResinFuel 時，普通按 E 同樣優先裝樹脂）。
• 多人聯機中經由遊戲自帶的 RPC 同步，只需客戶端安裝。

安裝

方式一（推薦，用 mod 管理器）：通過 r2modman Mod Manager 搜索 ValheimQuickFill 安裝，會自動處理好 BepInEx 依賴。

方式二（手動）：

• 先安裝 BepInExPack for Valheim（denikson-BepInExPack_Valheim）。
• 把本 mod 的 ValheimQuickFill.dll 放入 BepInEx/plugins/。
• 啓動遊戲。

配置

首次啓動後生成 BepInEx/config/local.valheim.quickfill.cfg：

| 配置項 | 默認值 | 說明 |

| --- | --- | --- |

| FillModifier | LeftControl | 觸發一鍵裝滿需按住的鍵。支持 Control / Shift / Alt（任一側），或具體鍵名如 LeftShift；逗號分隔可配多個鍵。 |

| DebugLogging | false | 開啓後在日誌輸出補丁命中細節，用於排查。 |

會不會影響成就

不會。本 mod 不設置 Game.isModded、不觸碰人物的 m_usedCheats、不給物品打作弊標記，因此不會禁用成就。若你同時使用控制台作弊命令或其他主動標記 mod 的插件，則屬於那些功能自身的影響。

兼容性

• 遊戲版本：Unity 6 時期的 Valheim（使用新版 Input System）。
• 依賴：BepInEx 5.x + HarmonyX。

已知問題 / 說明

• 修改按鍵或開關插件後需要重啓遊戲，無法熱插拔。
• Steam 的"驗證遊戲文件完整性"可能刪除根目錄的 winhttp.dll，導致 mod 失效；此時重裝 BepInEx 即可。
• 若按鍵無效，把 BepInEx/LogOutput.log 發到問題區。加載成功會有 ValheimQuickFill loaded 一行。

來源與許可

MIT License，詳見倉庫內 LICENSE。歡迎在 GitHub 提 issue / PR。

從源碼構建

插件依賴遊戲與 BepInEx 的託管程序集，因此需要把它們作爲編譯引用：

• 安裝.NET SDK（構建目標爲 netstandard2.1）與 Node.js（打包腳本用）。
• 把本倉庫克隆到 Valheim 安裝目錄下（默認假定.. 就是遊戲根目錄）。
• 遊戲根目錄需已安裝 BepInEx（BepInEx/core/BepInEx.dll、BepInEx/core/0Harmony.dll）。
• 構建並生成發佈包：./build-package.sh 你的ThunderstoreTeam名

產物：dist/你的Team名-ValheimQuickFill-版本號.zip

倉庫不在遊戲目錄下時，用屬性覆蓋路徑：

dotnet build -c Release -p:ValheimDir="C:\Steam\steamapps\common\Valheim\"

倉庫結構：

QuickFillPlugin.cs 插件源碼

ValheimQuickFill.csproj 項目文件

manifest.json 元數據

README.md / CHANGELOG.md / LICENSE

icon.png 圖標（256x256）

build-package.sh 一鍵構建 + 打包

tools/zip.js 無依賴 ZIP 打包器（保證 zip 內爲正斜槓路徑）

tools/make-icon.js 重新生成 icon.png