本指南将引导您连接到在 Legion Hosting 上托管的 Minecraft 服务器。涵盖 Java Edition、Bedrock Edition 和模组服务器——包括连接失败时的处理方法。

前提条件

• 在 Legion Hosting 上拥有一个活跃的 Minecraft 服务器
• 从 GPanel 获取您服务器的 IP 地址和端口（登录 gpanel.legionhosting.net，点击您的服务器，记下 Console 页面上显示的 IP:Port）
• 您的服务器必须处于 Running 状态才能让任何人连接
• 对于模组服务器：客户端需要安装相同的模组加载器（Forge 或 Fabric）和相同的模组

步骤 1 — 确认您的服务器正在运行

1. 登录 GPanel 并点击您的服务器。
2. 在 Console 选项卡上，检查面板右上方的状态指示器。
3. 它必须显示 Running。如果显示 Offline，请点击 Start 并等待服务器完成加载——原版服务器通常需要 30–90 秒，模组服务器需要更长时间。
4. 复制 Console 页面顶部附近显示的完整 IP:Port 地址（例如 192.0.2.10:25565）。

步骤 2 — 从 Java Edition 连接

1. 打开 Minecraft 启动器并启动 Minecraft: Java Edition。
2. 在主菜单中，点击 Multiplayer。
3. 点击 Add Server。
4. 在 Server Name 字段中，输入任何您喜欢的标签（例如 My Legion Server）。
5. 在 Server Address 字段中，粘贴从 GPanel 获取的完整 IP:Port 地址——例如 192.0.2.10:25565。
6. 点击 Done。服务器将出现在您的列表中。
7. 双击服务器条目（或选中后点击 Join Server）以连接。

步骤 3 — 从 Bedrock Edition 连接

Bedrock Edition 使用略有不同的流程，将 IP 和端口分成两个字段。

1. 打开 Minecraft: Bedrock Edition（Windows 10/11 版本、移动端、主机等）。
2. 在主菜单中，点击或轻触 Play。
3. 选择屏幕顶部的 Servers 选项卡。
4. 滚动到服务器列表底部，点击 Add Server。
5. 在 Server Name 字段中，输入任何您喜欢的标签。
6. 在 Server Address 字段中，仅输入 IP 部分（冒号之前的所有内容），例如 192.0.2.10。
7. 在 Port 字段中，仅输入冒号之后的数字，例如 19132。Bedrock 的默认端口是 19132，但您的服务器可能使用不同的端口——请查看 GPanel。
8. 点击 Save，然后点击服务器条目进行连接。

步骤 4 — 连接到模组服务器（Forge / Fabric）

模组服务器需要在客户端进行匹配的设置。连接过程本身与原版 Java Edition 相同，但客户端必须首先正确配置。

安装相同的模组加载器

1. 了解您的服务器使用哪个模组加载器——Forge 还是 Fabric——以及确切的版本号。您可以在 GPanel 的 Console 页面查看，或者询问服务器管理员。
2. 下载匹配的加载器安装程序：
   • Forge： files.minecraftforge.net
   • Fabric： fabricmc.net/use/installer
3. 运行安装程序。它会在 Minecraft 启动器中添加一个新的配置文件。
4. 打开 Minecraft 启动器，在启动前从配置文件下拉菜单中选择新的 Forge 或 Fabric 配置文件。

安装相同的模组

1. 获取与服务器上安装的完全相同的模组文件。模组名称、版本和 Minecraft 版本必须完全匹配。
2. 打开您的 Minecraft 模组文件夹：
   • Windows：按 Win + R，输入 %appdata%\.minecraft\mods，然后按 Enter。
   • macOS：打开 Finder，按 Cmd + Shift + G，然后输入 ~/Library/Application Support/minecraft/mods。
3. 将模组 .jar 文件复制到模组文件夹中。
4. 使用 Forge 或 Fabric 配置文件启动 Minecraft，然后按照步骤 2 中的相同步骤连接到服务器。

验证

按照上述步骤操作后，确认连接正常工作：

1. 点击 Join Server 后几秒钟内您应该会出现在游戏世界中。
2. 打开游戏内玩家列表（默认按键：Tab）——您的用户名应该出现在其中。
3. 对于模组服务器，通过检查游戏内是否有模组特有的物品、方块或菜单选项来确认模组已激活。
4. 如果您是服务器管理员，请返回 GPanel 并查看 Console 选项卡——您应该会看到类似 [Server thread/INFO]: YourUsername joined the game 的日志行。

故障排除

连接超时或被拒绝

• 确认 GPanel 中的服务器状态显示为 Running。如果正在启动，请等待它完全加载完毕。
• 仔细检查您复制的完整 IP:Port 是否包含端口号，且没有多余的空格。
• 尝试在多人游戏菜单中删除并重新添加服务器，以排除缓存的错误地址。
• 如果服务器刚刚启动或重启，请等待 1–2 分钟后重试。

多人游戏列表中显示"Can't connect to server"

当客户端完全无法到达服务器时会出现此消息。常见原因：

• 服务器处于离线状态——从 GPanel 启动它。
• 端口号错误——在 GPanel 的 Network 选项卡中验证确切端口。
• 您正在尝试用 Bedrock 连接 Java 服务器（或反过来）——它们不兼容。

被踢出并显示"You are not whitelisted on this server"

服务器启用了白名单模式。服务器管理员必须将您的 Minecraft 用户名添加到白名单中。在 GPanel 中，前往 Console 选项卡并运行命令 /whitelist add YourUsername。或者，使用 /whitelist off 完全禁用白名单。

连接界面显示模组不匹配错误

Minecraft 会显示服务器上存在但您客户端缺少的模组列表，或您拥有但服务器没有的模组。通过以下方式解决：

1. 将您的客户端模组文件夹与服务器的模组文件夹进行对比（可通过 GPanel 中的 SFTP 查看）。
2. 将缺少的模组添加到您的客户端，或移除多余的模组。
3. 确保客户端上的模组加载器版本与服务器完全匹配。

游戏版本错误

Minecraft 要求客户端和服务器运行相同的游戏版本。在 GPanel 中查看服务器运行的版本（可在 Console 启动日志中或服务器 egg 名称中查看），然后在连接前在 Minecraft 启动器中选择相同版本的配置文件。

Bedrock 玩家在好友选项卡中看不到服务器

Bedrock 中的好友选项卡仅显示 Realms 和本地发现的局域网服务器。对于托管服务器，玩家必须始终使用步骤 3 中描述的手动 Add Server 流程。服务器不会自动出现。