守护我，兄弟 · Valheim: 英灵神殿Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

🛡️ Ward Me Bruh!

Valheim 的基地管理、基于角色的访问控制和防御控制。

Ward Me Bruh! 扩展了原版 Valheim 守卫石，加入基于角色的权限、多守卫石区域链接、嵌套子守卫石、自动化基地维护以及可配置的防御护盾。

🛡️ 功能特性

ᚱ 符文共鸣（进阶系统） WardMeBruh 包含一个可选的 符文共鸣 进阶系统，默认启用。启用后，新放置的守卫石从 0 级开始，仅是基础边界标记。玩家通过在守卫石纪念碑处共鸣最多 8 个古弗萨克符文，来解锁高级功能、基地防御、自动化维护和更大的边界半径。

可选系统：如果你更喜欢原版风格的即时访问——每个守卫石从一开始就拥有全部功能和最大半径——可以通过在 vapok.mods.wardmebruh.cfg 中设置 Enable Runic Attunement Progression = false（或通过 Configuration Manager）来禁用进阶。禁用后，共鸣标签页和物理基座将被隐藏，所有守卫石立即拥有完整功能。

进阶模式（配置中的 Progression Mode）：
- Hybrid（默认）：需要同时制作物理拱心石并击败对应的世界 Boss。
- RunicKeystones：仅需要可制作的物理拱心石物品。
- WorldBossKeys：根据已击败的世界 Boss 钥匙自动解锁，无需物理拱心石。
物理基座：共鸣符文会在守卫石纪念碑周围生成一圈石质基座，上面漂浮着发光的符文石。进阶禁用时自动隐藏。
拱心石：在指定的制作站制作。每个默认重 200 单位——请相应规划搬运（或使用冒险背包，共鸣界面直接支持）。

8 个符文与拱心石配方

符文	符号	制作站	默认配方	所需 Boss	最大半径
Fehu	`ᚠ`	工作台（2 级）	1 赤血灵鹿战利品、20 燧石、40 优质木材	Eikthyr	25m
Uruz	`ᚢ`	锻造台（1 级）	1 古树长老战利品、20 青铜、10 焰灵核心	The Elder	40m
Thurisaz	`ᚦ`	锻造台（3 级）	1 骨mass战利品、20 铁、10 软泥	Bonemass	55m
Isa	`ᛁ`	锻造台（4 级）	1 冰霜龙母战利品、20 银、10 冰冻腺体	Moder	70m
Sowilo	`ᛋ`	锻造台（6 级）	1 炎魔战利品、20 黑金属、20 焦油	Yagluth	80m
Laguz	`ᛚ`	加尔德尔桌（1 级）	1 女王战利品、20 精炼以太、20 黑大理石	The Queen	90m
Dagaz	`ᛞ`	黑锻炉（2 级）	1 法德战利品、20 焰金属、20 黑木	Fader	100m
Hagalaz	`ᚺ`	黑锻炉（3 级）	1 冰霜之王掉落物、10 冰霜核心、20 冰霜木、20 金矿石	The Frozen King	120m

（注：每个符文解锁的功能均可在 vapok.mods.wardmebruh.cfg 中完全配置。默认设置留待你在游戏中自行探索发现）。

守卫石功能概览

游戏内功能	分类	描述
建筑自动修复	维护	扫描并修复守卫石范围内受损的建筑，直至可配置的生命值阈值（消耗箱子资源，或通过服务器配置免费）。
自动加燃料	维护	从链接的箱子中提取木材、煤炭、树脂和燃料，保持火焰、窑炉、熔炉和火把燃烧。
自动关门	维护	在可配置的延迟后（默认 5 秒），关闭守卫石范围内打开的门和闸门。
排水	维护	排空护盾穹顶内的水，让你可以在海平面以下建造干燥的地下室。
庇护所增益	维护	穹顶下获得最高基础舒适度，休息时冻结食物计时，死亡时防止技能损失。
恢复增强	维护	在活跃守卫石覆盖范围内，生命值、耐力和以太恢复速度提高 50%。
作物保护	防御	防止未经授权的玩家或游荡的怪物踩踏农田作物。
可采集物保护	防御	锁定边界内的野生可采集资源（浆果、蘑菇、花朵），防止未经授权的采集。
牲畜保护	防御	在守卫石区域内保护驯服的动物免受敌人伤害和友军伤害。
天气屋顶	防御	防止雨水腐蚀暴露的木材和结构部件，无需建造物理屋顶。
推斥力	防御	当入侵者试图穿透护盾穹顶时，将其向后推斥。
生物电击	防御	对突破边界的敌对怪物造成闪电电击伤害。
玩家电击	防御	电击试图未经许可进入的未经授权玩家。
抑制怪物生成	防御	阻止守卫石边界内所有生物生成，包括自然世界生成、灰矮人巢穴和尸鬼堆。
抑制袭击	防御	自动取消针对该区域的来袭基地袭击事件。
幽灵基地（伪装）	防御	伪装建筑结构，使敌人 AI 不会仇恨或瞄准基地建筑。
环境护盾	防御	阻挡灰烬之地的煤渣雨、熔岩火焰和极北之地的冰冻积雪堆积。
传送门访问控制	访问	按玩家角色限制传送门使用，在出发和目的守卫石两端均进行检查。
快速旅行	访问	从守卫石界面在已发现的守卫石之间直接传送玩家。
基地扩展与子守卫石	结构	区域链接，用于扩展基地覆盖范围或创建具有独立访问名册的嵌套私人房间。

