英灵神殿1.0延续lunar91的跨服务器传送门。通过传送门连接服务器和本地世界。

跨服传送门续篇

通过普通传送门连接英灵神殿服务器和本地世界。

社区维护分支： 本项目是兼容 Valheim 1.0 的延续版本，源自 lunar91/lunarbin的跨服传送门原始设计和实现归lunar91及贡献者所有。此分支基于相同的GPL-3.0许可证分发，并非lunar91的官方发布版本。

推荐同伴：PortalPass

为了让受密码保护的服务器之间无缝通行，请将此模组与 Thunderstore上的PortalPass (GitHub 上的源码）。PortalPass 是一个可选的仅客户端伴侣，它从玩家控制的私有文件中提供密码，这样跨服务器传送门旅行就不会卡在密码提示上。它从不自动记录或学习密码。

兼容性

• 英灵神殿 1.0 / 专用服务器网络版本 39
• BepInExPack Valheim 5.4.2350 或更新的兼容版本
• 在每台参与跨服传送的客户端和服务器上进行安装

插件GUID和DLL名称保持不变，因此从原版模组升级时现有配置将会保留。安装此包前请先删除原始DLL；请勿同时运行两个版本。

安装

复制 瓦尔海姆跨服传送门.dll 进入 BepInEx/plugins/CrossServerPortals/ 在每个客户端和服务器上。

传送门标签

使用以下格式之一：

SourceTag|server.example.com:2456|TargetTag SourceTag|192.0.2.10:2456 SourceTag|[2001:db8::10]:2456|TargetTag SourceTag|world:我的本地世界|TargetTag

• 源标签 识别离开传送门。
• 目标标签 是可选的。到达时，模组会寻找该普通标签，或寻找源标签与之匹配的跨服务器传送门。
• 不带端口的服务器地址将使用 Valheim 的默认端口， 2456.
• 带端口的IPv6地址必须使用方括号。
• 世界： 目的地按名称切换到本地世界。

跨服传送门会忽略英灵神殿常规的物品传送限制，与原版模组的行为一致。

配置

• 保留状态效果 —在模组驱动的转移过程中保留休息和潮湿等效果。
• 重绘传送门符文 / 自定义传送门符文颜色 — 通过视觉识别跨服传送门。
• 传送门效果重新着色 / 自定义传送门特效颜色 — 自定义他们的粒子效果。
• 传送前提示 — 离开当前服务器前请求确认。
• 需要管理员重命名 — 跨服传送门标签的服务器同步限制。
• 锁定管理员配置 — 锁定同步的管理员配置。

这次续作有什么变化

• 使用新的扁平化传送门列表 API 恢复了 Valheim 1.0 兼容性。
• 已将异步线程池延迟替换为 Unity 协程。
• 在目的地加载完成后保留计算出的安全退出位置。
• 将定期传送门枚举限制在服务器端，并按稳定的 ZDO ID 比较传送门。
• 重做了传送门标签验证，以更安全地处理 DNS、端口、世界名称和 IPv6。
• 已更新弃用的粒子系统调用并改进了空值安全性。
• 新增了可重复的 Linux 构建、解析器测试、CI 以及可直接用于 Thunderstore 的打包。

看 更新日志.md 发布历史及 文档/发布指南.md 供维护者发布说明使用。

建筑

设置 瓦尔海姆游戏路径 到包含BepInEx的英灵神殿安装目录，然后：

dotnet test tests/CrossServerPortals.Tests.csproj dotnet build CrossServerPortals.csproj -c Release dotnet msbuild CrossServerPortals.csproj -t:Package -p:Configuration=Release

已写入 Thunderstore 兼容压缩包至 构件/.

鸣谢与许可

• 农历91 — 原作者与架构
• 疯狂打地鼠 — 原始管理员权限工作
• 服务器同步 — 服务器权威配置

授权依据 GPL-3.0来自上游仓库的 Git 历史记录已保留。