Manual Station Pull

Manual Station Pull lets you manually load Valheim production stations from nearby accessible containers without turning them into automatic refuelers.

It is designed for players who like nearby-container crafting, but still want to decide when a furnace is filled and which ore it receives.

Features

• Pulls smelter/furnace inputs from nearby accessible containers when you use the station.
• Remembers the selected material per furnace.
• Dedicated selector shortcut: Left Alt + F1 by default.
• Normal Valheim Use never opens the selector.
• If only one compatible material is available and nothing has been selected yet, it can be selected automatically.
• If the selected ore runs out, the mod does not silently switch to another ore.
• Charcoal kilns pull exact vanilla Wood only.
• FineWood, RoundLog, YggdrasilWood and modded wood types are deliberately ignored by the kiln feature.
• Uses each station's own Smelter.m_conversion list, so compatible modded smelters can expose their accepted materials automatically.
• Respects normal container access checks, wards, containers currently in use and MUC_Ignore.
• Per-player/per-world selection persistence using the furnace ZDO identity.
• Lightweight Unity UI using Canvas / UnityEngine.UI, scaled against the current resolution.
• No automatic refill loop.

Usage

1. Store compatible ores/materials in containers near the furnace.
2. Aim at the furnace input.
3. Press Left Alt + F1 to open the selector.
4. Pick the material you want.
5. Use the furnace normally with Valheim's configured Use key.
6. Each manual interaction pulls one selected material from your inventory or a nearby accessible container.
7. Use Left Alt + F1 again when you want to change material.

The selector shortcut is configurable.

Charcoal kiln

The charcoal kiln is intentionally simpler.

Manual Station Pull only accepts the exact vanilla prefab:

Wood

These are ignored by the remote-pull feature:

• FineWood
• RoundLog
• YggdrasilWood
• other/modded wood types

No selector is shown for the kiln.

Language

The mod UI follows this strict rule:

• Valheim language French → Manual Station Pull UI is French.
• Any other Valheim language → Manual Station Pull UI is English.

Vanilla item names continue to use Valheim's own item localization.

Configuration

Generated file:

BepInEx/config/Zephyrfit.ManualStationPull.cfg

Important defaults:

[General]
Enabled = true
RangeMeters = 20
SpatialCacheSeconds = 0.35

[Controls]
SelectorModifier = LeftAlt
SelectorKey = F1
CloseSelectorKey = Escape
ShowHoverHint = true

[Stations]
PullKilnWood = true
ShowUnavailableInputs = false

[Selection]
Persistence = World

[Safety]
RespectContainerAccess = true
RespectWards = true
SkipInUseContainers = true
RespectMultiUserChestIgnore = true

Set SelectorModifier = None if you want the selector to use a single key.

Client / server

Manual Station Pull is a client-side mod.

• Install it on each player who wants the feature.
• It is not required on the dedicated server.
• Players without the mod continue to use stations normally.

The mod uses Valheim's normal networked station/container state rather than adding a custom server protocol.

Compatibility

RunicCrafting

RunicCrafting is not required.

When both are installed, Manual Station Pull focuses on the station-input workflow that motivated this mod: manually choosing and loading smelter inputs from nearby storage. It does not add an automatic refuel loop and does not replace RunicCrafting's normal nearby crafting/building systems.

SimpleAccessControl

Container eligibility uses Valheim's normal Container.CheckAccess(long) path, so access-control mods that patch that method can continue to participate in the decision.

MultiUserChest

Containers marked MUC_Ignore are ignored when RespectMultiUserChestIgnore = true.

Installation

Gale / Thunderstore Mod Manager

1. Install ManualStationPull by Zephyrfit.
2. Launch the client profile you use to play Valheim.
3. The dedicated server does not need this package.

The mod manager installs the precompiled DLL and BepInEx dependency. Normal users do not need the .NET SDK or the source-build installer.

Manual

1. Install denikson-BepInExPack_Valheim 5.4.2351 or later.
2. Copy ManualStationPull.dll to:

BepInEx/plugins/ManualStationPull/ManualStationPull.dll

1. Restart Valheim.

Maintainer / source build

The source DEVKIT is distributed separately from the public Thunderstore package.

The public Thunderstore package intentionally contains no ManualInstaller archive. The maintainer build/publish tools stay outside the end-user package.

PUBLISH_Thunderstore.cmd rebuilds against the locally installed Valheim assemblies, validates the package with tcli, asks for the Thunderstore service-account token through masked local input and publishes under the selected team namespace. The token is not written to disk.

Credits

Created for the Valheim community by Zephyrfit.

Changelog

0.2.5

• Release-candidate hardening before the first public Thunderstore upload.
• Fixed the transient transfer path so a remotely pulled item is staged into a unique empty inventory slot and the exact stored ItemData object is passed to vanilla Smelter.OnAddOre.
• Prevents the transient item from being merged into another stack before vanilla consumes it.
• Source removal is now checked explicitly before a transaction can continue.
• Strengthened French/English UI behavior: French only when Valheim reports French; every other language uses English for Manual Station Pull UI strings.
• The selector's static Close button is refreshed when the window opens, avoiding a stale startup-language label.
• Gale installer now removes an older legacy direct-install copy after a successful managed Gale import, preventing duplicate-version warnings.
• Added the finalized Thunderstore icon and public package metadata.
• Public package excludes source-build installers and maintainer archives.

0.2.4

• Added Gale-managed local package installation.
• Local package can appear normally in the selected Gale profile.
• Safe direct-profile fallback remains available when Gale CLI cannot be found.

0.2.3

• Added Valheim 1.0 split-assembly references.
• Updated current Inventory.AddItem handling.
• Private smelter calls resolved through cached Harmony reflection handles.

0.2.2

• Added missing Unity TextRenderingModule reference.
• Added managed-assembly preflight validation.

0.2.1

• Added dedicated configurable selector shortcut.
• Normal Use no longer opens the selector.
• Default selector shortcut: Left Alt + F1.

0.2.0

• Reworked into separate services.
• Unity Canvas selector with icons and resource counts.
• Spatial container cache.
• Transaction/rollback path.
• ZDO-based per-furnace selection persistence.

0.1.0

• Initial DEVKIT prototype.