Skip to content

开发环境搭建 ​

入驻前官方不发开发机,所有玩法都得先在本地跑通、调好,再提交审核。这一篇带你把本地服务端从零起起来,并装好写插件用的 IDE——这是后续所有开发的地基。

装 JDK ​

服务端是 Java 程序,先装对应版本的 JDK。版本按你目标服务端版本选,装错会直接起不来或崩:

服务端版本推荐 JDK
1.7.10 ~ 1.16.5JDK 8
1.17JDK 16(用 17 也可)
1.18 ~ 1.20.4JDK 17
1.20.5 ~ 1.21.10JDK 21

多版本共存

一台机器可能要同时维护多个版本的服务端。用 IDE 自带的 JDK 管理即可,不必在系统 PATH 里来回切。下载推荐 Adoptium(Temurin 发行版)。

选服务端核心 ​

MC 服务端生态复杂,先认清你要用哪一种:

核心本质适合
Vanilla(官服)Mojang 官方 ServerJar,无插件系统纯原版,几乎没人用于正式服
SpigotBukkit 的继承者,插件生态基础兼容性最广,但性能一般
PaperSpigot 的社区优化版,性能强纯插件服首选
CatServer / MohistSpigot + Forge 混合核心既要装 Mod 又要装插件

中国版上线只认这些

官方支持接入的核心为 Bukkit、Spigot、Paper、CatServer、Mohist。其中 Spigot 官网不直接发成品 jar,需用 BuildTools 自行编译,或从可信渠道获取。混合核心(CatServer/Mohist)当你需要同时跑 Forge Mod 和 Bukkit 插件时才用。

纯插件玩法 → 选 Paper;要混 Mod → 选 CatServer 或 Mohist。下文以 Paper 为例。

起第一个本地服 ​

1. 放置核心 ​

新建空目录(如 server/),把下载的 paper-<版本>.jar 丢进去。建议把 jar 重命名为 paper.jar,启动脚本写死这个名字省心。

2. 第一次启动 ​

在目录里开终端,跑:

bash
java -Xmx2G -jar paper.jar nogui
  • -Xmx2G:最大内存 2G,按机器调整,正式服通常给 4G~8G
  • nogui:不启图形控制台(服务器环境必备)

第一次启动会立即退出,并生成 eula.txt。打开它,把 eula=false 改成 eula=true 表示同意 Mojang EULA,再跑一次命令。

3. 关键配置 ​

第二次启动会生成一堆文件,其中 server.properties 是主配置。本地开发阶段至少改这几项:

配置项开发推荐值说明
server-port25565服端口,本地默认即可
online-modefalse开发必关,否则离线客户端无法连入
level-nameworld存档名,换地图就改它
gamemode00 生存 / 1 创造 / 2 冒险 / 3 旁观
max-players20本地随便

上线时务必改回

online-mode=false 只用于本地测试。上线服若关掉正版验证,会被认定为私服、无法通过审核。正式服必须 online-mode=true,认证由官方接口接管(见后续认证接入章节)。

4. 启动脚本 ​

每次手敲命令太累,写个脚本:

Windows(start.bat)

bat
@echo off
java -Xmx4G -jar paper.jar nogui
pause

Linux(start.sh)

bash
#!/bin/bash
java -Xmx4G -jar paper.jar nogui

以后双击 start.bat 或 sh start.sh 即可起服。看到 Done (...)! For help, type "help" 就说明起服成功。

连接验证 ​

打开 MC 客户端(版本要和服务端一致),多人游戏 → 直接连接 → 地址填 localhost(或 127.0.0.1)。

版本对不上?

客户端和服务端版本必须一致。1.7.10 服只能用 1.7.10 客户端连。若要跨版本,可装 ViaVersion 等插件,但开发期建议保持一致、少引入变量。

连进去能跑能放方块,本地环境就搭好了。后续写完插件,把 jar 丢进服务端目录下的 plugins/ 文件夹,重启即可加载。

装 IDE(为写插件做准备) ​

服务端能跑了,下一步是写插件。推荐 IntelliJ IDEA(社区版够用)+ Minecraft Development 插件:

  1. 装 IntelliJ IDEA
  2. 启动后 Settings → Plugins → Marketplace 搜 Minecraft Development,安装重启
  3. 新建项目时选 Bukkit/Spigot/Paper 模板,插件会自动配好 Gradle 或 Maven、自动拉对应版本的 API 依赖

不想用模板?

也可以手建 Maven/Gradle 项目,手动加 spigot-api 或 paper-api 依赖。但用模板省事得多,且能避免依赖版本写错。

至此:服务端能跑、IDE 就绪。下一篇讲对服务器进行功能配置,以及如何寻找现成插件——先用别人造好的轮子把玩法撑起来。

官方文档

服务端生态与选型详见 MC 的服务端介绍、准备开发环境。