守卫石管理与远程菜单

守卫石界面：直接在任何守卫石处访问（E 或 G）。标签页：概览、访问、防御、维护、角色和管理。
远程守卫石菜单：从一个菜单查看和配置你在世界各地拥有的所有守卫石。以层级结构显示基地，子扩展和子守卫石分组在下方。
字体缩放：直接在窗口标题栏中切换小、中、大三种文本大小。
完整控制器支持：在守卫石中心、实体配置对话框和模态窗口之间提供完整的游戏手柄导航，并带有上下文相关的屏幕按键提示。

基地扩展与子守卫石

放置提示：在活跃守卫石内放置新守卫石时，会提示你选择 扩展守卫石 或 子守卫石。
扩展守卫石：
- 通过投射额外的护盾穹顶来扩展主基地的覆盖区域。
- 继承主基地的角色、权限、设置和防御。
- 拥有独立的电源开关，可以禁用单个区域而无需关闭整个基地。
- 共享访问扫描器可在整个基地建筑群中查找箱子、门和传送门。
嵌套子守卫石：
- 放置在较大基地内的小型守卫石，用于私人房间、个人房屋或金库。
- 独立的角色、成员名册、权限和门/箱子锁。
- 边界半径自动适应父基地和附加的扩展，防止与同级子守卫石重叠。
- 通过防御标签页中的交互式色轮自定义穹顶颜色（改变穹顶、周边环和基地灯光）。

角色与访问控制

角色层级：默认角色为访客、居民、管理员 和 所有者。可以创建具有自定义名称和颜色的自定义角色。
服务器管理员：在服务器上的所有守卫石中均被认定为拥有所有者权限，用于管理和审核。
细粒度权限：控制建造、耕种、收获作物、进入穹顶、调整守卫石半径和管理基地设置。
对象访问：将单个门和箱子锁定到特定角色或角色名称。在世界中重命名门和容器（Shift + E）。
传送门门禁：按角色限制传送门使用，在出发和目的守卫石两端均进行检查。
持久名册：跟踪曾访问服务器的玩家，以便为离线玩家分配角色。

🕹️ 控制

WardMeBruh 在所有界面、配置对话框和世界内交互中均包含原生游戏手柄支持。控制和按钮提示会根据当前输入动态在键盘/鼠标和控制器布局之间切换。

世界内控制

操作	键盘 / 鼠标	游戏手柄	描述
打开守卫石中心	E 或 G	A	在守卫石纪念碑处打开守卫石管理界面。
切换守卫石电源	—	LT + A	直接在世界内切换守卫石激活状态，无需打开菜单。
配置门 / 箱子	Shift + E	LT + A	打开角色访问和重命名配置对话框。
配置传送门	Shift + E	LT + A	打开传送门角色访问配置对话框。
标准交互	E	A	标准的门/箱子/传送门交互（根据角色权限检查）。

守卫石中心对话框导航（游戏手柄）

操作	游戏手柄控制	描述
切换标签页	LB / RB	在守卫石中心标签页之间向前和向后循环。
跳转区块	LT / RT	将光标跳转到上一个或下一个卡片/区块。
导航元素	方向键或左摇杆	在按钮、开关和滑块之间移动焦点。
选择 / 切换	A	激活焦点按钮或切换复选框。
调整滑块	方向键左 / 右	步进调整滑块值（例如守卫石半径、修复阈值）。
符文共鸣	Y	直接快捷方式，打开符文共鸣进阶菜单。
其他守卫石	X	直接快捷方式，打开远程守卫石领地注册表。
循环字体大小	R3（右摇杆按下）	在 UI 文本缩放的小、中、大之间循环。
滚动视口	右摇杆（上 / 下）	平滑滚动活动标签页或模态窗口内容。
关闭 / 返回	B	关闭打开的模态窗口或退出守卫石中心。

⚙️ 配置

设置保存在 BepInEx/config/vapok.mods.wardmebruh.cfg。

服务器设置（同步）

Enable Ward Me Bruh：模组主开关（默认：true）。
Enable Runic Attunement Progression：进阶主开关（默认：true）。
Progression Mode：解锁符文的条件（Hybrid、RunicKeystones、WorldBossKeys）。
Enforce Ward Placement Clearance：防止在现有守卫石周边 15 米内放置新守卫石（默认：true）。
Keystone Weight：符文拱心石的物品栏重量（单位）（默认：200.0）。
Max Ward Radius：允许的最大半径（米）（默认：100.0）。
Ward Separation Distance：无主守卫石之间的最小缓冲距离（默认：50.0）。
Default Repair Threshold：区域修复运行前的损坏百分比（默认：0.70）。
Default Auto-Close Delay：打开的门自动关闭前的秒数（默认：5.0）。
Free Area Repair：为 true 时，修复不消耗资源（默认：false）。
Allow Ore Fast-Travel：允许原矿通过守卫石快速旅行（默认：false）。
Fast-Travel Combat Lockout：快速旅行前所需的脱战秒数（默认：10.0）。

