只读、用户控制的英灵神殿服务器密码；非常适合无缝跨服务器传送门继续旅行。

传送通行证

PortalPass 是一个仅客户端使用的 Valheim 1.0 模组，它会从本地私有文件中自动提供服务器密码。它在 Valheim 正常的密码握手阶段生效，因此直接加入和由 Cross Server Portals Continued 发起的连接都遵循相同的规则。

默认私密

PortalPass 不会发现、收集、记录、学习或编辑密码。 你创建并维护 密码.env；PortalPass 仅在 Valheim 要求输入密码时读取该文件。它绝不会复制手动输入的密码、将凭据写回磁盘、记录凭据，也不会将其添加到导出的模组配置文件中。

这是一项安全功能，而非漏洞：玩家仍然是唯一有权添加或更改已保存密码的主体。如果该文件缺失、无效或没有匹配的服务器，PortalPass不会做任何更改，Valheim会显示其正常的密码提示。该模组绝不会自动填充 密码.env 给你。

用于跨服传送门旅行

传送门通行证特别适合与 跨服传送门续篇 (来自 GitHub 的源代码当传送门将你带到另一个受密码保护的服务器时，PortalPass 会自动提供该目的地配置的密码。传送门模组为可选；PortalPass 也可用于普通直接加入。

为什么

在Steam Deck上以及跨服务器传送门旅行时，重复输入密码尤为不便。PortalPass让这些加入过程变得无缝顺畅，无需在共享的r2modman配置文件中存放凭据。

需求

• 《英灵神殿》1.0
• BepInExPack Valheim 5.4.2350 或更新兼容版本
• 仅在客户端安装PortalPass

安装

在r2modman中将发布版ZIP作为本地模组安装，或者复制 PortalPass.dll 进入客户的 BepInEx/plugins/PortalPass/ 目录。启动一次游戏以创建 com.jcruse03.portalpass.cfg.

秘密文件

默认路径特意设置在r2modman配置文件之外：

• Linux / Steam Deck： ~/.config/portalpass/passwords.env
• Windows： %LOCALAPPDATA%\PortalPass\passwords.env

自己创建目录和文件。在Linux上，使用以下命令保护它：

chmod 600 ~/.config/portalpass/passwords.env

格式：

# 全主机默认 valheim.example.net = common-password # 精确端点优先于全主机默认 valheim.example.net:2471 = test-server-password # IP 地址同理 203.0.113.20 = another-password 203.0.113.20:2459 = specific-password # IPv6 精确端点使用方括号 2001:db8::1 = ipv6-default [2001:db8::1]:2459 = ipv6-specific

密码可以不带引号，也可以使用匹配的单引号或双引号括起来。第一个 = 分隔端点，因此 = 密码中允许使用。

要使用其他位置，请编辑 秘密文件路径 在 BepInEx/config/com.jcruse03.portalpass.cfg一个 ~/... 支持该路径。

匹配与安全

1. 精确归一化 主机:端口
2. 规范化主机/IP（不含端口）
3. 不匹配：正常的英灵神殿密码对话框仍处于激活状态

主机名不区分大小写，并忽略末尾的点。IP 地址使用其规范文本形式。PortalPass 不解析 DNS，因此主机名与其 IP 地址是分开的规则。重复的规范化端点或任何格式错误的行都会使该次尝试的文件失效；PortalPass 随后会保持原版提示不变。密码绝不会被记录，也不会从手动输入中学习。

每次密码握手时都会重新读取该文件，因此编辑后无需重启游戏。

Valheim在握手前可能会将专用IP或主机名解析为PlayFab后端。PortalPass会为匹配保留原始的专用端点，因此该文件会继续使用来自加入请求或跨服务器传送门标签中人类可读的主机名或IP。

开发

本地 游戏 路径必须指向带有BepInEx的英灵神殿安装目录。然后：

mise trust mise run check

这是针对本地英灵神殿1.0程序集构建的，运行纯解析器测试，并创建 artifacts/PortalPass-v0.1.2.zip.

状态

PortalPass 已通过 Windows 以及 Linux 上通过 Proton 的实时客户端连接测试，包括 Valheim 的 PlayFab 后端解析路径。