英灵神殿执法者

轻量级模组同步与Valheim服务端角色进度系统。

一种即插即用、免维护的解决方案，专为只想玩游戏不想折腾配置的人设计。在服务器和客户端上安装后即可使用： 服务器加载的每个模组都会成为必需模组，以及 角色保存在服务器上 而不是从玩家自己的机器上获得信任。所有这些都是可配置的，并且始终由服务器决定。

完整文档 ——每一项功能、设置和指令均有详解。

安装

1. 安装到 服务器 并且在每个 客户端。双方都需要它；只有服务器的副本才能决定一切。
2. 启动服务器。

这就是全部设置。没有需要编写的模组列表——服务器会发布它加载的插件并要求所有人都安装。角色数据已经保存在服务器端。

需要BepInEx、Jotunn和YamlDotNet（任何模组管理器都会为你处理）。

已经有玩家了？ 自你安装此内容后首次加入的玩家尚无存档，将计为 新角色检查 新角色规则 第一。

是从 ServerCharacters 来的吗？ 导入你的存档 所以没人会失去任何东西。这两个模组无法同时运行。

功能

默认开启

模组强制 每个客户端在连接时都会根据本服务器允许的模组进行检查，若不匹配则会明确告知需要修复的内容。可选按模组划分的必需、可选、仅管理员和仅服务器列表；严格的版本锁定；SHA256文件校验，可捕获版本号未改但被重新编译的模组；BepInEx补丁程序的白名单；以及每次连接的验证机制，使模组报告无法被重放的预设答案伪造。 完整文档 →

角色成长 物品、技能和自定义数据都保存在服务器上。未记录的物品会被没收并保留，以便你可以归还给玩家；在别处提升的技能会被限制，且每一次削减都会被记录以便撤销；本地存档丢失的角色也能恢复进度。还可以选择保存被遗忘的力量、吃过的食物、地图、已知配方、已知文本、奖杯、统计数据和出生点；还可以选择给新角色发放初始装备，或将一个账号限制为一个角色。 新角色清除已知文本 (开启时) 会让首次加入的玩家忘记它在某个服务器上读到过、但本服务器从未见过的图鉴条目，而原版自身的配方重置对此并无影响； 已知文本直通前缀 (史诗MMO系统) 将已知文本键保留给所属模组，因此 EpicMMO 的等级、经验和属性点既不会被追踪，也不会被覆盖。 完整文档 →

作弊检测 — 对客户端进行检测，对照已知作弊工具目录，检查运行中的进程、注入游戏的 DLL、打开的窗口标题、加载到游戏中的托管程序集，以及旁落放置的 DLL 瓦尔海姆.exe。最后两项是注入式作弊菜单才会出现的情况，它不算模组，因此没有可供哈希的插件文件，声明的模组列表里也没有任何记录。游戏中任何已安装模组都无法解释的代码，无论它叫什么都会被上报；服务器会定期与每个客户端进行核查，所以已停止的扫描不会被当作干净的扫描；而已知作弊工具自身的标记会被服务器直接从世界数据中读取。记录、踢出或封禁；专门的游戏作弊加载器和菜单一经发现即封禁，并且 服务器 自行从本地目录和哈希列表中进行判断。进程列表、窗口标题和文件夹路径永远不会离开玩家的设备。 完整文档 →

玩家活动审计 ——一切之下的证据层。玩家携带了什么，得到了什么又失去了什么，从箱子、坟墓、船只和马车中取走了什么或放入了什么，以及对其造成的伤害的滚动汇总。磁盘上保留七天，可通过以下方式搜索 grep可下载到你的机器上。它只记录和报告——绝不会踢人、封禁或没收。 完整文档 →

关闭，直到你打开它们

结构校验 能捕捉到客户端生成世界生成几何体（地下城房间、矮人城镇、废墟）而非建造的情况，以及生命值被设置为超出预制体允许范围的结构件，这就是制造不可破坏结构的方式。蓝图和批量建造模组在设计上不会触发此检测。 执法者建筑扫描 发现你世界中已有的事物。 完整文档 →

