分层迷雾之地鬼火火炬和灯，扩大驱雾范围，支持交互式火炬涂色，以及多人游戏颜色同步。

WispTorchHeeler

分层迷雾之地鬼火火炬与除雾灯，扩大除雾范围，支持交互式火炬涂色，并实现多人游戏色彩同步。

【注意】 客户端与服务器兼容性： 这个模组可以安全地安装在本地客户端上，在专用服务器上运行流畅，零不同步，并支持服务器强制执行策略。对于多人游戏中的自定义部件，客户端和服务器都需要安装此模组。

---

问题

在原版《英灵神殿》中，要驱散迷雾之地的浓雾，需要密集放置数十个脆弱的小型原生鬼火火炬。这会导致：

• 严重的视觉杂乱与建造疲劳广阔的雾隐之地基地、农场和运输通道很快就会退化成杂乱无章的枯枝灌木丛。
• 性能开销数十个重叠的粒子系统力场、动态点光源和粒子发射器同时运行，会导致明显的帧率下降。
• 僵硬美学建造者被锁定为单一的固定青色/白色调色板，无法自定义以适配不同的建造主题、建筑风格或室内氛围。
• 脆弱：原生火把只有100点生命值，很容易因战斗中的附带伤害、探求者的攻击或矮人的流弹而损坏。

---

解决方案

鬼火牧羊犬 引入四种分层的迷雾之地后期照明装置，其驱散迷雾的半径逐级增大，同时搭配一套由准星驱动的交互式“火炬涂装”系统，并通过英灵神殿原生的零数据对象（ZDO）架构实现多人游戏中的颜色同步：

• 分层驱雾：四种风格各异的照明设备，从加固的大型火炬到巨大的矮人纪念碑，最多可清除 3.0× 将雾半径（覆盖面积9倍）大幅降低碎片密度与视觉杂乱。
• 交互式火炬绘制器瞄准任意已放置的火把或灯并按 P 立即用你选择的颜色为其光影和粒子效果上色，或者 左Shift + P 重置它。
• 放置时自动涂装：新放置的火把和灯具在建造的瞬间会自动继承你当前使用的染料颜色。
• 多人游戏与服务器同步直接印在每一块的 ZDO 创建时零不同步。未涂装部件可继承客户端选择的默认值或服务器强制配色主题，并具备守卫保护权限和管理员覆盖权限。
• 零资产包通过Jötunn在运行时从原生英灵神殿预制件中纯净克隆，确保即时加载和轻量安装。

---

功能

分层照明装置

1. 一级 — 大型鬼火火炬（低语火炬·治疗者·大):

   • 从原生木灵火把克隆并按物理比例缩放 1.25倍.
   • 驱散迷雾: 清除 1.5× 雾半径（9米半径，覆盖面积约2.25倍）。
   • 光: 1.33× 强度与 1.25× 范围。
   • 耐久度: 200 生命值 （双倍原生火炬）且不受天气腐蚀影响。
   • 制作：使用建筑锤自由放置（Wisp:8,YggdrasilWood:5,Sap:1）

