卡图尔的传送门网络

[size=5]Cartur 的传送门网络[/size]

选择任意传送门通向何处。打开一个传送门，从列表中选择另一个传送门，前者便会通向后者：无需名称匹配，而且你的选择在存档并重新加载后依然保留。

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/portal-open.jpg[/img]
[i]一个已选择目的地的传送门。门洞中显示另一个传送门周围环境的画面；底部溢出青色雾气。[/i]


[size=4]功能[/size]

[list]
[][b]选择任意目的地。[/b] 与传送门交互以打开选择界面。界面列出世界中的每个传送门及其名称、生物群系和距离。可按名称或生物群系搜索，按距离或名称排序，重命名你所在的传送门，激活目的地，或断开连接。[/]
[][b]带边框的界面。[/b] 选择界面嵌在一个雕刻钢制边框中，框中饰有一棵树、两只渡鸦和一个 valknut 符文。界面打开时，光芒沿边框流动。界面开启期间，光芒缓慢起伏。指针悬停的行会亮起，按钮会略微抬起。一次显示六行；更长的列表可滚动。选择目的地后，界面会保持打开约一秒，同时光芒作出回应，该行变为“已激活”（ACTIVE）。关闭时，光芒从下往上渐暗。方向键和回车键可在列表中操作。[/]
[][b]收藏、最近和返回。[/b] 行上的菱形可将传送门标记为收藏；收藏项始终位于列表顶部。“最近”（RECENT）按你最近到达的传送门排序。跳跃后，你从其中出来的传送门上的“返回”（BACK）会将其指向你来自的传送门。这些按角色和世界分别保存，位于 [b]BepInEx/config/com.cartur.portalnetwork.player.txt[/b]。[/]
[][b]在地图上显示。[/b] 行上的“地图”（MAP）会关闭界面并打开大地图并定位到该传送门。（如果安装了 Cartur's Map Pins，它已经会固定传送门；此功能不会添加固定标记。）[/]
[][b]默认目的地。[/b] “设为默认”（MAKE DEFAULT）位于你所在传送门的目的地旁边，用于保存该目的地；之后建造的网络传送门会初始指向它。再次按下可清除。[/]
[][b]悬停文本中的目的地。[/b] 查看已选择目的地的传送门时，其名称下方会显示“通往 <名称>”。[/]
[][b]选择会持久保存。[/b] 选定的目的地会在保存、退出和重新加载后保留，并在重命名后保留。如果目的地被摧毁，链接会被断开。[/]
[][b]会开启的传送门。[/b] 有目的地的传送门会保持休眠，直到玩家进入范围（默认 8 米），然后其环会充能，门洞从中心向外扩展。走远则会关闭。[/]
[][b]另一侧的画面。[/b] 门洞中显示目的地的快照，拍摄于你站在其附近时从前方看到的情景。它是图片，不是实时视图：其中没有任何东西移动。游戏会为每个目的地保存白天和夜晚图片，并随着昼夜交替在两者之间渐变（在夜晚图片存在之前，白天图片在夜间会变暗）。当你靠近时，图片每十分钟刷新一次。[/]
[][b]新的传送门部件。[/b] [i]网络传送门[/i] 是一个刻有发光符文的传送门。它基于普通传送门建造，因此会像普通传送门一样连接、传送和保存。它被添加到锤子的建造列表中。[/]
[][b]传送门音效。[/b] 传送门苏醒时会发出开启音效，开启期间持续嗡嗡声，关闭时有闭音效。它们替换原版传送门的嗡嗡声，默认音量与原版相同。某人刚从中出来的传送门在关闭期间保持安静。[/]
[][b]跳跃是一段短片。[/b] 当你踏入网络传送门时，镜头会冲向它：视野变宽，略微倾斜并震动，速度条纹从屏幕中央向外延伸，颜色边缘出现色散（游戏自带的色差效果），同时伴随上升的呼啸声。镜头停在传送门前，你走入的传送门独自立于黑色背景中，其漩涡显示另一侧，伴随雾气、飘移的火花和缓慢推近：这就是加载界面，期间只有传送门的嗡嗡声（游戏其余声音暂停，到达后恢复）。当远端准备就绪时，镜头冲入漩涡，伴随闪光和轰鸣，你在远端传送门前出现，并伴随一阵火花。镜头从拍摄目的地图片时的同一视角开始，因此窗口所显示的就是你到达时所看到的；一秒后（你的控制被暂时锁定），镜头升起越过传送门，伴随嗖声落定在你角色身后。第一人称下到达过程更短。设置 [b]PortalZoom[/b] 可关闭此效果。当菜单动画关闭时，或 Windows 的“在 Windows 中显示动画”关闭时（Windows 在远程会话如远程桌面或 TeamViewer 中会自动关闭），跳跃是平静的：没有冲刺、条纹、震动、闪光、火花或跳跃音效，只有短暂淡入到黑色背景上的传送门及其嗡嗡声，然后普通地切回。[/]
[][b]看到他人到达。[/b] 当服务器批准跳跃时，它会通知出口传送门附近的玩家（约 120 米内）。出口会像玩家靠近时那样为他们打开，显示旅行者来源地的图片，旅行者片刻后出现在其前方（他们的镜头在游戏自身传送开始前会飞向传送门一秒，这正是出口得以打开的时间）。然后它关闭，因为旅行者是附近唯一的人。一旦有其他玩家靠近，它会像任何传送门一样再次打开，且该玩家可以使用它。旅行者单独一人在 10 秒内不能走回其中，或直到他们走开约 5 英尺，或直到他们打开其菜单（这是他们有意识地返回的方式）；被拒绝时会有消息告知他们。没有安装 Portal Network 的玩家看到的是普通传送门。[/]
[][b]更快的短距离跳跃。[/b] 当目的地已加载时，跳跃约需 2 秒，而非原版的 8 秒或更多。长距离跳跃不变。[/]
[][b]私人传送门。[/b] 在服务器上，新传送门对其建造者私密；可与所有人、选定玩家或一个守卫（见下文）共享。[/]
[][b]服务器检查。[/b] 跳跃前，服务器会检查传送门已链接、目的地仍存在、你站在传送门处，且世界允许传送门。[/]
[][b]图片来自服务器。[/b] 在服务器上，一个玩家拍摄的目的地图片由服务器保存，并发送给其他可使用该传送门且自己没有图片的玩家。从未靠近过某目的地的玩家仍可在门洞中看到它。[/]
[/list]
[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/selection-screen.jpg[/img]
[i]雕刻边框中的选择界面，在一个名为 FARA 的传送门处打开，该传送门链接到 PN5。顶行：重命名、目的地、返回、设为默认和断开连接。下方是访问按钮（所有人、守卫、共享给）、搜索框，以及五个传送门的列表，包含生物群系、距离、收藏菱形、地图和激活。[/i]

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/opening-sequence.jpg[/img]
[i]同一段视频中的六帧，相隔 3 秒：环亮起，门洞形成，然后打开并显示目的地及底部雾气，最后镜头绕传送门移动。[/i]


[size=4]跳跃[/size]

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/jump-walk-up.jpg[/img]
[i]玩家跑向一个已链接的传送门：门洞已形成并显示另一侧的图片。[/i]

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/jump-rush.jpg[/img]
[i]跳跃进行到 0.95 秒时保持的一帧（游戏在该时刻通过测试命令暂停）：视野宽广，速度条纹从中央向外延伸，边缘颜色出现色散。[/i]

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/jump-loading.jpg[/img]
[i]加载界面进行到 3 秒时保持的一帧（以同样方式暂停）：走入的传送门独自立于黑色背景中，门洞中显示另一侧的图片，火花飘移。[/i]

[img]https://raw.githubusercontent.com/jekkle/cartur/main/portal-network/images/jump-arrival.jpg[/img]
[i]一次真实跳跃录像中的一帧，刚到达时：第一视角正是拍摄传送门中图片时的视角（此处为雪林），伴随一阵火花和速度条纹。[/i]


[size=4]管理员命令[/size]

在游戏控制台（F5）中输入这些命令。服务器根据其自身的管理员列表决定谁是管理员；其他人会被告知无权操作。

[list]
[][b]wg_list[/b] 列出每个传送门及其所有者、谁可以使用它以及它通向何处。[/]
[][b]wg_status[/b] 显示版本、协议号、传送门数量以及旅行检查是否开启。[/]
[][b]wg_unlink <传送门名称>[/b] 移除所有具有该名称的传送门的目的地。名称、所有者和共享设置保留。[/]
[/list]

[size=4]版本[/size]

客户端和服务器运行相同的协议，否则选择界面会说明并保持只读（“此服务器运行 Portal Network x.y，此版本无法读取”）。较新版本会向传送门列表添加内容而不破坏旧版本；仅当无法以该方式添加内容时，协议号才会更改。


[size=4]谁可以使用传送门[/size]

在服务器上，新传送门对建造它的玩家私密：其他玩家不会在其列表中看到它，也无法链接到它或通过它跳跃。所有者通过界面中传送门名称下方的一排按钮决定还有谁可以进入：

[list]
[][b]所有人（EVERYONE）[/b] 与每个玩家共享。[/]
[][b]共享给（SHARE WITH）[/b] 打开一个曾加入世界的所有人的列表；点击名字与该人共享，再次点击收回。共享跟随玩家的账户，而非角色，并且在他们离线时也有效。[/]
[][b]守卫（WARD）[/b] 允许站在传送门上的守卫成员使用它（默认开启；关闭可阻止他们）。守卫属于角色，因此此设置跟随角色。[/]
[]管理员可查看和管理每个传送门。[/]
[]玩家可以将他们可使用的传送门指向任何其他他们可使用的传送门，而不能指向其他。[/]
[]只有所有者（和管理员）可以重命名传送门。没有已知建造者的传送门可由任何可使用它的人重命名。[/]
[/list]
在你添加 Portal Network 时世界中已存在的传送门对所有人保持开放，直到其所有者决定：所有者第一次打开一个传送门时，会询问是保持共享还是设为私密。在单人游戏中这些都不会显示。


[size=4]设置[/size]

编辑 [b]BepInEx/config/com.cartur.portalnetwork.cfg[/b]（或使用 Configuration Manager）。更改值后重启游戏。

[list]
[][b]Portal / OpenRange[/b]（默认 8）：有目的地的传送门开启的距离（米）。原版使用 5。[/]
[][b]Portal / PortalZoom[/b]（默认开启）：跳跃时镜头飞入传送门，到达后在远端传送门上停留片刻，然后拉出。关闭则保持普通黑色加载界面。[/]
[][b]Portal / SoundVolume[/b]（默认 0.56）：传送门音效的音量：开启、开启期间的嗡嗡声、关闭，以及跳跃加载期间的嗡嗡声。默认与原版传送门嗡嗡声一样响（文件实测：-16.1 对 -16.2 LUFS）；1 表示比它高五分贝。它们也会随距离变轻，如同原版嗡嗡声。[/]
[][b]Portal / ArrivalClosedSeconds[/b]（默认 10）：你从其中出来的传送门在多长时间内不能走回。0 表示关闭此限制。[/]
[][b]Portal / ArrivalClosedFeet[/b]（默认 5）：离开你出来的传送门这么多英尺后，你可以立即再次使用它。[/]
[][b]Portal / Alive[/b]（默认 1）：门洞的活动程度：边缘呼吸、图片波动、符文光芒脉动。0 表示静止。[/]
[][b]Mist / FloorAmount[/b]（默认 0.5）：从传送门前方沿地面扇出的雾气，约一英尺深；风和走过的人会扰动它。0 表示关闭。[/]
[][b]Mist / FrameEdgeAmount[/b]（默认 0.25）：边框内缘周围的淡淡雾气。0 表示关闭。[/]
[][b]Passage / AllowAllItems[/b]（默认关闭）：允许矿石、金属和原版阻止的所有其他物品通过任何传送门。[/]
[][b]Passage / TakeFollowers[/b]（默认关闭）：跟随你的驯养动物会随你穿过传送门。[/]
[][b]Passage / ShortNearbyJump[/b]（默认开启）：短距离跳跃约需 2 秒。[/]
[][b]Passage / ServerTravelCheck[/b]（默认开启）：服务器在跳跃发生前进行检查。[/]
[][b]Menu / FilterNames[/b]（默认关闭）：界面中的传送门名称会经过游戏的文本过滤器。[/]
[][b]Menu / ListOnlyExplored[/b]（默认关闭）：界面仅列出其位置在你地图上的传送门。关闭则列出世界中的每个传送门。由每个玩家自行设置。[/]
[][b]菜单动画 / Enabled[/b]（默认开启）：边框的光芒、打开和关闭，以及选择目的地时的效果。关闭则显示静止、发光的边框。也会关闭传送门镜头飞行。[/]
[][b]菜单动画 / FollowWindowsSetting[/b]（默认开启）：当 Windows 的“在 Windows 中显示动画”关闭时（设置 > 辅助功能 > 视觉效果），菜单静止，传送门镜头飞行关闭。[/]
[][b]菜单动画 / Speed[/b]（默认 1）：菜单动画和传送门镜头飞行的速度。0.5 到 2。[/]
[][b]菜单动画 / AmbientGlow[/b]（默认 1.4）：界面打开时边框光芒起伏的程度。0 保持稳定。最高 1.5。[/]
[][b]菜单动画 / HoverGlow[/b]（默认 1.4）：悬停或选中行下方光芒的强度。0 表示无。最高 1.5。[/]
[][b]菜单动画 / Streaks[/b]（默认 1.4）：选择目的地时从行中延伸出的细光条纹的强度。0 表示无。最高 1.5。[/]
[][b]菜单动画 / TravellingLight[/b]（默认开启）：一道微弱的光沿边框的雕刻通道循环，约每 8 秒一圈。关闭则通道保持稳定。[/]
[/list]
在服务器上，四个 Passage 设置由服务器决定：加入的玩家使用服务器的值，其自身文件不会被更改。Mist、Alive、OpenRange、PortalZoom、两个 Arrival 设置、Menu 和菜单动画由每个玩家各自保留。

即使开启了 AllowAllItems，原版视为永远无法传送的物品（工具等级 1000 及以上）仍会被拒绝。


[size=4]兼容性[/size]

[list]
[]在 Valheim 1.0.21 上使用 BepInExPack Valheim 5.4.2351 测试，包括单人和一名玩家的专用服务器。[/]
[][b]与 XPortal 不兼容。[/b] 如果安装了 XPortal，Portal Network 将不会加载，因为两者都改变传送门的链接方式。安装 Portal Network 时，Valheim Community Patch 的传送门连接修复会退让（日志中会说明）。未检查其他传送门模组；启动时日志会列出其他修补相同传送门代码的模组，因此冲突会在那里显示。[/]
[]在服务器上，Portal Network 必须安装在服务器和每个客户端上。如果服务器上没有，选择界面会显示“服务器没有 Portal Network”，跳跃按原版工作。[/]
[/list]

[size=4]语言[/size]

目前文本仅支持英语。它位于 DLL 旁边的 [b]Translations/English.txt[/b]。要添加语言，复制该文件，按游戏对该语言的名称命名（例如 [b]German.txt[/b]），并翻译每个 [b]=[/b] 之后的部分。你省略的行会以英语显示。


[size=4]已知限制[/size]

[list]
[]在长距离跳跃期间，另一侧的图片是传送门窗口中使用的小图放大显示。在高分辨率下看起来会模糊。[/]
[]传送门镜头飞行不会模糊图片边缘或分离其颜色；它会扩大视野并闪烁青色。[/]
[/list]

[size=4]尚未测试[/size]

[list]
[][b]第二个真实玩家。[/b] 私人和共享传送门、向离线好友共享以及守卫访问仅在一名玩家的专用服务器上尝试过。没有其他人加入过运行它的服务器。[/]
[][b]用真实第二玩家看到他人到达。[/b] 服务器的“有人正在到达”消息已发送到真实连接的客户端（它到达了，且未发送给 136 米外的客户端或旅行者），但没有人从侧面观察过真实到达。[/]
[]跨平台玩家（他们的 ID 按 Steam ID 处理，但未尝试过）。[/]
[]锤子的放置界面本身。该部件通过游戏的放置函数放置，并通过锤子的移除调用移除；消耗的费用是游戏自身的。[/]
[]控制器和 Steam Deck。列表响应 D-pad 或左摇杆（移动）、A（选择）、X（断开连接）、Y（排序）和 B（关闭），但未尝试任何控制器。超宽屏也未尝试。[/]
[]Windows 的“在 Windows 中显示动画”开关实际关闭的情况，以及 [b]Speed[/b] 设置。[/]
[]英语以外的语言。[/]
[]通过尚未有另一侧图片的传送门进行跳跃。[/]
[]通过其他模组的跟随命令带驯养动物通过、一次超过两只动物，或属于另一玩家的动物。[/]
[/list]

[size=4]安装与卸载[/size]

使用模组管理器安装，或将 [b]CarturPortalNetwork.dll[/b] 和 [b]portalnetwork.bundle[/b] 复制到 [b]BepInEx/plugins/CarturPortalNetwork/[/b]。

要移除它：删除该文件夹。在此之前，拆除你建造的任何网络传送门，因为没有模组它们将不存在。模组移除后，游戏仅按名称链接传送门。你在选择界面上所做的每个链接都会丢失。同名传送门会以无人控制的顺序相互配对，因此如果有三个或更多同名传送门，其中一些会连接到错误的一个，而名称无其他传送门使用的传送门将无处可去。在移除模组之前，为你想保留的每对传送门赋予各自匹配的名称，并为其他每个传送门赋予没有其他传送门使用的名称。


[size=4]致谢[/size]

在 AI 协助下制作：代码、传送门模型及其纹理是使用 AI 工具根据作者提供的概念艺术制作的。选择界面周围的边框是作者提供的 AI 生成艺术作品，传送门音效和跳跃的三种声音使用 Stable Audio 3 Medium 生成（Powered by Stability AI；此 Stability AI 模型根据 Stability AI Community License 授权，Copyright © Stability AI Ltd. All Rights Reserved）。使用 BepInEx 和 HarmonyX 构建。与 Iron Gate 无关联或背书。