客户端设置

Open Ward Hub Keybind：打开界面的快捷键（默认：<kbd>E</kbd>）。
Show Physical Attunement Stones：在已共鸣的守卫石纪念碑周围渲染发光的物理基座符文石（默认：true）。
Show Splash on Startup：游戏启动时显示模组摘要窗口（默认：true）。
Enable Anonymous Telemetry：发送匿名版本采用和会话启动指标（默认：false）。
Send Error Reports：发送经过脱敏处理的崩溃和异常报告（默认：true）。

🔌 开发者 API（`WardMeBruhAPI`）

第三方模组可以通过以下任一方式直接集成：

程序集引用：在编译时引用 WardMeBruhAPI.dll，并通过 ILRepack 打包。
反射客户端：将 Docs/WardMeBruhAPI_Client.cs 放入你的项目，实现零依赖反射，并使用缓存的委托。

详情请参阅 API 集成指南和类参考。

🤝 需求与兼容性

BepInEx：5.4.2350 或更高版本
Jotunn：2.30.2 或更高版本
兼容单人游戏、本地合作和专用服务器。
非破坏性 Harmony 补丁，设计用于与 ValheimPlus、远程制作和物品栏管理模组共存。

不兼容性

由于共享功能和重叠领地控制的特性，WardMeBruh 无法与其他全面改造守卫石的模组同时运行：

WardIsLove（Azumatt.WardIsLove）：不兼容。两个模组都会全面改造原生 PrivateArea 生命周期、边界计算和领地权限。只能运行其中一个。
ProtectiveWards（shudnal.ProtectiveWards）：不兼容。由于重复的守卫石访问和周边控制实现而直接冲突。

📦 安装与服务器设置

模组管理器（推荐）

通过 Gale、r2modman 或 Thunderstore Mod Manager 安装。
依赖项将自动解析并安装：BepInExPack、Jotunn 和 YamlDotNet。

手动安装

解压 .zip 压缩包，将 WardMeBruh 文件夹移动到你的 Valheim/BepInEx/plugins/ 目录中。

专用服务器与多人游戏

客户端和服务器均需安装：WardMeBruh 必须同时安装在服务器和所有连接的客户端上。该模组依赖自定义网络 RPC 和 ZDO 数据同步来实现领地访问、角色权限和符文进阶。
ServerSync 配置：在专用服务器上定义的同步配置设置（进阶开关、功能锁定、配方）会自动锁定并同步到所有连接的客户端。
专用服务器部署：将模组解压到专用服务器的 BepInEx/plugins/ 目录中。该模组会干净地检测无头服务器执行并跳过所有 UI 注册。

💬 社区

Bug 报告和功能请求：GitHub Issues
社区讨论：Discord

🔌 致模组开发者与 AI 编程代理

想要将你的模组与 WardMeBruh 集成或构建兼容性？

📖 集成指南与 API 参考：连接你的模组的完整指南。
🤖 AI 代理规则与不变量：AI 助手（Cursor、Claude、Copilot、ChatGPT、Gemini）的强制性指南。
📦 零依赖客户端包装器：即插即用的 C# 文件，无需外部 DLL 依赖即可安全集成。
⚠️ 严格政策：不要对内部类使用反射或 Harmony 补丁；始终使用公共 API。
💡 需要新的 API 功能？：提交功能请求或在我们的 Discord 中讨论。

🔒 匿名遥测、错误报告与隐私

WardMeBruh 包含轻量级、隐私优先的遥测和错误报告功能，帮助监控模组稳定性、诊断未处理的 Bug，并跟踪游戏更新中的活跃版本采用情况。

100% 匿名：我们从不收集个人数据、Steam ID、IP 地址、角色/世界名称或文件系统路径。错误堆栈跟踪会自动脱敏，去除本地用户目录。
细粒度玩家控制：
- 匿名遥测（选择加入）：跟踪版本采用和会话启动。首次加载时默认为未勾选 / 禁用（Enable Anonymous Telemetry = false）。
- 错误报告（选择退出）：捕获经过脱敏处理的模组崩溃诊断信息，以快速识别和修复 Bug。默认为启用（Send Error Reports = true），可一键选择退出。
- 数据免责声明：将鼠标悬停在启动模态窗口中的任何开关上，可查看交互式工具提示免责声明，详细说明传输的数据内容。
游戏内与在线隐私政策：完整隐私政策可直接在游戏内通过点击启动闪屏模态窗口上的 [ PRIVACY POLICY ] 查看，或在线访问 vapok.io/privacy-policy。
配置文件：设置可以在游戏内通过启动模态窗口、BepInEx Configuration Manager 或 BepInEx/config/vapok.mods.wardmebruh.cfg 中的 [Local Config] 下进行管理。

👨‍💻 由 Vapok Gaming 创建作者：Vapok 源代码：GitHub 仓库 社区与支持：Discord 服务器 更新日志：发布说明