2. 二级 — 小灯（微光灯足兽):

   • 游戏内名称： 矮人灵光提灯
   • 改造自原生矮人驱雾器道具，自然 1.0倍 比例。
   • 清除迷雾: 清除 2.0× 雾气半径（半径12米，覆盖面积4倍）。
   • 光: 1.5倍 强度和 1.5× 距离。
   • 耐久度: 250 生命值 且不受天气侵蚀。
   • 制作：需要 锻造 (Wisp:15,Copper:5,Iron:2,BlackMarble:2,Sap:2）。

3. 三级 — 大型台灯（低语灯大块):

   • 游戏内名称： 大矮人鬼火灯
   • 从大型矮人除雾器模型克隆并放大自 1.1倍.
   • 驱散迷雾清除 2.5× 雾半径（半径15米，覆盖面积约6.25倍）。
   • 光: 2.25× 强度和 1.75× 范围。
   • 耐久度: 500生命值 且不受天气侵蚀。
   • 制作： 需要一个 黑锻坊 (Wisp:22,Copper:8,Iron:3,Eitr:2,BlackMarble:5）。

4. 四级 — 华丽之灯（智慧灯碎片（追随者·大）):

   • 游戏内名称： 大矮人鬼火灯
   • 从大型矮人除雾器模型克隆并放大 1.5倍.
   • 清雾: 清除 3.0× 雾气半径（18米半径，覆盖面积9倍）。
   • 光：调谐 2.5× 强度和 2.0× 范围。
   • 耐久度巨型 750 生命值 且不受天气侵蚀影响。
   • 制作：需要一个 黑锻炉 (Wisp:30,Copper:10,Iron:4,Eitr:4,BlackMarble:10）。

交互式“火炬绘制”系统

• 选择颜色：选择您想要的画笔颜色（画师颜色) 使用游戏内配置管理器界面（F1）的颜色选择器或配置文件。
• 放置时自动涂装启用 放置时自动涂装 在配置中，用锤子放置新火把和灯笼时，自动涂上你当前使用的颜色。
• 在世界中绘制将准星对准附近任意灵火火把或灯，然后按下 P （可通过以下方式配置 油漆火把快捷键). 进入范围时会显示屏幕提示。
• 重置棋子瞄准涂色块并按 左Shift + P （可通过 重置火把快捷键) 以恢复默认颜色。
• 防护与安保未被允许的玩家无法在激活的守护区域内涂装部件，除非服务器策略允许（允许在受保护区域涂装) 或管理员状态 (管理员绕过守卫检查）。
• 多人游戏同步：绘制的颜色通过ZDO和持久化世界存储在所有客户端之间同步，无需外部资源包。
• 视觉迷雾边界启用 显示雾气抑制半径 在调试配置中投射一个实时地面环，显示所有鬼火碎片的当前驱雾半径。

---

配置

设置可以直接在游戏内使用BepInEx进行自定义 配置管理器 (F1) 或通过编辑 BepInEx/配置/dreamwraith.WispTorchHeeler.cfg:

章节	按键	类型	默认	描述
1 - 通用	启用模组（需要重启）	布尔值	真	主开关，用于启用或禁用此模组的功能。（需要重启）
1 - 通用	影响原生迷雾火炬	布尔值	真	允许在标准原生鬼火火炬上进行涂色和颜色默认设置。
2 - 大型火把	火炬_迷雾清除范围倍率	浮点数	1.5	大型火炬驱散迷雾力场半径倍率（1.0 - 10.0）。
2 - 大型火把	火炬光照强度倍数	浮动	1.33	大型火把光照发射强度倍率（0.5 - 5.0）。
2 - 大型火把	火炬光照范围倍率	浮点数	1.25	大型火把光照发射范围半径倍率（0.5 - 5.0）。
2 - 大型火把	火把耐久度	浮点	200.0	大型火把结构生命值（1.0 - 5000.0，双精度原生火把）。
2 - 大型火把	火炬制作台	字符串	""	所需站点格式为StationPrefab（例如piece_workbench、piece_forge，或 "" （用于自由锤放置）。
2 - 大型火炬	火把配方	字符串	Wisp:8,YggdrasilWood:5,Sap:1	制作配方字符串格式为物品预制体:数量,...，并根据对象数据库进行解析。
3 - 小台灯	小灯_迷雾清除范围倍率	浮点数	2.0	二级小灯驱雾半径倍率（1.0 - 10.0）。
3 - 小灯	小灯_光照强度倍数	浮空	1.5	二级小灯光照强度倍率（0.5 - 5.0）。
3 - 小灯	小灯_光照范围倍率	浮动	1.5	2级小灯光照发射范围半径倍率（0.5 - 5.0）。
3 - 小灯	小灯_生命值	浮动	250.0	二级小灯结构生命值（1.0 - 5000.0）。
3 - 小灯	小型灯制作台	字符串	锻造	所需的站点，格式为StationPrefab或Jotunn名称（默认为“forge”）。
3 - 小灯	小灯配方	字符串	Wisp:15,Copper:5,Iron:2,BlackMarble:2,Sap:2	制作配方字符串格式为物品预制体:数量,...，根据对象数据库解析。
4 - 大台灯	迷雾清除范围倍率	浮点数	2.5	三级灯具驱雾半径倍率（1.0 - 15.0）。
4 - 大台灯	大型灯具_光照强度倍率	浮动	2.25	3级灯光光照强度倍率（0.5 - 8.0）。
4 - 大台灯	大灯_光照范围倍率	浮动	1.75	三级灯光发射范围半径倍率（0.5 - 5.0）。
4 - 大台灯	大灯_生命值	浮点	500.0	三级灯具结构生命值（1.0 - 5000.0）。
4 - 大台灯	大型灯具制作台	字符串	黑铁铺	所需站点格式为StationPrefab或Jotunn名称（默认为'blackforge'）。
4 - 大型台灯	大灯具配方	字符串	Wisp:22,Copper:8,Iron:3,Eitr:2,BlackMarble:5	合成配方字符串格式为ItemPrefab:Amount,...，并根据ObjectDB进行解析。
5 - 宏伟之灯	大灯_雾气清除范围倍率	浮点数	3.0	4级大灯雾气清除半径倍率（1.0 - 15.0）。
5 - 华丽台灯	大灯_光照强度倍率	浮点数	2.5	四级大型灯光 emission 强度倍率（0.5 - 8.0）。
5 - 大台灯	大灯_光照范围倍率	浮点数	2.0	四级大型灯光发射范围半径倍率（0.5 - 8.0）。
5 - 华丽台灯	大灯_生命值	浮点数	750.0	4级大型灯具结构生命值（1.0 - 5000.0）。
5 - 大灯	大灯制作台	字符串	黑炉	所需工作站格式为StationPrefab或Jotunn名称（默认为“blackforge”）。
5 - 华丽灯盏	大灯配方	字符串	Wisp:30,Copper:10,Iron:4,Eitr:4,BlackMarble:10	合成配方字符串，格式为ItemPrefab:Amount,...，根据ObjectDB解析。
6 - 光照策略	强制使用服务器默认颜色	布尔值	假	如果为真，所有客户端必须使用服务器的默认颜色渲染未涂装的部件。
6 - 光照策略	服务器默认光照颜色	颜色	#B4F0FF	服务器范围内强制启用时未涂装部件的默认颜色。
6 - 光照策略	允许火把绘制	布尔值	真	服务器总开关，允许玩家为各个部件上色。
6 - 光照策略	允许在保护病房内绘画	布尔值	假	如果为假，玩家无法在无法访问的守卫区域内涂装部件。
6 - 光照策略	管理员绕过病房检查	布尔值	真	如果为真，已验证的服务器管理员在涂色时绕过领地限制。
6 - 光照策略	启用透明度自定义	布尔值	假	允许使用颜色选择器中的透明度滑块自定义光照和粒子透明度（限制在最低15%）。
7 - 客户端光照	默认光源颜色	颜色	#B4F0FF	客户个人默认颜色，用于未涂装部件（在服务器未强制时生效）。
8 - 火炬涂绘师	画师颜色	颜色	#FF8800	玩家通过UI颜色选择器抽屉选中的当前涂装颜色。
8 - 火炬绘制者	喷漆火把快捷键	键盘快捷键	P键	瞄准火把或灯时按下热键以应用画家颜色。
8 - 火炬绘师	重置火把快捷键	键盘快捷键	左Shift + P键	瞄准火把或灯时按下快捷键以清除自定义颜色。
8 - 火把绘制器	绘制射线检测距离	浮点数	10.0	瞄准并喷涂涂鸦的最大距离（米）（2.0 - 25.0）。
8 - 火炬绘制师	显示绘制反馈	布尔值	真	在涂色或重置时在屏幕上显示HUD文本确认。
8 - 火炬涂装师	放置时自动涂装	布尔值	假	若为真，新放置的火把和灯笼在放置时会自动涂上你当前使用的PainterColor。
9 - 调试	启用调试日志	布尔值	假	在BepInEx控制台中启用详细诊断日志记录。
9 - 调试	显示迷雾抑制半径	布尔值	假	在微光火把和灯具周围投射地面边界环，显示其活跃的雾气抑制半径。

---

兼容性

• 专用服务器与专用服务器和单人世界完全兼容。服务器同步的平衡与策略设置会通过以下方式在连接的客户端上强制执行： 条件配置同步.
• 香草微光火炬：与原生迷雾之地的鬼火火炬兼容（灵火把碎片当 影响原生迷雾火炬 已启用。
• 结界保护：与原生瓦尔海姆守护结界集成（私人区域) 以防止在受保护领地内进行未经授权的涂鸦。
• 零资源包：无需任何外部Unity资源或捆绑文件，杜绝捆绑包不同步与内存膨胀。
• 模组管理器完全兼容于 盖尔, 雷霆商店模组管理器，以及 r2modman.

