NetherLink

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

NetherLink 是一款用于好友间联机游玩的 Minecraft 模组。它提供了好友界面、好友请求、在线状态共享以及基于 WebRTC 的加入功能，支持单人游戏世界和专用服务器。

默认后端为 NLI API v1，由 NetherLink 托管。它负责处理好友、在线状态、信令以及点对点连接流程所需的 TURN 凭据。

功能简介

添加了 NetherLink 好友界面，包含：
- 好友列表
- 好友请求
- 好友/API 设置
- 玩家头像
- 可加入的实例显示
允许通过 NetherLink 向好友开放单人游戏的集成服务器。
允许好友通过 WebRTC 点对点连接加入，当直接连接不可用时，自动回退到 TURN 中继。
支持专用服务器通过关联的 Minecraft 账号将自身发布为可加入的 NetherLink 实例。
支持在好友设置标签页中切换可用的链接后端。

客户端使用方法

在客户端安装 NetherLink。
启动 Minecraft 并使用 Microsoft/Minecraft 账号登录。
在主界面/多人游戏界面中打开好友按钮，管理好友和请求。
在单人游戏世界中，打开多人游戏分享界面。
选择 NetherLink 作为多人游戏范围并应用更改。

启用后，你的好友将能够通过 NetherLink 看到并加入该世界。世界仍由你的客户端托管，因此当你离开世界或停止分享后，世界将关闭。

首次使用 NLI 后端时，可能会显示当前服务条款。NLI 条款将从配置的后端获取，已接受的条款将存储在本地。

专用服务器使用方法

在服务器上安装 NetherLink。
可选：如果要使用自己的 Microsoft 身份验证应用 ID，请设置 NETHERLINK_CLIENT_ID。
启动服务器并运行：
```
/nli add
```
打开聊天或服务器控制台中显示的登录 URL，完成 Microsoft 身份验证，然后等待 NetherLink 存储 Minecraft 账号。
检查已配置的账号：
```
/nli list
```
通过已关联的账号发布服务器：
```
/nli publish
```

发布后，关联账号的好友将可以看到该服务器作为一个可加入的 NetherLink 实例。NetherLink 会接受传入的 WebRTC 加入请求，并将其路由到正在运行的服务器中。

服务器指令

/nli add 或 /netherlink add：通过设备码登录添加 Microsoft/Minecraft 账号。
/nli list：显示已配置的账号和令牌状态。
/nli refresh [all|<名称>]：刷新已存储的账号令牌。
/nli publish [all|<名称>]：发布服务器在线状态并开始接受 P2P 加入。
/nli revoke [all|<名称>]：撤销服务器在线状态并停止接受 P2P 加入。
/nli toggle <名称>：启用或禁用某个账号。
/nli remove <名称>：移除已存储的账号。

账号数据存储在 netherlink/accounts 目录下。请将这些文件视为凭据，不要公开分享。

配置

客户端配置存储在 config/netherlink/ 目录下。

config.json
- activeService：选定的后端，默认为 netherlink:nli_v1。
- instanceName：发布当前世界/服务器实例时使用的可选名称。
nli-v1.json
- server：NLI API 服务器 URL，默认为 https://nli-api.muyucloud.cool。
- acceptedTerms：本地记录的已接受 NLI 条款修订版本。

也可以从好友设置标签页更改活动后端。

备注

NetherLink 使用 Minecraft 账号身份信息来实现好友和在线状态功能。该模组及其配套的后端代码均为开源。
默认使用 NLI 托管的后端和 TURN 服务。
连接质量取决于双方的网络状况，但 TURN 中继回退机制应能使加入比纯 P2P 尝试更可靠。