Valheim mod: tameable Greyling resin workers that tend resin-burning fixtures
  • C# 92%
  • Python 5.6%
  • Shell 2.4%
Find a file
mchafer b8d18132b0 release: 0.2.0 — four things the owner has now seen work in game
Version marker, not a behaviour change: 0.1.9 already did all of this. What is
new is the label, and the docs saying which claims are backed by an in-game
observation and which are not.

Confirmed by the owner: taming with pukeberries, the vanilla stay/follow command
(including pressing E mid-job), the hunger gate, and the Greyling attacking a
burned-out piece to fill it in one action — "the attack works and looks decent".
That last one also retires the biggest unknown in the design: the animator
parameter's name and type are asset data that cannot be read offline at all, and
inspecting m_animator.parameters at runtime plus driving it through
ZSyncAnimation turned out to be the right mechanism rather than a guess that
happened to land.

Still open, and now the only blocker: multiplayer fuel sync. Two items are
recorded as unknown rather than assumed fine, because the owner reported the
behaviour and not the log — whether the hit-callback guard ever fires (if it
does not, delete it as dead weight), and whether the park-distance calibration is
being adopted.

BepInExPack dependency slug verified against the Thunderstore API as 5.4.2351,
matching the owner's own install.
2026-10-12 08:52:31 +00:00
assets feat: v0.1.0 vertical slice — tame Greylings, service extinguished torches 2026-10-11 18:30:12 +00:00
docs release: 0.2.0 — four things the owner has now seen work in game 2026-10-12 08:52:31 +00:00
package release: 0.2.0 — four things the owner has now seen work in game 2026-10-12 08:52:31 +00:00
src/TheresInFiller release: 0.2.0 — four things the owner has now seen work in game 2026-10-12 08:52:31 +00:00
tools fix: let the player's stay/follow command override a working Greyling 2026-10-11 19:01:27 +00:00
.gitignore build: net48 BepInEx 5 + HarmonyX scaffold with verified toolchain 2026-10-11 18:12:11 +00:00
AGENTS.md release: 0.2.0 — four things the owner has now seen work in game 2026-10-12 08:52:31 +00:00
nuget.config build: net48 BepInEx 5 + HarmonyX scaffold with verified toolchain 2026-10-11 18:12:11 +00:00
README.md docs: 0.1.2 notes, and the three traps that caused the in-game bugs 2026-10-11 19:03:50 +00:00

TheresInFiller (working name)

A Valheim mod: tameable Greylings that work as resin wardens — they walk over to your extinguished resin-fuelled torches, sconces and Jack-O-Turnips and stoke them back to life.

"Put it to the torch, for it fears the flame." — Greydwarf runestone

Status: v0.1.2, iterating against in-game reports from the owner. Confirmed working: taming, follow, stay, and a worker walking to a torch. Confirmed broken and fixed in 0.1.2: the fuel write and arrival test (torch stayed at 0/4), and E-while-working. Not yet re-tested. See AGENTS.md → "What is NOT verified in-game". Design rationale: docs/idea-annotations.md.

Build

./tools/package.sh          # build + assemble + zip
dotnet build src/TheresInFiller/TheresInFiller.csproj -c Release   # build only

Produces dist/TheresInFiller-<version>.zip in Thunderstore layout, importable by r2modman, plus the staged folder at dist/TheresInFiller/.

Requires BepInEx 5.4.x at runtime and nothing else (declared in package/thunderstore.toml).

Requirements: .NET SDK (net48 targeting pack is restored automatically). Game and Unity assemblies come from NuGet reference packages (Digitalroot.*) — nothing from the game needs to be copied into this repo, and the mod ships as a single DLL.

Layout

Path What
src/TheresInFiller/ plugin source
docs/idea-annotations.md design rationale + game facts sourced from weirdgloop
AGENTS.md environment constraints, verified game API notes, untested checklist
package/ Thunderstore-facing README, CHANGELOG, manifest
assets/ icon/thumbnail art (procedural placeholder)
tools/ package.sh, make_icon.py, apidump (game assembly inspector)

Not implemented yet

Breeding, worker tiers, the carried-resin porter model, an in-game settings menu, Jötunn config sync across multiplayer, and real concept art.