---

安装

[!TIP] 推荐使用模组管理器： 使用现代模组管理器，例如 盖尔 或 雷霆商店 让安装和依赖自动更新变得轻而易举。

模组管理器（推荐）

1. 通过以下方式安装 大风, 雷霆商店模组管理器或 r2modman.
2. 启动英灵神殿，尽情享受吧！

手动安装

1. 确保 BepInExPack Valheim 和 约顿巨人（瓦尔海姆模组库） 已安装。
2. 下载并解压最新的发布压缩包。
3. 放置 精灵火炬行者.dll 进入你的 Valheim/BepInEx/plugins/ 目录。
4. 启动《英灵神殿》。

---

从源码构建

该项目使用可移植的MSBuild配置，可自动检测标准Steam路径。

dotnet build -c Release

编译后的程序集将放置在 bin/Release/net48/WispTorchHeeler.dll正在建造 释放 配置还会自动将分发包打包为 bin/Publish/WispTorchHeeler-<Version>.zip.

自定义与持续集成路径

对于非标准 Steam 库位置或模组管理器配置文件，请复制 WispTorchHeeler.csproj.user.example 到 WispTorchHeeler.csproj.user 在项目根目录（此文件已被git忽略，由MSBuild自动加载）：

<?xml version="1.0" encoding="utf-8"?> <Project> <PropertyGroup> <GamePath>D:\SteamLibrary\steamapps\common\Valheim</GamePath> <BepInExCorePath>$(UserProfile)\AppData\Roaming\com.kesomannen.gale\valheim\profiles\<ProfileName>\BepInEx\core</BepInExCorePath> </PropertyGroup> </Project>

---

许可

本项目依据GNU通用公共许可证v3.0授权——详见 许可证 详情请见文件。