友好的巨魔同伴，手持棍棒，保存姓名与进度，共享击杀，战斗命令，以及带独立召回功能的F6属性面板。实时服务器配置。服务器和客户端均需安装。开发版本。

巨魔伙伴 0.2.10

用巨魔杖召唤友好的巨魔，保留它们的名字和进度，并向它们下达战斗命令。你的同伴总是携带一根木棒。野生巨魔保持不变。

开发版： 0.2.10加入了英文模组文本、带独立回召的F6统计面板、共享击杀进度和实时服务器配置。同时将两个默认基础战斗倍率改为2。自动化检查已覆盖新规则和迁移；完整的游戏内单人、合作和专用服务器验证仍在进行中。

安装

安装 服务器/主机和每个客户端上使用相同版本的TrollCompanion仅客户端安装不足以进行多人游戏。

依赖：

• BepInExPack Valheim 5.4.2351。
• 约顿 2.30.2。

这些是用于本地兼容性检查的依赖版本。

1. 在替换插件文件之前，请先停止 Valheim 和服务器。
2. 通过Thunderstore模组管理器安装，或使用其本地模组导入功能进行安装 巨魔同伴-0.2.10.zip 到测试配置文件中。
3. 手动安装服务器时，请将 plugins/TrollCompanion.dll 进入 BepInEx/plugins/TrollCompanion只保留一个副本。在将该安装切换到管理器之前，请移除任何先前手动安装的 DLL/PDB。
4. 启动服务器和客户端并启用模组。检查两者的日志以查看 加载中 [TrollCompanion 0.2.10] 和 巨魔伙伴已加载.

保留您现有的配置和同伴数据。升级到0.2.10的第一个更新将执行下述配置迁移。

控制和同伴面板

输入	动作	需要员工吗？
F6	打开或关闭同伴面板	否
鼠标左键	召唤一名可用的伙伴	是
鼠标中键	召回所有当前同伴	是
地面上的J	前进，沿途作战，然后坚守阵地	是
J对敌对生物	集中火力攻击那个敌人，然后坚守阵地	是
H	结束当前指令并重新跟随	是
鼠标右键	原生屏蔽	是

按键绑定可在本地配置。菜单和文本输入会屏蔽命令快捷键。在检查的原生默认设置中，F6未绑定；其他模组或自定义按键绑定仍可能冲突。G键仍可用于游戏的径向菜单。

该面板显示每个已拥有伙伴的名称、槽位、变体、命令/状态、当前生命值和最大生命值、星级、击杀数、下一星级阈值、死亡冷却时间以及棍棒攻击数值。每个符合条件的出战伙伴都有各自的召回控制。服务器在召回前会检查归属权和当前实例；过期的面板行无法选中较新的召唤物。

面板区分实时网络数值、最后已知网络数值与已储存/下次召唤数值。俱乐部攻击数值是在目标护甲、抗性及其他情境效果之前计算的，并非每秒伤害。

J和H控制所有活动同伴。新的J指令会替换旧指令。攻击移动、聚焦和驻留会暂停自动追赶主人，包括传送门穿越。H恢复正常跟随和追赶。无法到达的指令会停留在当前位置，而不是传送到目的地。

名称与阵容

对已拥有的同伴使用游戏自带的命名对话框。其原生的十个UTF-16字符限制和内容过滤仍然有效。清除名称将恢复默认标签。额外的星级标记与保存的名称保持分离。

名字、身份、成长与生命值在召回和重新召唤后均会保留。名字与成长在同伴死亡、世界重启、变体变更及槽位暂时锁定后也会保留。早期版本已丢失的名字无法恢复；请为那些同伴重新命名一次。

默认设置

设置	默认
同伴变体	灰烬之地；森林为可选区域
血魔法0/50/100时激活上限	2 / 3 / 4
星级门槛	一星需累计击杀25次；两星需75次
最高星级	2；可配置
共享击杀进度	在击败敌人后25米范围内生效
血魔法经验系数	每击杀一个符合条件的敌人获得0.25；设为0则禁用
死亡冷却	在血魔法0时为30秒，在100时降至5秒
原生埃特尔/生命值消耗倍率	1 / 1
目标范围／作战半径	80米 / 25米
跟随追赶距离	100米
技术故障退款	已启用

两种变体均使用森林巨魔经检验的600点基础生命值和棍棒攻击属性。基础生命值和伤害倍率为2时：

星星	最大生命值	俱乐部伤害系数	首领系数（原生抗性前）
0	1200	×2	×1
1	2400	×3	×1.5
2	3600	×4	×2

