在启动时通过在内存中修复过时的游戏API调用，使BeastTribes（2025.11.1和1.2.0）能够在Valheim 1.0.12+上加载并运行。BeastTribes.dll不会被修改。

野兽部落兼容补丁

使 兽族 再次工作 英灵神殿 1.0.12 及更高版本把它安装在BeastTribes旁边就完成了。里面没有任何 兽族.dll 已修改。

可与野兽部落配合使用 2025.11.1 (野兽部落-原作.dll、Thunderstore 和 Nexus 版本）以及 1.2.0 (兽族.dll）。物种菜单和身体交换功能在两者上均可使用。2025.11.1 版本的模型自带尾巴和耳朵物理效果；1.2.0 版本的模型则没有，所以兼容层可以为其添加该效果——请参阅下方的“可选：尾巴和耳朵物理效果”。

它解决的问题

《英灵神殿》1.0.12 为 BeastTribes 调用的两个游戏方法新增了可选参数。BeastTribes 在此之前就已编译完成，因此它的三个方法现在会抛出异常 缺少方法异常 第一次运行时。其中一个会在你的角色加载时运行，这就是为什么安装了BeastTribes后游戏会一直卡在加载界面。你的日志显示：

MissingMethodException: 未找到方法: void .MessageHud.ShowMessage(MessageHud/MessageType,string,int,UnityEngine.Sprite,bool)

安装

模组管理器（推荐）： 像安装其他任何软件包一样安装这个包。它会放进自己的文件夹里，位于 BepInEx/plugins.

手动： 复制 BTShim.dll 进入 BepInEx/plugins/BeastTribes_CompatShim/.

野兽部落与霜巨人必须按常规安装。加载顺序会自动处理。

检查是否成功

BepInEx/LogOutput.log 应包含类似这样的行：

[信息：BeastTribes 兼容补丁] BeastTribes_Originals 2025.11.1 (BeastTribes-Originals.dll)：3 个损坏方法，3 个过期调用已重写，3 个调用点已重定向，0 个 Harmony 补丁已重新注册。

如果它写着 所有游戏方法引用均可解析；无需修复，你的 BeastTribes 版本没有这个问题，而兼容层也不起作用。

工作原理（简版）

这三种方法无法用常规方式打补丁：Harmony需要先编译原始方法，而编译本身就正是失败的原因。因此，在启动时，垫片程序会用Mono.Cecil读取BeastTribes程序集，找到所有调用了已不存在的游戏方法的方法，将那个方法自身的代码复制一份并把调用修正为新的重载，在内存中编译这份副本，然后把调用方重定向到它。没有重新实现任何BeastTribes的代码，也没有向磁盘写入任何内容。

由于没有任何内容被硬编码到BeastTribes的方法名中，一个DLL即可同时覆盖两个BeastTribes版本，并且也能应对未来游戏补丁中同类改动。

同时修复：使用动画模组时的A姿势闪烁问题（BeastTribes 1.2.0）

如果你的角色在 BeastTribes 1.2.0 和某个添加玩家动画的模组（例如 Better Archery 2.0）同时使用时，每秒多次突然变成 A 姿势，那是两个模组在争夺动画控制器。这个兼容补丁会阻止 BeastTribes 1.2.0 用它自己的默认控制器替换另一个模组的控制器。该功能自动生效，无需配置，并且对没有使用此类模组的玩家没有任何影响。

龙的 飞行 动画是兽族必须取胜的一个环节。随着 更好的弓箭 这个垫片也处理了这个问题：当飞行控制器处于激活状态时，它的蹲下-拉弓覆盖层会被抑制，所以飞行中的龙也不会闪烁。 已知限制： 其他覆盖动画的模组目前尚未涵盖飞行状态；飞行的龙在它们旁边仍可能闪烁。

同时修复了死亡后以及多人游戏中的野兽菜单

BeastTribes 将它的菜单（B）绑定到了最后出现的那个玩家对象上。在多人游戏中，那可能是另一名玩家，所以点击物种没有任何反应；而一旦那名玩家，或者你自己已死亡的角色被销毁，菜单就会打开在一个已失效的控制器上：所有按钮都不起作用，菜单也无法关闭，你的输入会一直被阻断，直到你重新登录。这个兼容层让菜单保持绑定到 你的 角色，在你死亡时忽略热键，清理因死亡而残留的菜单，并停止 空引用异常 在重生界面记录到大量BeastTribes日志。

同时修复：登录和重生时物种丢失的问题

在野兽菜单中选定的种族从未写入你的存档，因此每次进入世界（或死亡后重生）时你都会再次变成维京人，必须重新选择一次，尽管角色选择界面显示的是正确的野兽。该修正程序现在会在你生成后立即重新装备已记住的种族。在野兽菜单中选择“无”即可保持人类形态。

还修复了：使用相机模组时相机缩放闪烁的问题

如果你变成野兽的瞬间镜头就失控了，在正常视角和一团模糊、极度拉近的地面特写之间闪烁（通常是满屏绿糊糊的一片），但游戏暂停时或作为维京人时却一切正常，那就是BeastTribes在把摄像机的视场角强制拉回它曾经记住的某个值，与某个摄像机模组冲突了，比如 可自定义相机。该垫片使 BeastTribes 的记忆值与实时摄像机保持同步，因此当你行走时，摄像机模组仍能控制缩放，而当狐狸或龙飞行时，BeastTribes 自带的飞行缩放也依然有效。安装 Customizable Camera 后，该垫片还会在飞行期间暂缓其摄像机更新，以免两者在空中相互冲突。自动生效；未安装摄像机模组的玩家不会受到任何影响。

同时修复：野兽菜单按钮显示代码而非名称

如果野兽菜单显示了诸如 狐族名称 或 野兽菜单基础色 而不是“Fox”和“Base color”，那是较新版本 Jötunn 中的改动，而 BeastTribes 并非针对该版本编写。这个兼容补丁会恢复正确的文本，并采用 BeastTribes 随附的语言（英语、德语、俄语、西班牙语）。

同时修复：颜色未能覆盖野兽的每个部位（BeastTribes 1.2）

四个颜色区域现在也会为龙的翼膜上色（此前仅翼臂会改变），以及雌性猞猁的身体，后者此前完全忽略了所选颜色。可选：雌性龙的身体从未被BeastTribes设为可上色；设置 女龙材质颜色兼容 到 Dragon01_Material=Dragon_Male_Main,Dragon02_Material=Dragon_Male_Main 在配置中给她雄性龙的可着色皮肤，这样区域也会应用到她的身上。

可选：兽族部落1.2的尾巴和耳朵物理效果

1.2版本的模型没有尾巴或耳朵的物理效果，所以尾巴是僵硬下垂的。补丁可以附加与BeastTribes 2025.11.1相同的物理效果，使用BeastTribes 1.2中已有的物理脚本，并采用2025版模型的调校参数。它是 默认关闭打开游戏内设置菜单（使用配置管理器时按 F1），找到此模组并勾选 已启用 在“TailPhysics”下。它会立即生效，切换物种时也一样。移动时尾巴会摆动并拖后，耳朵会随头部抽动，站立不动时则保持姿势。每个数值都是实时滑块，尾巴和耳朵分别独立，包括根部相对尖端有多硬。纯视觉效果且仅在本地生效；对2025.11.1版本的玩家没有任何变化。自0.4.1起，龙尾在站立不动时不再从根部向侧边弯曲。龙收起的翅膀也得到同样处理：在地面移动时它们会滞后并随动作安定下来，飞行时则回到普通的扇动动画（翅膀链, 当TailPhysics启用时始终开启； 飞行中的翅膀 保持它们在空中的活跃状态）。

配置

BepInEx/config/community.beasttribes.compatshim.cfg

设置	默认	含义
目标插件GUID	两个已知的BeastTribes GUID	用于扫描和修复的插件。如果未来的BeastTribes更改了其GUID，请添加一个GUID。
详细日志	假	记录每条重写指令。报告问题时开启。
动画器兼容。已启用	真	上面的A姿势闪烁修复。排查问题时只有关闭它才能排除其影响。
菜单目标修复.已启用	真	上方修复野兽菜单。关闭 = BeastTribes 的原始行为。
复活恢复.已启用	真	重生后重新装备你的种族，当兽族未执行此操作时。关闭 = 兽族的原始行为。
相机兼容。已启用	真	上方为相机缩放修复。仅在排查问题时关闭以排除该因素。
启用菜单文本修正	真	野兽菜单中显示正确的文本而非代码。关闭 = BeastTribes 的原始行为。
颜色兼容.已启用	真	色彩区域覆盖所有可着色部分（龙翼膜、雌性猞猁）。仅限BeastTribes 1.2。
女性龙族材质	空	将雄龙的可染色皮肤（见上文）给予雌龙。留空 = 关闭。
启用尾部物理	假	BeastTribes 1.2 的尾巴和耳朵物理效果（见上文）。在 2025.11.1 上被忽略。两条链的滑块都在同一个菜单里。

故障排除

• 未找到目标插件 — BeastTribes 未安装或加载失败，或者它使用的 GUID 不在 目标插件GUID.
• ……无法修复（见上方错误） — 一个损坏的调用没有兼容的替代项。请报告以下错误行： 详细日志 = true.
• 野兽菜单打开后按钮全部失灵/无法关闭 ——从0.3.0版本起，垫片会阻止这种情况（请留意 菜单目标修正：已激活 在日志中）。已经卡住的菜单会在下次重生或重新登录时消失。
• 镜头闪烁／野兽视角极度拉近特写，暂停时正常 — 自 0.4.1 起已修复（查找 相机兼容性：已启用 在日志中）。如果仍然出现，请告诉我们你使用的是哪个相机或FOV模组。

笔记

这个模组不包含 BeastTribes 的代码。它只是从你机器上已安装的 BeastTribes 程序集中复制了三个方法体，修正了两条指令，然后将结果保留在内存中。