保护裸露的木材免受雨水和风化侵蚀！蜂箱可产出蜂蜡，制作涂层刷，为你的建筑上漆——涂装后的木材永不腐烂，还会泛出淡淡的金色光泽，并能在世界存档中持久保存。支持多人模式。

蜂蜡涂层

一个英灵神殿模组，让你可以通过以下方式保护暴露在外的木制结构免受雨水和风化影响： 蜂蜡涂层.

暴露的木材通常会吸收雨水并慢慢腐烂——雨水会将木材耐久度磨损至50%（每淋雨60秒造成最大耐久度5%的损伤）并维持在该水平。使用此模组，你可以制作一种涂层并用刷子将其涂刷到木制部件上——涂覆后的部件将 永久免疫雨水和无屋顶风化结构支撑失效、火焰、灰烬、岩浆伤害以及完全浸水仍然会生效。涂层会按每块部件存储在世界存档中，因此可跨存档保留，并且在多人模式中有效。适用于任何会风化的木质部件，包括船只。

制作

蜂蜡涂层 — 在工作台（1级）每次制作3个：

材料	数量
蜂蜡	2
树脂	1

该物品复用了原版蜂蜡的模型和图标。

获取蜂蜡

原版英灵神殿拥有 没有蜂蜡物品 — 此模组新增了一个，拥有完全自定义的程序化资源：一个抖动蜂窝块网格、一个带有六边形单元图案的蜡质纹理，以及一个手工栅格化的物品栏图标，全部由代码生成（没有克隆或复用任何原版预制体）。玩家建造的蜂箱会积累蜂蜡 宛如蜂蜜 — 相同生产效率，相同上限（默认4），悬停显示 （蜂蜡 x N） — 收获时会掉落全部累积数量。可通过以下方式禁用： 蜂蜡 = 假蜂蜡涂层刷使用了同套自定义素材中经过处理的浅色蜡变体。

用途

1. 在工作台制作蜂蜡涂层刷（2×蜂蜡 + 1×树脂 → 1把带10次使用次数的刷子）。
2. 把它放进快捷栏并装备——它像单手物品一样握持，耐久条会显示剩余充能次数。
3. 瞄准一个木质建筑部件，然后 左键点击 刷上涂层。支持手柄操作（攻击键）。任何木材类材料均可涂刷——包括墙壁、柱子、横梁、斜角/屋顶木材；石材及其他材料无法涂刷。
4. 按住左键扫过 一次处理多篇内容；扫描期间消息会被限流。
5. 刷子仅在耗尽次数时才会被消耗。涂层无法修复已有的损坏；请使用锤子进行修复。

配置

BepInEx/config/benjamin.beeswaxcoating.cfg

选项	默认	描述
显示悬停徽章	真	在悬停文本中追加一行“涂有蜂蜡”
用途	20	每制作一把笔刷的充能次数（1-100；仅对新笔刷生效）
蜂蜡	真	蜂箱像产蜜一样积累蜂蜡，并在收获时掉落
光泽涂层	真	涂漆木材上隐约的温暖光泽，无需悬停即可看见
光泽强度	0.15	涂层木质光泽的强度（0.05-0.5）

识别涂层木材

• 光泽：涂层碎片带有微弱的金色光芒（与游戏用于结构高亮显示的材料通道相同），碎片加载时每秒重新应用一次——从远处可见，在夜晚或室内最为明显。
• 悬停：瞄准一块蜂蜡时，会显示一条专用的琥珀色“蜂蜡涂层”提示线。

多人游戏

在服务器上安装该模组 和 所有客户端（由Jotunn版本检查强制执行——版本不匹配的客户端会被拒绝连接，而非静默发生不同步）。打蜡标记存储在每个部件的ZDO中并自动同步；磨损由拥有该部件的客户端模拟，因此服务器也需要安装此模组。

兼容性

基于当前公开版本构建（游戏程序集在构建时从英灵神殿专用服务器拉取）。不修改任何原版文件；所有内容均在运行时通过 Harmony 补丁处理。

安装

模组管理器（推荐）

通过 r2modman、Gale 或 Thunderstore 模组管理器从 Thunderstore 安装。

手动

1. 安装 BepInExPack Valheim 和 约顿巨人.
2. 将此模组解压到 蜂蜡涂层.dll 最终会到达 Valheim/BepInEx/plugins/.

从源代码构建

已包含完全容器化的工具链（需要Docker）：

scripts/image.sh # 构建工具链镜像（dotnet 8 + steamcmd + ilspycmd） scripts/fetch-refs.sh # 通过 steamcmd 下载 Valheim 专用服务器 → refs/（已缓存） scripts/fetch-libs.sh # 从 Thunderstore 下载 BepInEx + Jotunn → libs/ scripts/decompile.sh # 反编译游戏和 Jotunn 程序集以供参考 scripts/build.sh # 编译模组 scripts/package.sh # 生成 dist/BeeswaxCoating-<version>.zip scripts/make-icon.py # 程序化备用图标（仅在无徽标时使用）

放置一个 蜂蜡标志小图.png （或 蜂蜡标志.png在仓库根目录放置自定义图标——打包时会将其转换为 Thunderstore 要求的 256×256 尺寸（带黑边；需要 Pillow），且优先级高于默认回退图标。

测试

scripts/test.sh # 单元与契约测试（dotnet test，在容器内运行） scripts/check-package.sh # 验证打包后的 zip（需先运行 package.sh）

测试套件分为三层：

• 纯粹逻辑 (蜡质决策测试）：涂层决策状态机被提取到 src/WaxDecision.cs，一个不依赖 Unity 的类，测试直接编译它——发布的源码就是经过测试的源码。
• 游戏API契约 (游戏合约测试): 加载编译后的DLL 和 通过仅反射方式访问真实游戏程序集 元数据加载上下文 （无需 Unity 运行时）并断言该模组依赖的每一个成员—— 需要屋顶 （免疫补丁目标）， 物品栏.计数物品/移除物品，UI 防护静态数据， ZDO 布尔存储，并且 Harmony 补丁特性指向仍然存在的成员。 这里的失败意味着游戏更新破坏了模组——发布前请重新验证。
• 包装 (检查包.sh）：zip 布局（清单位于根目录）、清单架构、固定依赖项、256×256 图标、DLL 健全性检查。

游戏本身无法自动化的部分：Unity运行时行为、Harmony补丁应用以及多人同步——这些仍需在游戏内手动进行冒烟测试。

专用服务器（Docker）

包含一个完全模组化的专用服务器，镜像了置顶的模组列表 docker/服务器模组.txt:

scripts/fetch-server-mods.sh # 下载并暂存服务器模组（已缓存） scripts/server-build.sh # 构建 valheim-beeswax 镜像（使用缓存的服务器文件） docker compose -f docker/compose.yaml up -d docker logs -f valheim-beeswax

• 无密码，仅限局域网 (公开 0）：从游戏连接到 加入 IP → <主机>:2456
• 世界留存于 维京配置 Docker 卷；已暴露 UDP 2456–2457 端口
• 在专用服务器上，该模组会注册一个无视觉模型物品（服务器端构建不包含物品视觉资源），其名称标识与客户端使用的相同——客户端仍然会看到克隆的蜂蜡模型
• 通过编辑来更新模组列表 docker/server-mods.txt 并重新运行这两个脚本

授权

麻省理工学院