SurtlingFuelItemHopperFix
Lets ItemHopper feed Surtling Cores and configured core fuels into smelters and blast furnaces. Prevents coal/core mixing and protects honey/drop transfers, including item provenance.
模組介紹 作者原文
SurtlingFuel ItemHopper Fix
Lets ItemHopper feed Surtling Cores, Black Cores and configured core-like
items into vanilla smelters and blast furnaces, using SurtlingFuel's fuel
amount and speed boost.
What it does
- Keeps coal and core fuel separate: one waits until the other is spent.
- Leaves items in the source when the machine is full or rejects the fuel locally.
- Restricts core fuel to smelter and blastfurnace; Eitr Refineries and other
machines do not receive core fuel or its speed boost.
- Repairs SurtlingFuel 1.4.0's older Valheim API calls.
- Protects honey and dropped-item transfers when insertion or pickup fails.
- Preserves item provenance when a dropped item merges into an existing stack.
Version 1.2.2 fixes that last case. A successful pickup of an item marked as
cheated now keeps that flag on the receiving stack. A refused pickup leaves the
destination's previous count and flag unchanged.
Install
Install this package and all dependencies on the server and every client, Mod Manager or r2modman. For a downloaded ZIP, use
Import local mod. Everyone must use the same add-on version, then restart.
For manual installation, put SurtlingFuelItemHopperFix.dll in
BepInEx/plugins/SurtlingFuelItemHopperFix/ and install dependencies separately.
Current dependency baseline
| Dependency | Version |
|---|---|
| Valheim | 1.0.16 |
| BepInExPack Valheim | 5.4.2351 |
| Jötunn | 2.30.2 |
| ItemHopper | 2.0.2 |
| SurtlingFuel | 1.4.0 |
| MultiUserChest, required by ItemHopper | 0.6.2 |
Keep both ItemHopper and SurtlingFuel installed. This package is their compatibility
add-on and contains neither dependency.
Settings
After the first launch, edit
BepInEx/config/local.valheim.surtlingfuelitemhopperfix.cfg:
| Setting | Default | Effect |
|---|---|---|
| Fuel / Additional Fuel Prefabs | BlackCore | Extra internal item prefab names accepted as core fuel by hoppers. |
Separate names with commas, semicolons or new lines. SurtlingCore is always
enabled; Coal is excluded from this list. The list is synced from the server
and controlled by its admins.
Every listed extra item receives the same fuel value and speed boost as a
Surtling Core. Remove BlackCore from the list if hoppers should not consume
Black Cores. This setting does not add manual Black Core fueling.
SurtlingFuel's own fuel-per-core and speed settings remain in its config.
Keep those values identical on the server and clients; SurtlingFuel 1.4.0 does
not synchronize them itself.
Limits and removal
Fuel and ore delivery retain ItemHopper's remove-then-RPC network protocol.
This release does not add transaction acknowledgements; simultaneous remote
transfers or disconnects during delivery are not guaranteed by the local-owner
checks. Other mods that replace these same methods may conflict.
Removing this package restores upstream behavior and removes these compatibility
guards. It adds no items or recipes. Existing fuel stored by SurtlingFuel remains
part of that mod's state.
Credits
Compatibility add-on by L4zerShark_Team. Thanks to
MSchmoecker and ItemHopper contributors,
DejanGegic for SurtlingFuel,
and the BepInEx, Harmony and Jötunn teams. Add-on source is under the included
MIT license; dependency DLLs are not bundled.
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：