Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
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.
| Last updated | 20 hours ago |
| Total downloads | 244 |
| Total rating | 1 |
| Categories | Mods Tweaks Misc AI Generated Deep North Update |
| Dependency string | L4zerShark_Team-SurtlingFuelItemHopperFix-1.2.2 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2351
ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2
DejanGegic-SurtlingFuel
Use Surtling Cores as super-fuel in smelters and blast furnaces. 1 core = 4 coal equivalent + 2x smelting speed. Fully configurable.
Preferred version: 1.4.0README
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
smelterandblastfurnace; 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, using Thunderstore 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.