抗性穿透默认为0.75，适用于对敌对非首领生物的普通身体命中。它会恢复因抗性而被削减的75%伤害：50%的原始伤害变为87.5%，25%的原始伤害变为81.25%。免疫、弱点、被忽略的伤害以及明确的弱点部位仍保持原始行为。首领不会获得抗性补偿，并且拥有独立的0.5战斗伤害倍率。通用伤害、劈砍伤害和镐击伤害不适用于这些针对特定目标的规则。

召回免费，不产生掉落物并保留剩余生命值。存储的同伴不会随时间恢复生命值。死亡的同伴会保留身份与进度，等待至其保存的期限，然后以满生命值回归。该期限在离线期间也会推进，且不会因之后的技能或配置修改而改变。实际死亡掉落可单独配置，默认禁用。玩家、驯服生物、建筑与环境伤害保护默认启用。斧头不包含在内。

共享击杀进度

击杀者每次击杀符合条件的敌对生物时都会获得一次击杀数，包括首领。启用共享后，同一主人的其他存活且激活的同伴若在受害者25米范围内，也会获得一次击杀数。被召回、已死亡、正在召回、距离过远以及其他玩家的同伴不计入其中。范围可配置，共享功能可以禁用。

每个受害者事件仅为所有接收者保存一次。血魔法经验值会给予 每次击杀一次，无论有多少同伴共享进度。玩家、驯服的动物和同伴不符合受害条件。

英语配置与实时更改

文件为 BepInEx/config/de.steve.valheim.trollcompanion.cfg.

在首次0.2.10迁移时，已识别的德语键会变为英语，并且先前的文件会保存在其旁边，文件名为 .pre-0.2.10.<timestamp>.<id>.bak其他已保存的设置将保留。 基础生命值和伤害倍率均一次性设为2。 后续对这些值的更改将被保留。保留 [配置] MigrationVersion = 1；移除标记会再次请求迁移。无效值会阻止迁移，而不会替换原始文件。

[战斗] 基础生命倍率 = 2 基础伤害倍率 = 2 每星生命 = 1 每星伤害 = 0.5 抗性穿透 = 0.75 首领伤害倍率 = 0.5 [进度] 共享击杀进度 = 是 共享击杀范围 = 25 [输入] 同伴面板 = F6

在游戏过程中保存对服务器/主机配置的更改。文件保持不变约一秒后，一份完整且经过验证的规则快照便会同步。无效的编辑会保留上一次已接受的规则并生成诊断信息。服务器游戏设置具有权威性；按键绑定、显示选项和详细战斗日志保留在本地。

生命值平衡性调整会以旧星级时的生命值百分比保留现有生命值。星级变化则保留绝对生命值，并以新上限为准。获得星级或重复更新不会治疗。变体变化会在下次召唤时生效；现有的死亡期限保持不变。

放置与召唤失败

放置检查在施法前进行一次，在同伴出现前再次进行。施法前可在被阻挡目标3米范围内选择一个空旷位置；该位置在动画播放期间保持不变。水面、不合适的斜坡或空间不足会产生特定的失败提示。

该模组使用原生巨魔杖到达和冲击效果的副本，并禁用了冲击/地形伤害。召回或玩家死亡会取消到达效果。

召唤失败返还消耗=true 在确认发生技术故障时，退还实际支付的埃特尔和生命值，仅限一次且不超过本地资源上限。在发送请求之前，已知的本地故障可在本地处理；之后则必须由服务器确认。死亡、召回、传送门、断线和离开范围不予退还。仅超时不会给予资源。退还无法复活玩家或转移至重生角色。

数据和更新

服务器/主机会按角色和世界存储同伴，路径如下：

BepInEx/config/TrollCompanion/worlds

用你的服务器备份此目录。更新时请勿删除。该模组不会修改游戏或角色存档。无法恢复的模组存储错误会阻止新的召唤，而不是覆盖进度。

方案 3 在现有 HP 的基础上新增了生命值上限、已应用平衡、星级数量和状态修订。现有的方案 1/2 数据会在下次成功保存时升级。名称、ID、击杀数和截止时间保持不变。 如果较早的存档记录没有可信的先前最大值，则保留绝对生命值，并以新的最大值为上限。 模组不会猜测生命值百分比。旧版本无法识别架构3；降级前请保留备份。

同时更新服务器/主机和每个客户端，只保留一份插件副本，替换 DLL 后重启。特定版本的确定性包时间戳允许 BepInEx 刷新缓存的插件元数据。如果同步失败，请收集 BepInEx/LogOutput.log 从服务器和客户端两侧。

作为首次测试，在没有法杖的情况下打开F6，查看两个名字不同的同伴，并且只召回其中一个。然后比较附近的共享击杀、远处的非共享击杀、实时配置更改以及重启。这些步骤是需要执行的验收测试，并不代表已在游戏内完成验证。

更新日志

参见 Thunderstore 的更新日志标签页或随附的 更新日志.md。更新日志需手动维护；Thunderstore 不会根据源代码自动生成。