HoneySeal

HoneySeal

A Valheim mod that lets you protect exposed wooden structures from rain and weathering with Honey Seal — a wax brush crafted from honey and resin.

Exposed wood normally soaks up rain and slowly rots — rain wears wood down to 50% health (5% max-HP damage per 60s of wetness) and holds it there. With this mod you can craft a coating and brush it onto wood pieces — coated pieces are permanently immune to rain and no-roof weathering. Structural support failure, fire, ash, lava damage and full water submersion still apply. The coating is stored per piece in the world save, so it persists across sessions and works in multiplayer. Works on any weatherable wood piece, ships included.

Crafting

Honey Seal — crafted at the Workbench (level 1):

| Ingredient | Amount | |---|---| | Honey | 1 | | Resin | 2 |

Each craft yields 1 brush with 20 charges (configurable via BrushUses). Honey comes from vanilla beehives; resin drops from Greydwarves, Necks and felled trees. The brush itself uses the mod's custom procedural assets (honeycomb-chunk mesh, wax texture, generated icon); the ingredients are vanilla items.

Usage

1. Craft a Honey Seal brush at a workbench (1× Honey + 2× Resin → 1 brush with 20 charges).
2. Put it in your hotbar and equip it — it's held like a one-handed item, and the durability bar shows remaining charges.
3. Aim at a wood building piece and left-click to brush on the coating. Works with gamepad (attack trigger). Any wood-family material can be coated - walls, poles, beams, angled/roof wood included; stone and other materials are refused.
4. Hold left-click and sweep to wax several pieces in one pass; messages are throttled while sweeping.
5. The brush is consumed only when its charges run out. Coating does not repair existing damage; use the hammer for that.

Configuration

BepInEx/config/benjamin.beeswaxcoating.cfg

| Option | Default | Description | |---|---|---| | ShowHoverBadge | true | Append a "Honey sealed" line to hover text | | BrushUses | 20 | Charges per crafted brush (1-100; applies to new brushes) | | CoatedSheen | true | Subtle warm sheen on coated wood, visible without hovering | | SheenIntensity | 0.15 | Strength of the coated-wood sheen (0.05-0.5) |

Recognizing coated wood

• Sheen: coated pieces carry a faint golden glow (the same material channel the game uses for structural highlighting), re-applied every second while a piece is loaded - visible from a distance, most noticeable at night or indoors.
• Hover: aiming at a piece shows a dedicated amber "Honey sealed" line.

Multiplayer

Install the mod on the server and all clients (enforced by the Jotunn version check — mismatched peers are refused rather than silently desyncing). The waxed flag is stored in each piece's ZDO and syncs automatically; wear is simulated by whichever peer owns the piece, which is why the server needs the mod too.

Compatibility

Built against the current public build (game assemblies are pulled from the Valheim dedicated server at build time). No vanilla files are modified; everything is Harmony-patched at runtime.

Installation

Mod manager (recommended)

Install via r2modman, Gale or Thunderstore Mod Manager from Thunderstore.

Manual

1. Install BepInExPack Valheim and Jotunn.
2. Extract this mod so BeeswaxCoating.dll ends up in Valheim/BepInEx/plugins/.

Building from source

A fully containerized toolchain is included (Docker required):

scripts/image.sh        # build the toolchain image (dotnet 8 + steamcmd + ilspycmd)
scripts/fetch-refs.sh   # download Valheim dedicated server via steamcmd -> refs/ (cached)
scripts/fetch-libs.sh   # download BepInEx + Jotunn from Thunderstore -> libs/
scripts/decompile.sh    # decompile game + Jotunn assemblies for reference
scripts/build.sh        # compile the mod
scripts/package.sh      # produce dist/BeeswaxCoating-<version>.zip
scripts/make-icon.py    # procedural fallback icon (used only if no logo is present)

Place a BeeswaxLogoSmall.png (or BeeswaxLogo.png) at the repo root to use your own icon — packaging converts it to the Thunderstore-required 256×256 (letterboxed; requires Pillow) and takes priority over the fallback.

Testing

scripts/test.sh           # unit + contract tests (dotnet test, runs in the container)
scripts/check-package.sh  # validate the packaged zip (run package.sh first)

The test suite has three layers:

• Pure logic (WaxDecisionTests): the coating decision state machine is extracted into src/WaxDecision.cs, a Unity-free class that the tests compile directly — the shipped source is the tested source.
• Game API contracts (GameContractTests): loads the compiled DLL and the real game assemblies reflection-only via MetadataLoadContext (no Unity runtime needed) and asserts every member the mod depends on — WearNTear.HaveRoof (the immunity patch target), Humanoid.StartAttack (the left-click hook), Inventory.RemoveOneItem, the UI-guard statics, ZDO bool storage, and that the Harmony patch attributes point at members that still exist. A failure here means a game update broke the mod — re-verify before shipping.
• Packaging (check-package.sh): zip layout (manifest at root), manifest schema, pinned dependencies, 256×256 icon, DLL sanity.

What can't be automated without the game itself: Unity runtime behavior, Harmony patch application, and multiplayer sync — those remain the manual in-game smoke test.

Dedicated server (Docker)

A fully modded dedicated server is included, mirroring the pinned mod list in docker/server-mods.txt: