12.3 我的世界（Minecraft）

Minecraft 是一款由 Java 语言开发的沙盒游戏，不同版本对 JDK 版本有特定要求（1.20.5+ 需 Java 21）。本节介绍 FreeBSD 上 OpenJDK 安装、启动器配置及服务器端部署。

12.3.1 桌面端

12.3.1.1 安装 OpenJDK

Minecraft 各版本要求的 JDK 版本不同：1.17 需要 Java 16，1.18 至 1.20.4 需要 Java 17，1.20.5 及以上版本需要 Java 21。经测试，JDK 21 可正常运行最新版 Minecraft。

使用 pkg 安装 OpenJDK 21：

# pkg install openjdk21

或者使用 Ports 安装 OpenJDK 21：

# cd /usr/ports/java/openjdk21/
# make install clean

12.3.1.2 Minecraft 客户端

FreeBSD 中有两种常见启动器，分别是 HMCL 和 Prism Launcher。Prism Launcher 可通过 FreeBSD Ports 获得，HMCL 只能手动下载 .jar 文件运行。

12.3.1.2.1 HMCL

HMCL（Hello Minecraft! Launcher）是一款用 Java 开发的 Minecraft 启动器，支持多版本管理和模组加载。

12.3.1.2.1.1 配置 HMCL

配置启动器前需先获取安装文件。

从 releases 页面下载最新的发行版。

打开终端执行命令，使用 Java 运行 HMCL 启动器的 JAR 文件：

$ java -jar HMCL*.jar

并非所有 Minecraft 版本都受支持，适配情况请参阅平台支持状态文档。其余设置与平台无关，关键配置包括 Java 路径设置、游戏目录选择和内存分配三项。

12.3.1.2.1.2 使用 HMCL 启动游戏

使用 HMCL 启动游戏的具体操作可参考下图。

FreeBSD 玩 Minecraft

12.3.1.2.2 Prism Launcher

Prism Launcher 是一款使用 C++ 和 Qt 框架开发的开源启动器。该启动器默认禁止离线登录，且限制绕过方法，仅推荐正版用户使用。

12.3.1.2.2.1 安装 Prism Launcher

使用 pkg 安装 Prism Launcher：

# pkg install prismlauncher

还可使用 Ports 安装 Prism Launcher：

# cd /usr/ports/games/prismlauncher/
# make install clean

12.3.1.2.2.2 配置 Prism Launcher

配置时需注意桌面环境的兼容性。

如果使用 KDE 桌面环境，需更新第三方软件包到最新版本。这是因为 KDE 桌面环境要求特定的 Qt 版本，Prism Launcher 依赖的 Qt 库需与系统库保持一致。

# pkg upgrade

否则可能无法启动，终端会提示 Qt 库版本不兼容或缺少符号等错误信息。

点击启动程序：

FreeBSD 运行 Minecraft

此处为语言设置，默认支持中文。

FreeBSD 运行 Minecraft

此处设置 Java 版本，保持默认设置即可。

FreeBSD 运行 Minecraft

外观设置，保持默认设置。

FreeBSD 运行 Minecraft

12.3.1.2.2.3 使用 Prism Launcher 启动《Minecraft》

启动程序后，可以看到 Prism Launcher 支持中文，但需要正版登录。

FreeBSD 运行 Minecraft

登录后下载最新版本的游戏。

注意
需要 Minecraft 正版账号才能登录游戏，可购买该游戏。

FreeBSD 运行 Minecraft

进入我的世界游戏。

FreeBSD 运行 Minecraft

进入游戏画面。

FreeBSD 运行 Minecraft

12.3.2 服务器端

搭建服务器需先安装 Java 运行环境，服务器端与客户端对 Java 版本的要求通常保持一致。

12.3.2.1 相关文件结构

/
├── etc/
│   └── rc.conf # 系统配置文件，包含 minecraft 服务配置
├── usr/
│   └── local/
│       ├── bin/
│       │   └── minecraft-server # Minecraft 服务器可执行文件
│       └── etc/
│           └── minecraft-server/ # Minecraft 服务器配置目录
│               ├── eula.txt # 用户协议文件
│               ├── java-args.txt # Java 参数配置
│               └── server.properties # 服务器配置文件
├── var/
│   ├── log/
│   │   └── minecraft-server/ # 日志和调试输出目录
│   └── db/
│       └── minecraft-server/ # 世界文件目录

