传送门配置界面

网络选择窗口

目标网络选择

---

XPortal Networks 新动态

XPortal Networks 在原版 XPortal 模组由 SpikeHimself 打下的坚实基础上构建，将其扩展为一个专用的网络框架，具备大量多人游戏功能并修复了众多错误：

• 传送门网络：将传送门分组为不同的网络：
  • 全球/公共网络所有服务器玩家均可访问。
  • 玩家网络与私人传送门：传送门与玩家个体绑定。切换 私人 设置后，未经授权的玩家将无法查看或通过你的个人传送门进行传送。
  • 自定义命名网络： 定义最多15个服务器范围的定制网络（例如 贸易中心, 氏族基地, 采矿前哨站，或 仅管理员）通过配置实现，并支持实时热重载。
• 服务器管理与权限控制：可配置权限，允许服务器管理员管理网络并阻止非所有者拆除传送门。
• 错误修复与现代化更新:
  • 已针对最新的英灵神殿版本和.NET Framework 4.8 进行升级。
  • 已解决控制器界面图例和导航问题。
  • 修复了专用服务器管理员破坏和权限的边界情况。
  • 增强了ZDO网络同步与重连可靠性。

---

功能

🌐 目的地选择菜单

与传送门互动时，会打开一个简洁的界面，让你从下拉菜单中选择目标目的地。列表显示：

• 目标传送门名称
• 到目的地的距离（米）
• 传送门光照颜色指示器（与高级传送门或石质传送门等模组搭配使用时）

🔒 公共、私人及自定义网络

组织你的世界的交通运输：

• 全球网络向所有人开放的共享网络。
• 个人网络：传送门会自动归组到你的角色下方。
• 私人传送门将敏感传送门标记为私有，这样其他玩家就无法使用或重新指定它们。
• 自定义命名网络管理员定义的频道定义于 xportal_networks.json 按阵营、区域或用途对传送门进行分类。

⭐ 默认传送门目的地

你可以将传送门设置为你的 默认传送门新建传送门将自动连接到你的默认传送门，让你在建立前方作战基地时省去不少时间。

🏷️ 无限制传送门名称长度

XPortal Networks移除了原版传送门标签的字符限制，让你可以为传送门起描述性强且好记的名字。

📍 在地图上标记传送门

忘记传送门通向哪里了？点击 延迟 按钮可在地图上直接高亮目的地传送门，并通过地图标记提醒你的冒险者同伴。

🎮 完整手柄与控制器支持

完全支持控制器操作，并带有屏幕按键提示：

按钮（Xbox / PlayStation）	动作
A / 十字键	确认 / 提交传送门配置
B / 圆	取消 / 关闭菜单
Y / 三角形	在地图上标记选定目的地
X / 方形	打开/关闭目的地下拉列表
十字键上/下	导航目标列表

---

模组兼容与整合

• 约顿，瓦尔海姆图书馆 （必填）
• 冒险背包：完全支持（已装备背包中的传送限制会被严格执行）。
• 快速转移物品：完全支持。
• 高级传送门：完全整合——在下拉菜单中显示匹配的彩色灯光图标。
• 石之门：用独特的传送门颜色标识。
• 瓦姆海姆 VR：兼容。
• Nexus更新检查：兼容。

注意：与AnyPortal不兼容（XPortal Networks将取代并替代AnyPortal的功能）。

---

使用方法

1. 建造传送门：正常放置传送门。
2. 访问配置界面走到传送门旁，按下你的交互键（E / A）
3. 配置你的传送门:
   • 传送门名称：输入当前传送门的名称。
   • 网络：选择此传送门是否属于 全局 网络，你的 个人 网络，或 自定义命名网络.
   • 目的地：从下拉列表中选择目标传送门。
   • 设为私密（可选）勾选此项可限制访问权限，仅你（和管理员）可以使用或修改传送门。
   • 设为默认（可选）勾选此项，将此传送门设为新建传送门的自动目的地。
4. 确认：点击 好的 保存并激活连接。

---

配置

通用与服务器设置

主配置文件位于 BepInEx/配置/vapok.mods.xportalnetworks.cfg服务器强制设置将通过 ServerSync 自动从服务器同步到已连接的客户端。

设置	类型	描述
地图标记已禁用	服务器强制执行	禁用服务器地图标记功能，适用于以下模式： 不使用地图 或沉浸式导航规则。
隐藏传送门距离	服务器强制	隐藏下拉菜单中传送门名称旁显示的距离计。
双重传送门消耗	服务器强制	将传送门制作成本翻倍，以平衡一对多传送门路由的便利性。
限制传送门移除	服务器强制执行	将传送门的拆除/摧毁权限限制为仅原始创建者或服务器管理员。
显示传送门颜色	客户端配置	在菜单中显示与传送门类型匹配的彩色指示器。

自定义命名网络（xportal_networks.json)

服务器可通过编辑来定义自定义网络 BepInEx/配置/XPortalNetworks/xportal_networks.json此文件的更改会被自动检测并实时重新加载，无需重启服务器：

管理员网络
贸易枢纽
北部前哨站

（支持网络 ID 1 至 15）。

---

安装与服务器设置

前置条件

• BepInExPack 英灵神殿 （v5.4.2200+）
• 约顿巨人（瓦尔海姆图书馆） （v2.20.0+）

自动（推荐）

使用模组管理器，例如 r2modman 或 雷暴商店模组管理器 一键下载并安装XPortal Networks。

手动安装

1. 下载最新版本 .zip 从Thunderstore或GitHub Releases。
2. 将存档内容解压到你的 Valheim/BepInEx/plugins/ 目录。
3. 确保客户端和专用服务器均安装 XPortal Networks 以实现多人游戏同步。

---

漏洞、功能建议与社区

• Bug 反馈： 请在以下位置提交问题： GitHub 问题 使用 Bug报告 模板。请附上您的 日志输出.log 文件。
• 功能建议在GitHub上打开一个问题，选择 功能请求 模板。
• 翻译：欢迎通过 GitHub 拉取请求或在 Discord 上为新语言或本地化更新做出贡献。

---

制作人员与致谢

• 斯派克本人：原作的创作者 X传送门 模组，XPortal网络正是基于此构建并扩展的。
• 翻译与社区：感谢 开关键, 马口, Smok3y97, 墨西哥执行文件, 花轮07, 骨头哥, 瓦萨里必胜, 菲利克斯，以及 cawa-93 用于原始翻译和社区贡献。

---

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

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

• 100%匿名：我们绝不收集个人数据、Steam ID、IP 地址、角色/世界名称或文件系统路径。错误堆栈跟踪会自动清理，以移除本地用户目录。
• 精细玩家控制:
  • 匿名遥测（可选加入）：跟踪版本采用情况和会话启动次数。默认为 未选中 / 已禁用 当首次加载时（启用匿名遥测 = false）。
  • 错误报告（可选择退出）捕获已清理的模组崩溃诊断信息，以快速识别并修复错误。默认值为 已启用 (发送错误报告 = true）支持一键退出。
  • 数据免责声明：将鼠标悬停在启动模态框中的任意切换开关上，即可查看交互式工具提示免责声明，详细了解具体传输哪些数据。
• 游戏内及在线隐私政策：完整的隐私政策可直接在游戏内点击查看 [ 隐私政策 ] 在启动闪屏弹窗上，或在线访问 vapok.io/privacy-policy.
• 配置文件： 设置可以在游戏内通过启动弹窗、BepInEx配置管理器或以下位置进行管理： [本地配置] 在 BepInEx/配置/vapok.mods.xportalnetworks.cfg.

---