跳到主要内容

下载和安装

本章节将指导你下载 Nukkit-MOT 并完成服务器的基本设置。

下载 Nukkit-MOT​

你可以从以下渠道获取最新版本的 Nukkit-MOT:

CI 构建提供两种 jar,运行的是同一个服务端:

  • Nukkit-MOT-SNAPSHOT.jar —— 完整构建,内置全部依赖,离线即可直接运行
  • Nukkit-MOT-SNAPSHOT-Lite.jar —— 体积小得多。首次启动时会自动将运行时依赖下载(带校验)到服务端目录下的 lib 文件夹,然后启动服务器,因此首次启动需要联网(下载源包含 Maven Central 和 repo.lanink.cn)。之后的启动会检测到已下载的依赖,直接启动
提示

不知道选哪个?使用完整的 Nukkit-MOT-SNAPSHOT.jar 即可。

说明

建议从 Jenkins CI 下载,访问速度更快且更稳定。

设置服务器​

创建服务器文件夹​

  1. 新建一个文件夹,例如 NukkitServer
  2. 将下载的 Nukkit-MOT-SNAPSHOT.jar 文件放入该文件夹

创建启动脚本​

为了方便启动服务器,我们需要创建一个启动脚本。

Windows 用户​

在服务器文件夹中新建文件 start.bat,内容如下:

@echo off
java -Xms1G -Xmx1G -jar Nukkit-MOT-SNAPSHOT.jar
pause

Linux/macOS 用户​

在服务器文件夹中新建文件 start.sh,内容如下:

#!/bin/bash
java -Xms1G -Xmx1G -jar Nukkit-MOT-SNAPSHOT.jar

然后赋予执行权限:

chmod +x start.sh
内存设置说明
  • -Xms1G: 设置初始内存为 1GB
  • -Xmx1G: 设置最大内存为 1GB
  • 可根据实际情况调整,例如 -Xmx2G 表示最大 2GB 内存

首次启动​

启动服务器​

  • Windows: 双击运行 start.bat
  • Linux/macOS: 在终端中运行 ./start.sh

等待初始化​

第一次启动时,服务器会:

  1. 自动生成配置文件 (server.properties 等)
  2. 创建默认世界
  3. 加载必要的资源

这个过程可能需要几分钟时间。

确认启动成功​

当你看到类似以下的提示时,表示服务器已成功启动:

[main] [INFO]: Done (xx.xxs)! For help, type "help"

关闭服务器​

首次启动成功后,建议先关闭服务器进行配置:

在控制台中输入:

stop

等待服务器完全关闭后,就可以进行配置了。

可选：Bin 数据文件​

如果你计划使用带有自定义方块功能的插件，需要下载 Bin 数据文件：

  1. 从 Bin_Data 仓库 下载
  2. 将 bin 文件夹放置到服务器根目录

你的服务器目录结构应该如下：

NukkitServer/
├── bin/                          ← 自定义方块必需
│   ├── vanilla_palette_xxx.nbt
│   └── ...
├── plugins/
├── worlds/
└── Nukkit-MOT-SNAPSHOT.jar
提示

如果你不使用任何需要自定义方块的插件，可以跳过此步骤。

可选：使用 Docker 运行​

作为上述手动搭建的替代方案，你也可以使用 Docker 运行 Nukkit-MOT：

docker run -d --name nukkit-mot \
  -p 19132:19132/udp \
  -p 19132:19132/tcp \
  -v $(pwd)/data:/data \
  -e JAVA_OPTS="-Xms2G -Xmx2G" \
  --restart unless-stopped \
  memoriesoftime/nukkit-mot:latest
  • :latest 和 :<短SHA> 是基于 master 分支构建的开发快照。
  • :1.26.30-R1 这种 tag 是与 Maven Central 对应的稳定发布版。
  • 所有 worlds、plugins、players、server.properties 都存放在 /data 卷下。

下一步​

服务器安装完成后，你可以继续 配置服务器 来自定义你的服务器设置。