本指南将引导您在 Legion Hosting 上设置 Minecraft Java Edition 服务器——从选择服务器类型到配置您的世界以及与朋友连接。

1. 选择服务器类型

首次设置 Minecraft 服务器时，最重要的决定之一是选择运行哪种服务器软件。每种类型根据您需要插件、模组还是纯净原版体验，提供不同的功能。

服务器类型	最适合	插件支持	模组支持	备注
Vanilla	纯净、未修改的 Minecraft	无	无	官方 Mojang 服务器 JAR。除 server.properties 外无法自定义。
Paper	性能优化的生存/SMP	Bukkit & Spigot 插件	无	Spigot 的分支，包含大量性能补丁。推荐大多数服务器使用。
Spigot	基于插件的服务器	Bukkit & Spigot 插件	无	最早的高性能 Bukkit 分支。如今通常推荐使用 Paper 而非 Spigot。
Forge	模组化 Minecraft（大型模组包）	有限（部分通过 Sponge）	Forge 模组	经典模组加载器。客户端必须安装相同的 Forge 版本和模组。
Fabric	轻量模组化、较新的模组	有限	Fabric 模组	更快适配新 Minecraft 版本。模组生态系统不断增长。客户端需要 Fabric 和匹配的模组。

2. 首次启动

1. 登录 GPanel。
2. 从服务器列表中选择您的 Minecraft 服务器。
3. 导航到 Startup 选项卡。
4. 从下拉菜单中选择您想要的服务器类型（Paper、Vanilla、Forge 等）和 Minecraft 版本。
   重要：确保您选择的版本与玩家将要运行的版本一致。版本不匹配将导致客户端无法连接。
5. 在 Console 选项卡中点击 Start 首次启动服务器。
6. 首次启动将自动：
   • 下载所选服务器 JAR
   • 生成 server.properties、eula.txt 和其他默认配置文件
   • 生成初始世界（这可能需要一两分钟）
7. 当您在控制台中看到 Done! 时，您的服务器已运行并准备好进行配置。

3. 配置 server.properties

server.properties 文件控制服务器的大部分核心行为。您可以直接从 GPanel 的 File Manager 编辑它——在根目录中点击该文件即可打开内置编辑器。

属性	默认值	说明
server-name	A Minecraft Server	在服务器列表中显示的名称（仅限 Bedrock；Java 使用 motd 代替）。
gamemode	survival	新玩家的默认游戏模式。选项：survival、creative、adventure、spectator。
difficulty	easy	服务器难度。选项：peaceful、easy、normal、hard。
max-players	20	可同时连接的最大玩家数量。请将此设置为与您的托管计划的玩家槽位限制相匹配。
pvp	true	玩家是否可以互相伤害。设置为 false 以创建纯 PvE 服务器。
online-mode	true	通过 Mojang 验证玩家账户。请保持设置为 true，除非您有特殊原因需要禁用——禁用后将允许盗版客户端加入。
motd	A Minecraft Server	在 Java Edition 服务器列表中显示的每日消息。支持使用 \u00A7（分节符）的颜色代码。
view-distance	10	以区块为单位的渲染距离（1 区块 = 16 方块）。较低的值（6-8）可提高性能；较高的值（12-16）可提供更好的视觉体验，但需要更多内存和 CPU。
spawn-protection	16	世界出生点周围非管理员无法建造或破坏方块的半径（以方块为单位）。设置为 0 可禁用。
level-seed	（空白）	世界生成种子。留空使用随机种子，或输入特定种子来生成特定的世界。仅在创建新世界时生效。
level-type	minecraft\:normal	世界类型。选项：minecraft\:normal、minecraft\:flat、minecraft\:large_biomes、minecraft\:amplified、minecraft\:single_biome_surface。
white-list	false	当设置为 true 时，只有 whitelist.json 中列出的玩家可以加入。参见下方的白名单部分。
enable-command-block	false	是否可以使用命令方块。许多冒险地图和一些小游戏设置需要此功能。

