Ngrok LAN

弃用公告

此项目已不再积极维护。

由于开发团队人手有限，我们很遗憾不得不暂停此项目的开发，感谢您的理解。

我们推荐使用 e4mc 等替代方案，它们提供类似的功能。

感谢您的支持 🙂

此致，
Alujjdnd/Flooflez

Ngrok LAN

需要帮助！

我们正尝试将此模组移植到 QuiltMC，非常感谢已经作出贡献的朋友！不过，我们希望 Quilt 专用的配置前置库能尽快推出。由于我们的模组需要编辑配置文件，我们希望让用户尽可能轻松地完成这一过程。

简介

Ngrok LAN 是一个 Fabric 模组，可让你与世界各地的朋友共享单人游戏地图，只需
点击新的“开放公共服务器”按钮即可！此模组使用 Ngrok 这项免费服务来简化服务器的创建，并将其作为主要服务，通过“隧道”将你的连接接入互联网；
点击“开放公共服务器”后，它还会生成一个链接，供你的朋友连接。

想进一步了解 Ngrok-LAN 的工作原理，请查看什么是 Ngrok。

安装/快速开始

依赖项

此模组需要以下模组：

• Fabric Loader & Fabric API
• ClothConfig API
• 模组菜单

安装 Fabric Loader 和 Ngrok-LAN

1. 前往 FabricMC 网站，下载最新的安装程序。
2. 运行 JAR 文件，随后会弹出一个窗口。选择正确的 Minecraft 版本和加载器（此模组目前需要 Minecraft v1.18.2 和加载器 v0.13.3），然后点击“Install”。
3. 启动器菜单中会创建一个新的游戏版本和配置文件，你现在可以用它启动 Fabric。
4. 将模组 JAR 文件（可在发布版本中获取），以及 ClothConfig API 和 ModMenu 的 JAR 文件放入“mods”文件夹。（上一节中已将 Fabric API JAR 文件放入你的 mods 文件夹）
5. 运行第 3 步中安装的配置文件，Ngrok LAN 就会加载。

配置 Ngrok-LAN

| 选项 | 说明 |
|—————————–|——————————————————————————————————————————————–|
| “启用？” | 启用或禁用此模组，以便设置是否通过 Ngrok 共享地图 |
| “Ngrok 身份验证令牌” | 在此输入你的 Ngrok 身份验证令牌，参见获取身份验证令牌 |
| “区域” | 在此选择要使用的 Ngrok 数据中心区域；选择离你最近的区域，以尽量降低延迟 |
| “需要身份验证”| 勾选此框将以在线模式启动服务器。若未勾选，则以离线模式启动服务器。此选项主要用于其他玩家使用非正版 Minecraft 账号的情况。 |
| “出生点保护半径”| 防止未获得管理员权限的玩家在出生点 X 格范围内破坏或放置方块 |

Ngrok 区域

| 代码 | 区域 |
|—-|—————|
| US | 美国 |
| EU | 欧洲 |
| AP | 亚洲/太平洋 |
| AU | 澳大利亚 |
| SA | 南美洲 |
| JP | 日本 |
| IN | 印度 |

启动 Ngrok LAN

1. 确保已启用 Ngrok LAN、身份验证令牌有效，并且已选择正确的区域
2. 打开一个新的单人游戏世界，然后点击“对局域网开放”
3. 配置游戏模式以及是否允许作弊
4. 点击“开放公共服务器”
5. 聊天栏中应显示消息“Ngrok 服务已成功启动”，并附有一个黄色高亮的链接

• 如果没有，请查看下方的常见问题

1. 链接会自动复制到剪贴板，现在可以分享给朋友
2. 其他玩家只需将此链接作为服务器 IP 添加到多人游戏列表中，然后加入世界即可

获取 Ngrok 身份验证令牌

1. 访问 https://ngrok.com/，注册一个新的免费账户
2. 在控制面板左侧菜单中，点击 Getting Started > Your Auth Token
3. 复制身份验证令牌，并将其填入 Ngrok LAN（不要与他人分享此令牌）

命令

| 命令 | 说明 |
|——————–|——————————————————|
| /op <username> | 授予指定玩家服务器管理员权限。 |
| /deop <username> | 移除指定玩家的服务器管理员权限。 |
| /whitelist add <username> | 将玩家档案添加到白名单。玩家无需在线。 |
| /whitelist on | 启用服务器白名单。 |
| /whitelist off | 禁用服务器白名单。 |
| /whitelist remove | 将玩家档案从白名单中移除。玩家无需在线。 |
| /whitelist list | 显示白名单中的所有玩家档案。 |
| /whitelist reload <username> | 从磁盘重新加载 whitelist.json 中的玩家档案列表（当 whitelist.json 在 Minecraft 外部被修改时使用）。 |

常见问题

| 错误消息 | 解决方法 |
|————————————————————————————–|————————————————————————————————————————————————————|
| 尝试以访问权限禁止的方式访问套接字。 | 在“服务”程序中重启“Host Network Service” |
| 指定的 authtoken 看起来不是有效的 ngrok 隧道 (ERR_NGROK_105) | 检查身份验证令牌是否有效，以及是否已正确填入模组配置 |
| 你的账户限制了同时运行的 ngrok 代理会话数量…… | 检查是否正在使用此身份验证令牌运行其他隧道；如果仍然遇到此错误，请尝试切换区域 |

• 如需了解更多错误、错误代码及其解决方法，请查看Ngrok 文档

其他问题

请在问题反馈区提交新问题

什么是 Ngrok？

Ngrok 是一项免费服务，无需进行端口转发，即可将本地运行的应用程序开放给互联网访问。
通常，设置 Minecraft 服务器时，你必须启动服务器，并通过路由器“转发”端口。端口转发会将服务器“发布”到互联网上，因此任何知道你 IP 地址的人都可以加入。你可以把它想象成路由器将服务器（位于本地网络中）发出的网络数据包“转发”给朋友（位于更广阔的互联网中）。

不过，使用 Ngrok 时，我们不需要转发端口。所有互联网流量都会先经过一个应用程序（此处为
Ngrok-LAN），再经由 Ngrok 的数据中心传输。作为回报，Ngrok 会提供一个链接，我们可以把它发给朋友，让他们连接到服务器。你无需进行其他配置——只要能连接互联网并拥有 Ngrok 账户，就可以把单人游戏世界开放给全球各地的朋友。

Ngrok 账户要求

此模组只需要一个免费的 Ngrok 账户。Ngrok 免费套餐允许你同时拥有 1 条免费的在线隧道，这意味着使用一个 Ngrok 免费账户，同一时间只能托管 1 个 Ngrok-LAN 服务器。
付费套餐允许你使用自定义域名并同时开启更多在线隧道，但此模组尚不支持自定义域名。

更多定价信息请参阅 Ngrok 官方网站

已知不兼容项

请参阅 不兼容项列表，查看不兼容的模组。

目前，只有近距离语音聊天模组不兼容。这个问题不太可能得到修复。

待办事项

• 移植到 QuiltMC（欢迎联系我们并提供帮助！）
• 1.17.1 版本
• 1.19 版本

许可证

此模组采用 MIT 许可证。