可配置的仅生命值血魔法与施法者归属破盾经验。当前生命值消耗随技能等级缩放。可选服务器安装；已记录混合客户端经验限制。

血魔法伙伴

一个瓦尔海姆模组中的两项可配置血魔法改动：

• 仅生命值施法： 用额外的当前生命值消耗替代凝胶，消耗量随血魔法技能缩放，且不添加低生命值施法障碍。
• 施法者护盾经验值： 当处理破盾的计算机与施法者均支持该功能时，将保护法杖的破盾经验计入施法者。

两个功能默认启用，可以独立关闭。包含一个DLL文件和一个配置文件。

状态： 实验性首次整合发布版。基于 Valheim 1.0.16 和 BepInExPack 5.4.2350 编译。离线算术、路由和静态检查均已通过。Unity 加载、游戏内行为及多人模式尚未进行游玩测试。平衡性默认值仅为起始参考，不代表与原版法力食物取舍等价。

安装与升级

使用r2modman或Thunderstore Mod Manager，并搭配BepInExPack_Valheim 5.4.2350或更新版本。对于未发布的本地ZIP，请选择 设置 → 个人资料 → 导入本地模组，选择 血魔法同伴-1.0.0.zip，并以 开始模组模式. 手动安装时，请将 血魔法同伴.dll 在个人资料或游戏内 BepInEx/plugins 目录。

在启用此模组之前，请移除或禁用两个独立的前置模组： BloodMagicCasterXP 和 BloodMagicHealthCost。它们已被此单一插件取代。BepInEx 将拒绝在加载这些旧插件 ID 的同时加载合并插件，以防止重复补丁。更改后请重启。

首次启动后，编辑 BepInEx/config/local.valheim.bloodmagiccompanion.cfg 通过模组管理器的配置编辑器进行修改。重启以应用玩法设置。旧的独立配置文件将保持不变，不会自动导入；请将任何自定义值复制到下方描述的新设置中。没有存档迁移。

仅消耗生命值

默认情况下，每一点 基础埃特尔 成为 当前生命的0.5%将原始生命值消耗相加，然后通过血魔法技能对总额进行减免：技能0级时减免0%，技能50级时减免16.5%，技能100级时减免33%。减免仅应用一次。

基础值 = 固定生命值消耗 + 当前生命值 × 原始生命值百分比 / 100 额外值 = 当前生命值 × 基础能量消耗 × 转化百分比 / 100 消耗 = (基础值 × 现有生命值倍率 + 额外值) × 物品倍率 × (1 − 技能减免 × 技能等级 / 100) 支付 = min(消耗, max(0, 当前生命值 − 1))

两个百分比部分都使用 当前生命值，而绝非最大生命值。原本固定的生命值消耗在乘数和折扣计算前保持不变。技能等级被限制在0到100级之间。

对于一个消耗40%生命和60点基础埃特尔的法术，在技能等级0时，总消耗变为当前生命的70%。在200生命值时是140；在20生命值时是14。在技能等级100时，这些消耗分别是93.8和9.38。这是一个示例计算；每次攻击使用其实际配置的消耗字段。

有 无额外生命值资格检查付款上限为保留1点生命值，包括超过100%的费用。当生命值为1时，生命值支付为零。这有意允许低生命值紧急施法。正常材料、弹药、耐久度及其他非eitr条件仍然适用。施法后受到的伤害仍可致死。

新增的提示框区域会显示基于你当前生命值和技能水平的应付总额。其上方的原版生命值行描述的是基础费用。实际费用会在正常支付时重新计算，包括每次连发攻击的每一段爆发。

适用于所属本地玩家的攻击，这些攻击所用物品使用血魔法且基础以太消耗为正。主攻击和副攻击使用各自字段。明确自杀的攻击和已为零以太消耗的攻击保持不变。元素魔法、近战和生物攻击保持不变。

施法者护盾经验与多人模式

造成伤害时获得经验值 破坏 一个保护之杖的护盾，不是在施法时、每次命中时或正常到期时。原始的XP系数和原版技能奖励调用得以保留。刷新的护盾归属于其最新追踪的施法者。骷髅攻击XP、护盾强度、持续时间以及哪些目标可以接受护盾均保持不变。

服务器和其他玩家可能未安装模组。 这并不意味着所有远程护盾都能被一个改装客户端修正。

