CDEV.PortalPins

[size=5][b]PortalPins[/b][/size]
[i]世界上的每一个传送门都会获得一个地图图钉——为每一位玩家，在任何地方，从它建成的那一刻起。[/i]

[line]

再也不用问“我们把通往沼泽的传送门放哪儿了？”。服务器知道世界上的每一个传送门，所以图钉是完整的：你从未到访过的传送门、朋友在你离线时建造的传送门，以及在你安装此模组很久之前就已存在的传送门。

[size=4][b]你能获得什么[/b][/size]
[list]
[][b]每个传送门上都有一个图钉[/b]，以传送门的标签命名（没有标签时为[i]Portal[/i]）。它在传送门建成几秒后出现，会跟随重命名，并随传送门一起消失。[/]
[][b]图钉名称以[/b] [b][/b] 开头，因此传送门图钉很容易与你自行放置的图钉区分。如果你不希望这样，可将 [b]NamePrefix[/b] 设为空值。[/]
[][b]这些图钉的行为与游戏自带的出生点图钉相同[/b]：它们不会被写入你的角色存档文件，左键点击不会划掉它们，右键点击不会删除它们，如果其他模组清除了它们，它们会在两秒内恢复。如果你想要安静，地图的图标过滤器仍可隐藏它们。[/]
[/list]
[size=4][b]传送门列表，位于命名窗口内[/b][/size]
与传送门交互，会打开常见的标签窗口——在名称字段正下方就是[b]世界上每一个传送门[/b]的列表：
[list]
[]你正站立的传送门排在最前，然后是[b]尚未配对[/b]的那些；[/]
[]右侧的图标表示传送门是否已连接：有配对时为[ b]白色[/b]，单独存在时为[b]红色[/b]。将指针悬停在上面，它会告诉你它与哪个传送门配对；[/]
[][b]两个已连接的传送门会绘制为一个块[/b]，左侧有一条竖条，因此一对传送门读起来像一个整体，而不是两行同名条目；[/]
[][b]点击一行[/b]即可将该名称写入字段——这正是游戏为两个传送门配对的方式；[/]
[][b]在字段中输入即可搜索[/b]列表。一个有五十个传送门的世界，只需一个词就能找到；[/]
[][b]每一行都有一个地图按钮[/b]：它会在地图上打开该传送门，放大显示，并让其图钉脉冲数秒。关闭地图后命名窗口会回来，并保留你已输入的文本；[/]
[]窗口打开期间列表会跟随服务器，因此其他人建造或重命名的传送门会自动出现在其中。[/]
[/list]窗口打开期间背景会变暗，鼠标滚轮会滚动列表而非缩放镜头。[b]ShowPortalList = false[/b] 会关闭整个列表。

[size=4][b]移除图钉（对所有人）[/b][/size]
默认关闭。启用服务器设置 [b]AllowRemoving[/b] 后，右键点击传送门图钉会[b]为服务器上的每一位玩家移除该图钉[/b]——传送门本身会保留，其在传送门列表中的条目也会保留。
[list]
[][b]AdminsOnly[/b]（默认开启）将该操作留给来自[i]adminlist.txt[/i]的管理员以及托管世界的人。[/]
[][b]ConfirmRemoval[/b]（客户端，默认开启）会先询问并说明即将发生什么。[/]
[]服务器会将其与世界一同记住，保存在[i]<world>.mod.portalpins.hidden[/i]中，因此重启后仍然有效。要恢复所有已移除的图钉，请在服务器停止时删除该文件。[/]
[/list]
[size=4][b]安装[/b][/size]
[b]此模组需要安装在服务器和每一位客户端上。[/b]只有服务器能看到世界上的每一个传送门；客户端只能接收其附近的内容。已安装此模组的服务器会拒绝未安装的客户端（Jötunn [i]ClientMustHaveMod[/i]），因此在那里游玩的每个人都需要它。
[list=1]
[]安装 [b]BepInExPack Valheim[/b]（5.4.2350 或更新）和 [b]Jötunn[/b]（2.30 或更新）。[/]
[]将 [b]CDEV.PortalPins.dll[/b] 放入 [i]BepInEx\plugins\CDEV.PortalPins\[/i] —— 在服务器上[b]以及[/b]每位玩家的游戏文件夹中。压缩包已经采用该布局：将其解压到 Valheim 文件夹即可。[/]
[]单人游戏无需额外操作：你自己的世界就是服务器。[/]
[/list]
[size=4][b]设置 —— BepInEx\config\cdev.portalpins.cfg[/b][/size]
[list]
[][b]AllowRemoving[/b]（服务器，仅管理员，同步，默认 [i]false[/i]）—— 右键点击会为每位玩家移除一个传送门图钉。[/]
[][b]AdminsOnly[/b]（服务器，仅管理员，同步，默认 [i]true[/i]）—— 只有管理员和主机可以移除图钉。[/]
[][b]ConfirmRemoval[/b]（客户端，默认 [i]true[/i]）—— 移除图钉前先询问。[/]
[][b]NamePrefix[/b]（客户端，默认 [i][/i]）—— 此模组每个图钉名称前的标记。[/]
[][b]ShowPortalList[/b]（客户端，默认 [i]true[/i]）—— 命名窗口内的传送门列表。[/]
[/list]两个服务器设置仅限管理员：Jötunn 会将它们发送给每一位客户端并在那里锁定，因此玩家无法自行开启移除功能。

[size=4][b]兼容性与开销[/b][/size]
[list]
[]Valheim 1.0、BepInEx 5.4.23、Jötunn 2.30。适用于专用服务器、玩家托管的世界以及单人游戏。[/]
[]服务器每两秒扫描一次其传送门列表，仅在发生变化时发送内容；一个大世界的列表只有几 KB。不会向你的角色写入任何内容。[/]
[]控制台（F5）中的 [b]pp_selftest[/b] 会在地图的一个偏远角落检查整个流程，并打印 PASS 或 FAIL，输出到控制台和 [i]BepInEx\LogOutput.log[/i]。[/]
[/list]
[size=4][b]致谢[/b][/size]
由 CDEV 为一个朋友的服务器编写。欢迎提交错误报告——请附上 [i]BepInEx\LogOutput.log[/i] 中对应的片段。

[b]许可证：MIT[/b] - [i]LICENSE[/i] 文件随压缩包一同分发。可以 fork、复用，如果我停止维护，请让它继续存活；只需注明它的来源即可。