You are viewing a potentially older version of this package. View all versions.
KydlDev-DrainTarPit-2.0.0 icon

DrainTarPit

A hand pump with hoses to drain tar pits. Put a strainer in the tar, pump with E and watch the level drop while the tar pours from the nozzle. Items in the pit stay. Add WaterAndTarPools to keep the tar in pools and pump water.

By KydlDev
Date uploaded 2 days ago
Version 2.0.0
Download link KydlDev-DrainTarPit-2.0.0.zip
Downloads 75
Dependency string KydlDev-DrainTarPit-2.0.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202
ValheimModding-Jotunn-2.30.2 icon
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
KydlDev-KydlCore-1.0.0 icon
KydlDev-KydlCore

Shared runtime for all KydlDev mods: one UI root and theme, the KY hub window (F6; the one menu of every KydlDev mod) and the KY-Items category and registry.

Preferred version: 1.0.0

README

DrainTarPit

A hand pump with hoses to drain Valheim's tar pits. Build a pump, run an intake hose with a strainer into the tar and an outlet hose with a nozzle somewhere else, then work the lever: the tar level drops and the tar pours out of the nozzle. Only the liquid is removed - Tar items, meat or anything else lying in the pit stay where they are, so you can walk in and pick them up once it is drained.

Want the pumped tar to stay, fill your own pools or pump water? Install the add-on WaterAndTarPools (needs this mod).

Pieces (Hammer > KY-Items)

Piece Cost Notes
Hand pump 10 Wood, 5 Iron, 4 Leather scraps, 5 Resin Intake and outlet snap points, a lever and a place to stand
Intake strainer hose 2 Iron, 2 Leather scraps, 2 Tar The end that goes into the tar
Outlet nozzle hose 2 Iron, 1 Leather scraps, 2 Tar The tar comes out here
Hose (1 m) 1 Leather scraps, 1 Tar
Hose (2 m) 2 Leather scraps, 2 Tar
Hose elbow 2 Leather scraps, 2 Tar 90 degree bend

Chain the hoses with their snap points. Tilt a held piece with Alt + scroll (pitch), Alt + Ctrl + scroll (roll) and Backspace to reset (keys configurable). Pieces only break when hit: no support, rain or fire damage.

Using the pump

  • E on the pump: step up to it. E again = one stroke. Hold E = keep pumping until you let go.
  • Shift + E, Space or walking away: step off. Getting hit throws you off the pump.
  • The hover text shows whether the intake and outlet chains are connected and why a stroke would fail.
  • Each stroke costs a little stamina. The strainer does not have to be perfect: it works with tar around its tip and up to half a metre above the surface.
  • Every stroke pulls 6 m³ of tar (strongest at the strainer, fading out over 4 m); the rest of the pit flows towards the hole faster while you pump.
  • A drained pit slowly seeps back (60 minutes by default).
  • See-through hoses show the tar moving through them; the stream, splashes and a short puddle appear where it comes out, with sounds. Everyone near the pump sees and hears it.
  • Multiplayer: one player at a time on a pump, everyone else sees the lever and the pumping animation.

Config

BepInEx/config/com.kydldev.DrainTarPit.cfg (changes are picked up while the game runs):

Section Settings
General EnableAll - switch the mod off while playing (built pieces stay)
DebugLog Enable - detailed log lines for bug reports
Building Enable (tilting and the KY-Items pieces), TiltKey, RollKey, TiltResetKey, TiltStep
Effects Enable (all effects and sounds), SoundEffects (all sounds of the mod), EffectsVolume, ScratchSounds, TarSplashSound, TarSlugFlow (tar visible in see-through hoses), LiquidFlowSpeed, NozzleFlowAmount, NozzlePuddle, NozzlePressure, NozzleFlowSeconds, PourSoundOffset
Drain Enable (the pumping itself), VolumePerStroke (5 - 30 m³), DrainRadius, StrainerSearchRadius, StrainerReach, MinTarDepth, MaxChainPieces, SnapTolerance, RefillMinutes (10 - 120)
Pump AutoReach - step the player towards the lever so both hands reach the handle
Build Time Hose Visuals Enable, Build Hose Style (Solid / Transparent) and Build Hose Opacity: the look a hose gets when you build it
World Hose Visuals Enable, World Hose Style (Default / Transparent / Solid) and World Hose Opacity: how every hose already in the world is shown

EnableAll and the section Enable switches can be changed while playing; the mod is active while EnableAll is on and at least one of Building, Drain or Effects is on.

Requirements

KydlCore (the F6 hub and the shared UI), BepInEx and Jotunn. Everyone on the server needs the mod, with the same version (the network check compares major, minor and patch). English only.

Known limits

  • The pour at the nozzle (stream, splashes, puddle) is shown to every player who has the pump loaded, but only while someone is pumping.

CHANGELOG

Changelog

2.0.0

  • Tested in game with the full TestLab suite (3 tests): 3 green runs in a row on 2026-11-05, plus the ecosystem run with all 12 KydlDev mods loaded together.
  • The hoses, elbow, strainer and nozzle are learned (with the game's normal "new piece" message) once you have collected tar; the pump once you have collected iron ingots. Before that they are not in the build menu.
  • Ported to the KydlDev layout (feature folders, Bootstrap/Configuration/Integrations folders, Harmony patches in one place, KydlCore feature registry). The mod is one feature, DrainTarPit. Checked in game on 2026-11-04 (clean start and quit with all mods loaded, no errors from this mod).
  • Network compatibility is now checked down to the patch version (was minor).
  • Breaking: needs the KydlCore mod (hard dependency; the mod manager installs it). The shared UI code, the input lock, the log and the KY-Items build category now come from KydlCore instead of a copy inside this mod.
  • All settings are on the DrainTarPit > Settings tab of the KY hub (F6), with the same controls as the config file.
  • English only: the German texts were dropped.
  • The pool menu and the pool sign texts live in WaterAndTarPools now.

1.0.0 - Initial release

  • Hand pump, intake strainer hose, outlet nozzle hose, 1 m / 2 m hoses and a hose elbow (Hammer > KY-Items).
  • Pump tar out of tar pits: single strokes or hold E to keep pumping, with full pumping animation (hands on the lever, the body bends with the stroke) seen by every player.
  • Only the liquid is removed; items in the pit stay. Drained pits seep back over time.
  • The tar travels visibly through see-through hoses and pours out of the nozzle with a stream, splashes, a puddle and sounds.
  • Pieces can be tilted and rolled while building.
  • Hose look per hose (solid / see-through) plus a world-wide override.
  • [General] EnableAll switches the mod off while playing.
  • English and German.
  • Works with the add-on WaterAndTarPools (pools for the pumped tar, water pumping, water styles, pool signs).