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
Makes ItemHopper feed Surtling Cores, Black Cores, and configured extra core fuels through SurtlingFuel's proper fuel RPC.
| Last updated | an hour ago |
| Total downloads | 3 |
| Total rating | 0 |
| Categories | Mods Misc AI Generated |
| Dependency string | L4zerShark_Team-SurtlingFuelItemHopperFix-1.0.0 |
| 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.2333
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.29.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 1.0.0
Makes ItemHopper feed SurtlingFuel-compatible core fuel into coal-fired smelters and blast furnaces correctly.
What it fixes
ItemHopper 2.0.0 normally accepts only the machine's vanilla fuel item and calls Valheim's RPC_AddFuel. SurtlingFuel 1.4.0 uses a different RPC and tracks how much of the current fuel came from cores. Changing only ItemHopper's item filter would therefore give the wrong fuel value and could mix coal with core fuel.
This add-on patches both ItemHopper checks:
| Hopper item | Empty machine or core fuel active | Coal active | Result |
|---|---|---|---|
| Coal | Loads normally | Loads normally | Uses ItemHopper's original RPC_AddFuel. |
| Surtling Core | Loads | Waits in hopper | Uses SurtlingFuel's configured fuel value and speed boost. |
| Black Core | Loads by default | Waits in hopper | Treated as SurtlingFuel core fuel. |
| Configured extra prefab | Loads | Waits in hopper | Treated as SurtlingFuel core fuel. |
While core fuel is active, coal waits in the hopper. While coal is active, configured core items wait in the hopper. This preserves SurtlingFuel's no-mixed-fuel behavior. A full machine also leaves the item in the hopper.
Only machines whose normal fuel is Coal are affected. That includes the vanilla smelter and blast furnace and avoids feeding valuable cores into kilns, windmills, or unrelated Smelter-based machines.
Black Core behavior
SurtlingFuel 1.4.0 itself recognizes only SurtlingCore. This add-on deliberately includes BlackCore in its server-synced hopper list, because that was part of the requested behavior.
A Black Core loaded by a hopper receives the same fuel amount and speed boost as a Surtling Core. This add-on does not change manual E-key fueling, so Black Cores are hopper-only unless another installed mod also supports them manually. Remove BlackCore from the config if you do not want hoppers to consume them.
Multiplayer requirement
Install this package on the dedicated server and every client. ItemHopper already has the same requirement, and a hopper can update on the current network owner. Jötunn enforces that everyone has a compatible copy of this add-on.
Additional Fuel Prefabs is server-synced and admin-only. SurtlingFuel 1.4.0 does not synchronize its own balance settings, so keep its SmelterFuelPerCore, BlastFurnaceFuelPerCore, and SpeedMultiplier values identical on the server and clients.
Requirements and checked versions
- BepInExPack Valheim 5.4.2333
- Jötunn 2.29.2
- ItemHopper 2.0.0
- SurtlingFuel 1.4.0
The DLL was compiled against the public Valheim 0.221.4 API. The exact ItemHopper 2.0.0 binary and source path and the exact SurtlingFuel 1.4.0 binary behavior were inspected. This build environment cannot launch a live Valheim client/server, so run the copied-profile test below before using valuable Black Cores in the main world.
Install with Thunderstore Mod Manager or r2modman
- Download this ZIP without extracting it.
- Open the Valheim profile that contains ItemHopper and SurtlingFuel.
- Open Settings and choose Import local mod.
- Select
SurtlingFuelItemHopperFix-1.0.0.zip. - Put the same version on every client and the dedicated server.
- Launch once to generate the config.
For a manual installation, place SurtlingFuelItemHopperFix.dll in BepInEx/plugins/SurtlingFuelItemHopperFix/ on the server and every client.
Config
Generated at:
BepInEx/config/local.valheim.surtlingfuelitemhopperfix.cfg
| Setting | Default | Purpose |
|---|---|---|
Fuel / Additional Fuel Prefabs |
BlackCore |
Server-synced prefab-name list. SurtlingCore is always enabled; Coal is always ignored. |
Separate entries with commas, semicolons, or new lines. Example:
BlackCore, MyCustomCore
Use internal prefab names, not localized display names. Every extra item uses SurtlingFuel's core fuel value; there is no separate multiplier per item.
Copied-profile test
- Aim an ItemHopper output at an empty smelter. Put one Surtling Core in the hopper.
- Confirm the core leaves the hopper and the smelter gains the configured SurtlingFuel amount, not one vanilla coal unit.
- Repeat with one Black Core. Confirm it behaves exactly like the Surtling Core.
- While core fuel remains, put coal in the hopper. Confirm the coal waits and is not deleted.
- Let core fuel reach zero. Confirm the waiting coal loads normally.
- Reverse the order: start with coal, then add a core. Confirm the core waits until coal reaches zero.
- Fill a machine, then put a core in the hopper. Confirm it remains in the hopper.
- Repeat while connected to the dedicated server and check the BepInEx log for red errors.
Uninstall
Remove this package from the server and every client, then restart. It creates no items, recipes, pieces, or permanent world data. ItemHopper returns to coal-only fueling. SurtlingFuel keeps controlling any fuel already present in a machine.
Source is included under src/ and released under the MIT License. See CONFIG_REFERENCE.md, SOURCE_RESEARCH.md, and THUNDERSTORE_LISTING.md for the complete details.