编辑完成后，保存文件并启动服务器。新设置将在启动时立即生效。

4. 管理员（OP）权限

管理员（ops）可以使用服务器命令，如 /gamemode、/tp、/ban、/kick 等。有两种方式授予管理员身份。

方法一：GPanel 控制台（推荐）

在服务器运行时，从 GPanel 的 Console 选项卡中输入以下命令：

op YourPlayerName

您将在控制台中看到确认消息。该玩家现在是管理员了。

方法二：编辑 ops.json

您也可以手动编辑服务器根目录中的 ops.json 文件。每个条目如下所示：

[
  {
    "uuid": "player-uuid-here",
    "name": "YourPlayerName",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]

level 字段控制管理员可以执行的操作：

等级	权限
1	可以绕过出生点保护
2	可以使用作弊命令（/gamemode、/tp 等）和命令方块
3	可以使用玩家管理命令（/ban、/kick、/op）
4	完全访问权限，包括 /stop 和 /save-all

要移除管理员身份，使用控制台命令：

deop YourPlayerName

5. 白名单

白名单将您的服务器限制为仅允许已批准的玩家加入。这对于私人服务器或您想要控制谁可以加入的社区非常有用。

启用白名单

在 server.properties 中设置以下内容：

white-list=true
enforce-whitelist=true

enforce-whitelist 设置将在白名单重新加载时踢出任何当前连接但不在白名单中的玩家。

管理白名单

在服务器运行时，在 GPanel 控制台中使用以下命令：

命令	说明
whitelist add PlayerName	将玩家添加到白名单
whitelist remove PlayerName	从白名单中移除玩家
whitelist list	显示所有白名单玩家
whitelist reload	从 whitelist.json 重新加载白名单

6. 如何连接

服务器运行后，按照以下步骤从 Minecraft Java Edition 进行连接：

1. 在 GPanel 的 Network 选项卡中找到您服务器的 IP 地址和端口。
2. 打开 Minecraft Java Edition 并点击 Multiplayer。
3. 点击 Add Server。
4. 在 Server Name 字段中输入服务器名称（这只是您服务器列表中的标签）。
5. 在 Server Address 字段中，按以下格式输入您的 IP 和端口：

   your.server.ip:port

   例如：192.168.1.100:25565

6. 点击 Done，然后从列表中选择服务器并点击 Join Server。

7. 世界管理

世界保存位置

默认情况下，Minecraft 世界存储在服务器根目录中名为 world 的文件夹中。此文件夹包含所有世界数据，包括地形、玩家数据和结构。您还会看到 world_nether 和 world_the_end 文件夹用于这些维度（在 Paper/Spigot 服务器上；Vanilla 将它们作为 world 内的子文件夹存储）。

上传现有世界

要从单人游戏或其他服务器上传世界：

1. 在 GPanel 中停止您的服务器。
2. 使用 GPanel 的 File Manager（或通过 SFTP）删除或重命名现有的 world 文件夹。
3. 通过 SFTP 上传您的世界文件夹。确保文件夹命名为 world（或更新 server.properties 中的 level-name 属性以匹配您的文件夹名称）。
   提示：对于大型世界上传，SFTP 比基于浏览器的 File Manager 快得多。请参阅我们的 SFTP 指南了解设置说明。
4. 确保世界文件夹结构正确——level.dat 文件应直接位于 world 文件夹内，而不是嵌套在子文件夹中。
5. 启动服务器。它将加载您上传的世界。

备份

强烈建议定期备份您的世界，特别是在进行重大更改（如更新服务器版本或安装新模组/插件）之前。

要创建手动备份：

1. 在 GPanel 控制台中运行 save-all 以将所有数据写入磁盘。
2. 停止服务器。
3. 通过 SFTP 或 File Manager 下载 world 文件夹（以及 world_nether / world_the_end，如果存在的话）。
4. 将备份存储在计算机或云存储的安全位置。

---

相关文章

• 如何查找服务器 IP 和端口
• 如何通过 SFTP 上传文件