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

• Craft a Honey Seal brush at a workbench (1× Honey + 2× Resin → 1 brush with 20 charges).
• Put it in your hotbar and equip it — it's held like a one-handed item, and the durability bar shows remaining charges.
• 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.
• Hold left-click and sweep to wax several pieces in one pass; messages are throttled while sweeping.
• 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 Mod Manager.

Manual

• Install BepInExPack Valheim and Jotunn.
• 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 -> libs/

scripts/decompile.sh # decompile game + Jotunn assemblies for reference

scripts/build.sh # compile the mod

scripts/package.sh # produce dist/BeeswaxCoating-.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 c