12.3.2.2 安装 OpenJDK

值得指出的是，过旧的 JDK 版本不受服务器端支持，本节测试使用 JDK 21 可正常运行。

使用 pkg 安装 OpenJDK 21：

# pkg install openjdk21

或者使用 Ports 编译安装 OpenJDK 21，可针对服务器硬件优化：

# cd /usr/ports/java/openjdk21/
# make install clean

12.3.2.3 使用 Ports 或官方服务器程序

搭建 Minecraft 服务器有两种方式：

经过测试，Minecraft 官方服务器端是纯 Java 程序，在 FreeBSD 15.0 上安装 OpenJDK 后即可直接运行。Ports 版本则提供了 FreeBSD 特定的集成配置，包括服务管理脚本和默认配置文件。

也可使用 Ports 中提供的 games/minecraft-server：

# cd /usr/ports/games/minecraft-server/
# make install clean

查看配置信息：

# pkg info -D minecraft-server

运行服务器：

$ /usr/local/bin/minecraft-server

…………省略一部分…………

[15:52:21] [ServerMain/WARN]: Failed to load eula.txt
[15:52:21] [ServerMain/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

提示需同意许可协议，将 /usr/local/etc/minecraft-server/eula.txt 文件中的 eula=false 修改为 eula=true。

再次运行已安装的 Minecraft 服务器程序：

# /usr/local/bin/minecraft-server
Starting net.minecraft.server.Main
[15:54:47] [ServerMain/INFO]: Environment: Environment[sessionHost=https://sessionserver.mojang.com, servicesHost=https://api.minecraftservices.com, name=PROD]
[15:54:48] [ServerMain/INFO]: No existing world data, creating new world
[15:54:49] [ServerMain/INFO]: Loaded 1290 recipes
[15:54:49] [ServerMain/INFO]: Loaded 1399 advancements
[15:54:49] [Server thread/INFO]: Starting minecraft server version 1.21.1
[15:54:49] [Server thread/INFO]: Loading properties
[15:54:49] [Server thread/INFO]: Default game type: SURVIVAL
[15:54:49] [Server thread/INFO]: Generating keypair
[15:54:49] [Server thread/INFO]: Starting Minecraft server on *:25565
[15:54:50] [Server thread/INFO]: Using default channel type
[15:54:50] [Server thread/INFO]: Preparing level "world"
[15:54:53] [Server thread/INFO]: Preparing start region for dimension minecraft:overworld
[15:54:53] [Worker-Main-2/INFO]: Preparing spawn area: 2%
[15:54:54] [Worker-Main-2/INFO]: Preparing spawn area: 2%
[15:54:54] [Worker-Main-3/INFO]: Preparing spawn area: 2%
[15:54:55] [Worker-Main-1/INFO]: Preparing spawn area: 2%
[15:54:55] [Worker-Main-2/INFO]: Preparing spawn area: 18%
[15:54:56] [Worker-Main-1/INFO]: Preparing spawn area: 51%
[15:54:56] [Worker-Main-3/INFO]: Preparing spawn area: 51%
[15:54:56] [Server thread/INFO]: Time elapsed: 3317 ms
[15:54:56] [Server thread/INFO]: Done (6.876s)! For help, type "help"

按 Ctrl + C 中断程序运行。

在当前默认配置下，服务器启用了正版验证机制。该机制通过与 Mojang 会话服务器和 Microsoft 身份验证服务通信来验证玩家身份，非正版用户和未登录用户无法连接。如需在局域网或测试环境中使用，可关闭正版验证功能：在 /usr/local/etc/minecraft-server/server.properties 文件中，将 online-mode=true 修改为 online-mode=false 即可。该操作会降低服务器安全性，请在受控环境中使用。

然后再次运行已安装的 Minecraft 服务器程序：

# /usr/local/bin/minecraft-server
Starting net.minecraft.server.Main
[18:47:47] [ServerMain/INFO]: Environment: Environment[sessionHost=https://sessionserver.mojang.com, servicesHost=https://api.minecraftservices.com, name=PROD]
[18:47:51] [ServerMain/INFO]: Loaded 1337 recipes
[18:47:51] [ServerMain/INFO]: Loaded 1448 advancements
[18:47:51] [Server thread/INFO]: Starting minecraft server version 1.21.3
[18:47:51] [Server thread/INFO]: Loading properties
[18:47:51] [Server thread/INFO]: Default game type: SURVIVAL
[18:47:51] [Server thread/INFO]: Generating keypair
[18:47:51] [Server thread/INFO]: Starting Minecraft server on *:25565
[18:47:51] [Server thread/INFO]: Using default channel type
[18:47:52] [Server thread/WARN]: **** SERVER IS RUNNING IN OFFLINE/INSECURE MODE!
[18:47:52] [Server thread/WARN]: The server will make no attempt to authenticate usernames. Beware.
[18:47:52] [Server thread/WARN]: While this makes the game possible to play without internet access, it also opens up the ability for hackers to connect with any username they choose.
[18:47:52] [Server thread/WARN]: To change this, set "online-mode" to "true" in the server.properties file.
[18:47:52] [Server thread/INFO]: Preparing level "world"
[18:47:52] [Server thread/INFO]: Preparing start region for dimension minecraft:overworld
[18:47:53] [Worker-Main-5/INFO]: Preparing spawn area: 0%
[18:47:53] [Worker-Main-5/INFO]: Preparing spawn area: 0%
[18:47:53] [Worker-Main-5/INFO]: Preparing spawn area: 0%
[18:47:53] [Server thread/INFO]: Time elapsed: 1233 ms
[18:47:53] [Server thread/INFO]: Done (1.709s)! For help, type "help"
[18:48:34] [Server thread/INFO]: ykla[/127.0.0.1:37462] logged in with entity id 39 at (-1.5, 63.0, 1.5)
[18:48:34] [Server thread/INFO]: ykla joined the game

FreeBSD 运行 Minecraft

12.3.3 参考文献

Mojang Studios. Minecraft: Java Edition 1.20.5[EB/OL]. [2026-04-17]. https://www.minecraft.net/en-us/article/minecraft-java-edition-1-20-5. Minecraft 1.20.5 起要求 Java 21 和 64 位操作系统。
HMCL-dev. Hello Minecraft! Launcher[EB/OL]. [2026-04-17]. https://github.com/HMCL-dev/HMCL. HMCL 是一款开源跨平台 Minecraft 启动器，以 GPLv3 协议发布。

12.3 我的世界（Minecraft） ​

12.3.1 桌面端 ​

12.3.1.1 安装 OpenJDK ​

12.3.1.2 Minecraft 客户端 ​

12.3.1.2.1 HMCL ​

12.3.1.2.1.1 配置 HMCL ​

12.3.1.2.1.2 使用 HMCL 启动游戏 ​

12.3.1.2.2 Prism Launcher ​

12.3.1.2.2.1 安装 Prism Launcher ​

12.3.1.2.2.2 配置 Prism Launcher ​

12.3.1.2.2.3 使用 Prism Launcher 启动《Minecraft》 ​

12.3.2 服务器端 ​

12.3.2.1 相关文件结构 ​

12.3.2.2 安装 OpenJDK ​

12.3.2.3 使用 Ports 或官方服务器程序 ​

12.3.3 参考文献 ​

12.3 我的世界（Minecraft）

12.3.1 桌面端

12.3.1.1 安装 OpenJDK

12.3.1.2 Minecraft 客户端

12.3.1.2.1 HMCL

12.3.1.2.1.1 配置 HMCL

12.3.1.2.1.2 使用 HMCL 启动游戏

12.3.1.2.2 Prism Launcher

12.3.1.2.2.1 安装 Prism Launcher

12.3.1.2.2.2 配置 Prism Launcher

12.3.1.2.2.3 使用 Prism Launcher 启动《Minecraft》

12.3.2 服务器端

12.3.2.1 相关文件结构

12.3.2.2 安装 OpenJDK

12.3.2.3 使用 Ports 或官方服务器程序

12.3.3 参考文献