Valheim的客户端HUD便利性模组，用于重新定位或屏蔽屏幕中央侵入性的世界保存倒计时警告和通知。

世界存档静音器

一个独立的、100%客户端侧的《英灵神殿》体验优化模组，专门给那些烦人的、霸屏的世界存档提示戴上嘴套，让它们终于闭嘴，不再在你拼命战斗时横穿准星尖叫。

【注意】 仅客户端： 该模组已安装在你的电脑本地。它 不 需要安装在服务器上，并且在单人游戏或连接任何专用服务器或社区服务器时均可使用。

[!重要] 英灵神殿社区补丁附加说明： 此代码已合并至 英灵神殿社区补丁附加内容 版本结束 0.28.0，但为那些不想安装VCP Extra模组的玩家单独发布。

如果瓦尔海姆社区补丁扩展（版本高于 0.28.0如果安装了)，WorldSaveMuzzler将自动检测并安全地自行禁用，以防止重复处理。

---

问题

在原版英灵神殿中， 游戏.更新存档中 广播一条30秒自动保存警告（$msg_worldsavewarning 30秒) 以及一个保存完成提示 ($msg_worldsaved) 使用 MessageHud.MessageType.Center.

这个巨大的、充满屏幕的黄色横幅会直接横跨在你的准星和战斗视野上。此外，许多专用服务器和管理脚本会通过屏幕中央的提示向所有玩家广播自定义倒计时。

在激烈战斗、首领遭遇、海上航行或精密的脚手架建造过程中，屏幕中央突然被自动保存横幅遮挡，很容易导致格挡时机失误、迷失方向、意外坠落甚至死亡。

解决方案

世界存档静音器 拦截 显示消息 并提供干净、可自定义的显示选项：

• 移至左上角（默认）将世界存档倒计时警告和存档提示移至左上角不易察觉的通知栏。你可以在不遮挡准星或视野的情况下随时了解即将到来的存档。
• 静音完全静默屏幕中央的世界保存通知，带来不被打断的沉浸式体验。
• 原生：将通知保持居中显示在屏幕上方，不做改动。

---

配置

设置可以直接在游戏内使用BepInEx进行自定义 配置管理器 （F1 / F5，视配置而定）或通过编辑 BepInEx/config/dreamwraith.WorldSaveMuzzler.cfg:

区域	按键	类型	默认	描述
1 - 通用	世界保存提示模式	枚举	移至左上角	显示模式： 移至左上角 （左上角轻微提示）， 静音 （完全隐藏），或 原生 （居中黄色横幅）。

---

兼容性

• 英灵神殿社区补丁扩展这段代码已合并至 英灵神殿社区补丁扩展 版本结束 0.28.0，但为那些不想安装VCP Extra模组的玩家单独发布。如果VCP Extras（版本 > 0.28.0存在时，WorldSaveMuzzler 会自动自我禁用，以防止重复或冲突的通知处理。
• 100% 客户端：可在任何服务器上安全使用。服务器无需安装此模组。
• 智能检测：识别原生英灵神殿本地化键（$msg_worldsavewarning, 世界已保存以及来自常见服务器脚本的纯英文倒计时广播（例如， 30秒后保存世界）。
• 无头安全在无头服务器上无效，其中 信息提示界面 未渲染。

---

安装

【！提示】 仅客户端在你的本地电脑上通过你喜欢的模组管理器（Gale / r2modman / Thunderstore）或手动安装。服务器端无需安装任何内容。

模组管理器（推荐）

1. 通过以下方式安装 盖尔, 雷霆商店模组管理器，或 r2模组管理器.
2. 启动游戏，享受清晰战斗视野！

手动安装

1. 确保 BepInExPack Valheim 已安装。
2. 下载并解压发布包。
3. 放置 世界存档静音器.dll 进入你的 Valheim/BepInEx/plugins/ 目录。
4. 启动英灵神殿。

---

从源码构建

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

dotnet 生成 -c 发布

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

自定义与持续集成路径

对于非标准 Steam 库位置，请复制 世界存档限制器.csproj.用户.示例 至 WorldSaveMuzzler.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 授权 - 详见 许可证.md 详情请见文件。