本指南将引导您连接到在 Legion Hosting 上托管的 Minecraft 服务器。涵盖 Java Edition、Bedrock Edition 和模组服务器——包括连接失败时的处理方法。
前提条件
- 在 Legion Hosting 上拥有一个活跃的 Minecraft 服务器
- 从 GPanel 获取您服务器的 IP 地址和端口（登录 gpanel.legionhosting.net，点击您的服务器，记下 Console 页面上显示的
IP:Port） - 您的服务器必须处于 Running 状态才能让任何人连接
- 对于模组服务器：客户端需要安装相同的模组加载器（Forge 或 Fabric）和相同的模组
Java 与 Bedrock： Java Edition 和 Bedrock Edition 原生不兼容。Java 服务器只接受 Java 客户端，Bedrock 服务器只接受 Bedrock 客户端。但是，Java 服务器可以使用 Geyser 等模组允许 Bedrock 玩家连接。如果您需要跨版本支持，请在 Java 服务器上安装 Geyser 插件。
步骤 1 — 确认您的服务器正在运行
- 登录 GPanel 并点击您的服务器。
- 在 Console 选项卡上，检查面板右上方的状态指示器。
- 它必须显示 Running。如果显示 Offline，请点击 Start 并等待服务器完成加载——原版服务器通常需要 30–90 秒，模组服务器需要更长时间。
- 复制 Console 页面顶部附近显示的完整
IP:Port地址（例如192.0.2.10:25565）。
步骤 2 — 从 Java Edition 连接
- 打开 Minecraft 启动器并启动 Minecraft: Java Edition。
- 在主菜单中，点击 Multiplayer。
- 点击 Add Server。
- 在 Server Name 字段中，输入任何您喜欢的标签（例如 My Legion Server）。
- 在 Server Address 字段中，粘贴从 GPanel 获取的完整
IP:Port地址——例如192.0.2.10:25565。 - 点击 Done。服务器将出现在您的列表中。
- 双击服务器条目（或选中后点击 Join Server）以连接。
请包含端口号。 如果您的端口不是默认的 25565，您必须输入完整的
IP:Port 格式。仅输入 IP 地址将导致连接失败，因为 Minecraft 默认会尝试连接端口 25565。
步骤 3 — 从 Bedrock Edition 连接
Bedrock Edition 使用略有不同的流程，将 IP 和端口分成两个字段。
- 打开 Minecraft: Bedrock Edition（Windows 10/11 版本、移动端、主机等）。
- 在主菜单中，点击或轻触 Play。
- 选择屏幕顶部的 Servers 选项卡。
- 滚动到服务器列表底部，点击 Add Server。
- 在 Server Name 字段中，输入任何您喜欢的标签。
- 在 Server Address 字段中，仅输入 IP 部分（冒号之前的所有内容），例如
192.0.2.10。 - 在 Port 字段中，仅输入冒号之后的数字，例如
19132。Bedrock 的默认端口是19132，但您的服务器可能使用不同的端口——请查看 GPanel。 - 点击 Save，然后点击服务器条目进行连接。
Bedrock 无法原生连接 Java。 如果您不确定服务器运行的是哪个版本，请在 GPanel 中查看 egg 类型。Java 服务器可以使用 Geyser 等模组来接受 Bedrock 玩家——如果没有桥接模组，Bedrock 客户端无法加入 Java 服务器，反之亦然。
步骤 4 — 连接到模组服务器（Forge / Fabric）
模组服务器需要在客户端进行匹配的设置。连接过程本身与原版 Java Edition 相同，但客户端必须首先正确配置。
安装相同的模组加载器
- 了解您的服务器使用哪个模组加载器——Forge 还是 Fabric——以及确切的版本号。您可以在 GPanel 的 Console 页面查看，或者询问服务器管理员。
- 下载匹配的加载器安装程序：
- Forge： files.minecraftforge.net
- Fabric： fabricmc.net/use/installer
- 运行安装程序。它会在 Minecraft 启动器中添加一个新的配置文件。
- 打开 Minecraft 启动器，在启动前从配置文件下拉菜单中选择新的 Forge 或 Fabric 配置文件。
安装相同的模组
- 获取与服务器上安装的完全相同的模组文件。模组名称、版本和 Minecraft 版本必须完全匹配。
- 打开您的 Minecraft 模组文件夹：
- Windows：按 Win + R，输入
%appdata%\.minecraft\mods，然后按 Enter。 - macOS：打开 Finder，按 Cmd + Shift + G，然后输入
~/Library/Application Support/minecraft/mods。
- Windows：按 Win + R，输入
- 将模组
.jar文件复制到模组文件夹中。 - 使用 Forge 或 Fabric 配置文件启动 Minecraft，然后按照步骤 2 中的相同步骤连接到服务器。
模组不匹配将导致无法加入。 如果客户端的模组或模组加载器版本与服务器不同，Minecraft 将在连接界面显示错误信息，列出缺失或不匹配的模组。在不匹配问题解决之前，您将无法连接。
验证
按照上述步骤操作后，确认连接正常工作：
- 点击 Join Server 后几秒钟内您应该会出现在游戏世界中。
- 打开游戏内玩家列表（默认按键：Tab）——您的用户名应该出现在其中。
- 对于模组服务器，通过检查游戏内是否有模组特有的物品、方块或菜单选项来确认模组已激活。
- 如果您是服务器管理员，请返回 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 会显示服务器上存在但您客户端缺少的模组列表，或您拥有但服务器没有的模组。通过以下方式解决：
- 将您的客户端模组文件夹与服务器的模组文件夹进行对比（可通过 GPanel 中的 SFTP 查看）。
- 将缺少的模组添加到您的客户端，或移除多余的模组。
- 确保客户端上的模组加载器版本与服务器完全匹配。
游戏版本错误
Minecraft 要求客户端和服务器运行相同的游戏版本。在 GPanel 中查看服务器运行的版本（可在 Console 启动日志中或服务器 egg 名称中查看），然后在连接前在 Minecraft 启动器中选择相同版本的配置文件。
Bedrock 玩家在好友选项卡中看不到服务器
Bedrock 中的好友选项卡仅显示 Realms 和本地发现的局域网服务器。对于托管服务器，玩家必须始终使用步骤 3 中描述的手动 Add Server 流程。服务器不会自动出现。