情况	结果
只有你安装了该模组	你自己的仅治疗施法生效。
你保护了自己	你的破盾经验仍归你所有。
你为一个当前由你模组客户端模拟的骷髅提供护盾	破盾经验可以归你。
你保护了一位未安装模组的朋友	他们的客户端使用原版经验规则；此模组无法重定向该奖励。
你保护了一个由未加模组计算机模拟的骷髅	那台电脑使用的是原版XP规则。
施法者和计算机处理中断均能启用兼容的施法者经验值	破盾奖励归于施法者。
施法者未安装模组、经验值已禁用，或存在不兼容	模组接收者使用原版奖励回退。
专用服务器保持无模组状态	支持的设计；定向经验消息使用普通的Valheim转发。
专用服务器运行此模组时启用了施法者经验值	可选；它可以报告实际处理的休息时间。

模拟生物的计算机可能会改变；召唤它并不保证你的客户端始终控制它。模组服务器无法修复由无模组客户端处理的故障。

经验值协议有意匹配 血魔法施法者经验 1.2.0使用独立版本的朋友可以与此整合模组交换经验值消息，不过这一互通性尚未经过实际测试。请勿在同一客户端上同时安装两者。独立版1.0/1.1或未知协议将使用原版回退方案。

仅当施法者经验启用时才会宣告能力。不会添加强制模组网络握手、强制版本匹配或模组版本踢出。定向远程奖励需要已知的当前归属；断线、重生、归属转移或网络数据缺失可能导致奖励丢失。没有离线队列或投递重试。回执具有有限的重复保护；这是一个合作模组，不是反作弊系统。其他替换护盾、消耗或网络方法的模组可能会产生干扰。

配置

文件： 瓦尔海姆血魔法伙伴配置游戏设置将在启动时生效。

章节／设置	默认	用途
生命值消耗 / 已启用	真	启用仅生命值施法。禁用后使用原版消耗，同时保留经验值功能。
施法者经验/已启用	真	启用施法者归属的护盾经验。独立于生命值消耗而禁用。
生命消耗 / 每点以当前生命百分比表示的埃特尔	0.5	每点基础埃特尔的当前生命值百分比；范围 0.01–10。
生命值消耗 / 现有生命值消耗倍率	1	原始生命值部分的倍率；范围0.01–10。
技能100级时的生命消耗/消耗降低	0.33	技能100时的折扣比例；范围0–0.9。
生命值消耗 / 物品消耗倍率	工作人员护盾=1；工作人员骷髅=1；工作人员巨魔=1	整个成本的分号分隔预制件名称乘数；每个乘数范围0.01–100。未列出的项目使用1。
生命消耗 / 在提示中显示消耗	真	显示应付总额。
日志 / 诊断	假	记录护盾归属和经验值发放，以便进行故障排查。

示例： 员工护盾=1.2;员工骷髅=1 使总护盾消耗提高20%。转换率0.35较为温和；0.75则更为严苛。高额消耗仍适用保留一点生命值的上限。请使用小数点。无效设置将回退至默认值，或忽略无效条目并发出警告。

迁移时，将旧生命值模组的平衡数值复制到生命值消耗中，将其通用/启用状态复制到生命值消耗/启用中，并将其提示框开关复制到生命值消耗/在提示框中显示消耗中。如有需要，可复制经验模组的日志/诊断设置。BloodMagicHealthCost 1.0.0 中已过时的最大生命值转换和最小生命值保留设置没有对应项，将被忽略。所有配置均为本地配置，不会对好友强制执行。

故障排除与卸载

请检查 BepInEx/LogOutput.log 以获取 血魔法同伴 1.0.0 已加载 以及两个功能状态。如果加载被拒绝，请移除旧的独立插件并重新启动。如果补丁安装失败，组合模组会移除其补丁，而不是留下部分启用的功能。

提交 bug 前，请报告游戏和模组版本、相关配置、其他改变战斗的模组，以及是哪台电脑在处理破盾。只分享相关日志摘录，并移除个人信息。源项目包含问题模板和手动多人测试计划。

要移除该模组，请禁用或卸载后重启。配置可能会保留。已获得的经验值仍计入普通角色进度。无需在服务器端统一卸载。

来源与验证

适用于 GitHub 的源码归档包含所有 C# 源代码、MIT 许可证、构建脚本、独立测试、静态游戏合约验证器，以及一个无需游戏文件即可运行测试的 GitHub Actions 工作流。游戏程序集和加载器库不再分发。本源码及此版本均在 AI 协助下开发。

此合并版本通过了250项可执行断言（216项费用断言和34项经验值/归属/路由断言）以及81项静态断言（52项费用契约、20项经验值契约和9项集成检查）。这些均为离线检查，不能证明游戏内或多人模式下的实际行为。详情请参阅随附的VALIDATION.md，游玩测试计划请参阅源项目的docs/TESTING.md。