网络完整性 守卫原版 RPC，否则服务器会不加检查地直接转发。将聊天消息绑定到服务器持有的名称，拒绝非管理员的玩家传送消息，将批量对象删除过滤为发送者拥有的对象，丢弃不可能的伤害值，并可选地重新判定 PvP 并限制全局按键。 这些读取的数据包是服务器已经持有的，所以客户端没有什么可以谎报的。 完整文档 →

物品来源 — 报告出现了无制造者、且此世界没有任何掉落、出售或生成来源的装备，以及由此地无人见过的玩家ID制造的装备。仅检查刚出现的物品，因此现有角色不会被重新审查。仅警告，从不没收。 完整文档 →

保存归档 — 滚动压缩存档，保存世界进度 和 角色从同一时刻开始保存。游戏自带的备份只保留两份未压缩的世界副本，而且不包含你的玩家角色。历史记录、大小上限和目标位置均可配置。 完整文档 →

紧急崩溃恢复 ——每位玩家持有一份自己角色的密封签名快照，只有服务器才能打开。非正常关闭后，服务器会要求玩家交回这些快照，并采用那些验证通过且更新的快照。窗口期很短，每次恢复都会记录在案，并且会如实说明这可能导致物品复制的问题。 完整文档 →

Discord 通知 — 加入、离开、启动、关闭、存档、作弊封禁和拒绝连接。每个类别都可以发布到各自的频道，每条消息都是可重写的模板，包含角色提及。粘贴 Webhook URL 即可开始发布，无需其他配置。 完整文档 →

控制台命令

在服务器控制台或已连接管理员的客户端中运行它们——专用服务器完全在游戏内进行管理。输入 执法者帮助 或用于列表， 执法者帮助物品 对于单个区域。Tab 补全可以作用于第一个参数之后，遍历服务器实际拥有的账号 ID，然后是这些账号下的角色。

除以下内容外的所有内容 执行者帮助 和 执法者身份查询 需要服务器上的管理员权限，服务器会自行核查——声称自己是管理员的客户端会被拒绝并收到相应通知。

故障排查：你的管理员不再是管理员了

一个英灵神殿的更新改变了拼写 管理员列表.txt 需要，而它现在是 仅 拼写已接受，该账户的ID为数字：

光秃秃的 76561198…，或更早的 Steam_76561198…不再有效。 游戏对此没有任何提示 ——文件看起来和往常一样完全正确，但服务器上的每个管理员都不再是管理员了。如果更新后管理员命令失效，而你什么都没改，原因就在这里。

奔跑 执法者身份识别 它会准确打印出需要为你的账户写入的那一行。无论你是不是管理员，从控制台或从聊天中都可以使用，方式如下 执行者身份查询，只有服务器才有决定权——因此它报告的是真正起决定作用的 ID，而非你客户端所认为的 ID。它还能捕捉另外两种情况：文件中完全不存在的 ID，以及带有杂散空白或字节顺序标记的行，Valheim 不会修剪这些空白，一个尾随空格就会让你失去管理员权限。

管理员列表.txt 在保存后大约十秒内被重新读取，因此无需重启服务器即可测试修复。

更多管理相关内容 →

这个模组能做什么和不能做什么

《英灵神殿》采用客户端权威机制，这里的检测分为两类，其失败方式截然不同。检测 询问客户端自身信息 ——它运行哪些模组、库存里有什么、那台机器上在运行什么——都可以被一个已经能作弊的客户端撒谎；它们改变的是成本，从“编辑一个文件并重新构建”到“逆向工程并修补执行器”。检查 服务器自用 每条消息的发送者都根据其到达时的连接进行验证，加入规则在服务端重新执行，网络防护读取服务器已持有的数据包——客户端没有任何可以撒谎的余地。

两者的完整声明均载于 文档.

路线图

尚未实现，但已有计划：

• 为缺少模组或版本错误的客户端自动提供模组建议和下载链接
• 基于平台ID的“管理员”模组列表，这样服务器所有者就可以将模组权限授予特定玩家，而无需将其设为管理员

有bug要反馈，还是只想聊聊这个模组？欢迎来 Discord 或 GitHub.