XPortal Networks

XPortal Networks
[b]XPortal Networks[/b] 是一个对原版传送门系统进行全面重做的 Valheim 模组。你不再受限于匹配相同的传送门标签或建造庞大的传送门枢纽，XPortal Networks 允许你直接从交互式列表中选择任意传送门的目的地——现在更配备了扩展的 [b]传送门网络[/b] 系统，包含公共、私人和自定义命名网络！
[center][b]XPortal Networks[/b]
[img height=180]https://raw.githubusercontent.com/Vapok/XPortalNetworks/refs/heads/main/images/XPortal%20Networks%20Window.png[/img][/center]
[center][b]网络选择窗口[/b]
[img height=180]https://raw.githubusercontent.com/Vapok/XPortalNetworks/refs/heads/main/images/Portal%20Network%20Window.png[/img][/center]
[center][b]目的地网络选择[/b]
[img height=180]https://raw.githubusercontent.com/Vapok/XPortalNetworks/refs/heads/main/images/Destination%20Portals%20with%20Private.png[/img][/center]
[line]
[heading]XPortal Networks 的新内容[/heading]
XPortal Networks 建立在 SpikeHimself 原版 XPortal 模组的坚实基础之上，将其扩展为一个专用的网络框架，具备丰富的多人游戏功能和大量错误修复：
[list]
[][b]传送门网络[/b]：将传送门分组到不同的网络中：
[list]
[][b]全局 / 公共网络[/b]：服务器上所有玩家均可访问。[/]
[][b]玩家网络与私人传送门[/b]：与单个玩家绑定的传送门。切换 [b]私人[/b] 设置后，未授权的玩家将无法查看或通过你的个人传送门进行传送。[/]
[][b]自定义命名网络[/b]：通过配置定义最多 15 个服务器范围的自定义网络（例如 [i]贸易中心[/i]、[i]氏族基地[/i]、[i]采矿前哨站[/i] 或 [i]仅限管理员[/i]），并支持实时热重载。[/]
[/list][/]
[][b]服务器管理与权限控制[/b]：可配置的权限允许服务器管理员管理网络，并阻止非所有者拆除传送门。[/]
[][b]错误修复与现代化[/b]：
[list]
[]已针对最新的 Valheim 版本和 .NET Framework 4.8 进行升级。[/]
[]解决了控制器 UI 图例和导航问题。[/]
[]修复了专用服务器管理员拆除和权限的边界情况。[/]
[]增强了 ZDO 网络同步和重连可靠性。[/]
[/list][/]
[/list][line]
[heading]功能[/heading]
🌐 目的地选择菜单
与传送门交互时，会打开一个简洁的 UI，允许你从下拉菜单中选择目标目的地。列表显示：
[list]
[]目的地传送门名称[/]
[]到目的地的距离（以米为单位）[/]
[]传送门灯光颜色指示器（与 Advanced Portals 或 Stone Portal 等模组搭配使用时）[/]
[/list]🔒 公共、私人和自定义网络
组织你的世界交通：
[list]
[][b]全局网络[/b]：对所有人开放的共享网络。[/]
[][b]个人网络[/b]：传送门自动归组在你的角色名下。[/]
[][b]私人传送门[/b]：将敏感的传送门标记为私人，使其他玩家无法使用或重新设定其目标。[/]
[][b]自定义命名网络[/b]：管理员在
[code]xportal_networks.json[/code] 中定义的频道，可按阵营、地区或用途组织传送门。[/]
[/list]⭐ 默认传送门目的地
你可以将一个传送门设置为你的 [b]默认传送门[/b]。新建的传送门将立即自动链接到你的默认传送门，为你设置前沿作战基地节省时间。
🏷️ 传送门名称长度无上限
XPortal Networks 移除了原版对传送门标签的字符限制，允许你为传送门起描述性强且易于记忆的名称。
📍 在地图上标记传送门
忘记传送门通向哪里了？点击 [b]标记[/b] 按钮即可直接在地图上高亮显示目的地传送门，并通过地图标记提醒你的冒险伙伴。
🎮 完整的手柄与控制器支持
完全可使用控制器导航，并集成了屏幕按键提示：
[table][tr][th]按键（Xbox / PlayStation）[/th]
[th]操作[/th]
[/tr]
[tr][td][b]A[/b] / [b]Cross[/b][/td]
[td]确认 / 提交传送门配置[/td]
[/tr]
[tr][td][b]B[/b] / [b]Circle[/b][/td]
[td]取消 / 关闭菜单[/td]
[/tr]
[tr][td][b]Y[/b] / [b]Triangle[/b][/td]
[td]在地图上标记选定的目的地[/td]
[/tr]
[tr][td][b]X[/b] / [b]Square[/b][/td]
[td]打开 / 关闭目的地下拉列表[/td]
[/tr]
[tr][td][b]方向键上 / 下[/b][/td]
[td]浏览目的地列表[/td]
[/tr]
[/table][line]
[heading]模组兼容性与集成[/heading]
[list]
[][b][url=https://valheim.thunderstore.io/package/ValheimModding/Jotunn/]Jötunn, the Valheim Library[/url][/b]（必需）[/]
[][b][url=https://valheim.thunderstore.io/package/RandyKnapp/AdvancedPortals/]Advanced Portals[/url][/b]：完全集成——在下拉菜单中显示匹配的彩色灯光图标。[/]
[][b][url=https://valheim.thunderstore.io/package/JereKuusela/Stone_Portal/]Stone Portal[/url][/b]：已支持，具有独特的传送门配色。[/]
[][b][url=https://valheim.thunderstore.io/package/Maynard/VHVR/]VHVR - Valheim VR[/url][/b]：兼容。[/]
[][b][url=https://valheim.thunderstore.io/package/nexusreupload/aedenthorn_Nexus_Update_Check/]Nexus Update Check[/url][/b]：兼容。[/]
[/list][i]注意：与 AnyPortal 不兼容（XPortal Networks 取代并超越了 AnyPortal 的功能）。[/i]
[line]
[heading]使用方法[/heading]
[list=1]
[][b]建造传送门[/b]：像平常一样放置传送门。[/]
[][b]打开配置 UI[/b]：走近传送门并按交互键（
[code]E[/code] /
[code]A[/code]）。[/]
[][b]配置你的传送门[/b]：
[list]
[][b]传送门名称[/b]：为当前传送门输入一个名称。[/]
[][b]网络[/b]：选择此传送门属于 [i]全局[/i] 网络、你的 [i]个人[/i] 网络还是 [i]自定义命名网络[/i]。[/]
[][b]目的地[/b]：从下拉列表中选择目的地传送门。[/]
[][b]设为私人[/b]：（可选）勾选以限制访问，使只有你（和管理员）可以使用或修改该传送门。[/]
[][b]设为默认[/b]：（可选）勾选以将此传送门设为新建传送门的自动目的地。[/]
[/list][/]
[][b]确认[/b]：点击 [b]OK[/b] 保存并激活连接。[/]
[/list][line]
[heading]配置[/heading]
常规与服务器设置
主配置文件位于
[code]BepInEx/config/vapok.mods.xportalnetworks.cfg[/code]。服务器强制执行的设置将自动从服务器同步到连接的客户端。
[list]
[][code]PingMapDisabled[/code] [i]（服务器强制执行）[/i]：为使用
[code]nomap[/code] 或沉浸式导航规则的服务器禁用地图标记。[/]
[][code]HidePortalDistance[/code] [i]（服务器强制执行）[/i]：隐藏下拉菜单中传送门名称旁显示的米数距离。[/]
[][code]DoublePortalCosts[/code] [i]（服务器强制执行）[/i]：将传送门制作成本加倍，以平衡一对多传送门路由的便利性。[/]
[][code]RestrictPortalRemoval[/code] [i]（服务器强制执行）[/i]：将拆除/摧毁传送门的权限限制为原始创建者或服务器管理员。[/]
[][code]DisplayPortalColour[/code]：在菜单中显示与传送门类型匹配的彩色指示器。[/]
[/list]自定义命名网络（
[code]xportal_networks.json[/code]）
服务器可以通过编辑
[code]BepInEx/config/XPortalNetworks/xportal_networks.json[/code] 来定义自定义网络。对此文件的更改会被自动检测并实时重新加载，无需重启服务器：
[img]http://localhost:63342/markdownPreview/707340913//home/vapok/Modding/Valheim/XPortalNetworks[/img]
[code][
{ "id": 1, "name": "Admin Network" },
{ "id": 2, "name": "Trade Hub" },
{ "id": 3, "name": "North Outposts" }
][/code][i]（支持网络 ID 1 到 15）。[/i]
[line]
[heading]安装[/heading]
前置要求
[list]
[][b][url=https://valheim.thunderstore.io/package/denikson/BepInExPack_Valheim/]BepInExPack Valheim[/url][/b]（v5.4.2200+）[/]
[][b][url=https://valheim.thunderstore.io/package/ValheimModding/Jotunn/]Jötunn (ValheimLib)[/url][/b]（v2.20.0+）[/]
[/list]自动安装（推荐）
使用 [b]r2modman[/b] 或 [b]Vortex[/b] 等模组管理器一键下载并安装 XPortal Networks。
手动安装
[list=1]
[]从 Thunderstore、Nexus Mods 或 GitHub Releases 下载最新的发布
[code].zip[/code]。[/]
[]将压缩包内容解压到你的
[code]Valheim/BepInEx/plugins/[/code] 目录中。[/]
[]确保客户端和专用服务器都安装了 XPortal Networks。[/]
[/list][line]
[heading]错误报告、功能请求与翻译[/heading]
[list]
[][b]错误报告[/b]：请使用
[code]Bug report[/code] 模板在 [url=https://github.com/Vapok/XPortalNetworks/issues]GitHub Issues[/url] 页面提交问题。请附上你的
[code]LogOutput.log[/code] 文件。[/]
[][b]功能请求[/b]：在 GitHub 上选择
[code]Feature request[/code] 模板提交问题。[/]
[][b]翻译[/b]：欢迎通过 GitHub 拉取请求或问题提交新语言或本地化更新的贡献。[/]
[/list][line]
[heading]致谢与鸣谢[/heading]
[list]
[][b][url=https://github.com/SpikeHimself]SpikeHimself[/url][/b]：原版 [b]XPortal[/b] 模组的创作者，XPortal Networks 在此基础上构建并扩展。[/]
[][b]翻译与社区[/b]：感谢 [i]kaiqueknup[/i]、[i]makou[/i]、[i]Smok3y97[/i]、[i]MexExe[/i]、[i]hanawa07[/i]、[i]bonesbro[/i]、[i]VasariRulez[/i]、[i]Felix[/i] 和 [i]cawa-93[/i] 提供原始翻译和社区贡献。[/]
[/list]