BeeswaxCoating
Protect exposed wood from rain and weathering! Beehives produce beeswax, craft coating brushes and paint your builds - coated wood never rots, gains a subtle golden sheen and persists in the world sav
模組介紹 作者原文
BeeswaxCoating
A Valheim mod that lets you protect exposed wooden structures from rain and weathering with Beeswax Coating.
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
Beeswax Coating — 3 per craft at the Workbench (level 1):
| Ingredient | Amount |
|---|---|
| Beeswax | 2 |
| Resin | 1 |
The item reuses the vanilla beeswax model and icon.
Getting beeswax
Vanilla Valheim has no beeswax item — this mod adds one, with fully custom procedural assets: a jittered honeycomb-chunk mesh, a wax texture with a hex-cell pattern, and a hand-rasterized inventory icon, all generated in code (no vanilla prefab is cloned or reused). Player-built beehives accumulate beeswax exactly like honey — same production rate, same cap (4 by default), hover shows ( Beeswax x N ) — and harvesting drops the full accumulated amount. Disable with HiveBeeswax = false. The Beeswax Coating brush uses a paler, treated-wax variant of the same custom assets.
Usage
- Craft a Beeswax Coating brush at a workbench (2× Beeswax + 1× Resin → 1 brush with 10 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 "Beeswax coated" line to hover text |
| BrushUses | 20 | Charges per crafted brush (1-100; applies to new brushes) |
| HiveBeeswax | true | Beehives accumulate beeswax like honey and drop it on harvest |
| 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 "Beeswax coated" 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)
script
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝,否則該模組不會生效: