MineWiki
Java 版开服教程入门与首次开服

首次开服完整流程

用 Paper 在本机完成第一次可验证启动,再决定是否开放联机

这一页以 Minecraft Java 版的 Paper 服务端为例。目标很简单:先让服务端在本机稳定启动,确认世界、日志和关闭流程正常;公网联机留到后面处理。这样出了问题时,范围会小很多。

1

下载与游戏版本匹配的服务端

从 Paper 官方下载页获取 jar,并放进一个专门的空文件夹。

2

写启动脚本

脚本中的 jar 名称、Java 版本和内存参数必须与实际环境一致。

3

首次启动并确认 EULA

第一次运行会生成文件并要求接受 Minecraft EULA;这是正常流程,不是安装失败。

4

本机验证与安全关闭

控制台完成启动后先连接 localhost,再用 stop 关闭并确认世界已保存。

1. 下载并整理文件

Paper 官方下载页选择与你的客户端匹配的 Minecraft 版本和构建,下载 jar 文件。不要把服务端直接丢在下载目录或桌面;新建一个独立文件夹,例如 D:\MinecraftServer\~/minecraft-server/,把 jar 放进去。

Paper 的可用 Minecraft 版本和对应 Java 版本会变化。不要依赖“Paper 只支持某个版本以上”之类的旧说法;以 Paper 的当前入门文档和下载页为准。

2. 创建启动脚本

Windows 下,在与 jar 同一目录创建 start.bat。下面示例中的 paper.jar 必须改成你的实际文件名:

@echo off
java -Xms2G -Xmx4G -jar "paper.jar" --nogui
pause

Linux 下可以创建 start.sh

#!/usr/bin/env bash
set -euo pipefail
java -Xms2G -Xmx4G -jar "paper.jar" --nogui

然后执行 chmod +x start.sh,再用 ./start.sh 启动。-Xms 是初始堆内存,-Xmx 是最大堆内存;示例数值只适合小型起步服务器,请按内存规划和实际负载调整。--nogui 会关闭原版图形界面,命令行启动时推荐保留它。Paper 官方示例使用的也是这一写法。

3. 第一次启动与 EULA

运行脚本后,服务端会创建 eula.txt 等基础文件,并停止运行,控制台通常会提示:

You need to agree to the EULA in order to run the server.

打开 eula.txt,将 eula=false 改为 eula=true 并保存。这样做表示你同意 Minecraft EULA。随后再次运行脚本。

4. 本机验证

第二次启动后,服务端会生成世界和默认配置。控制台出现 Done 之类的“启动完成”信息后,在同一台电脑的客户端中添加服务器地址:

localhost

若你改过 server-port,则使用 localhost:端口。本机能进入,只能证明服务端和本机网络路径正常;它不能证明端口转发或内网穿透已经配置正确。

5. 常用控制台命令

命令用途使用建议
list查看在线玩家排查连接时确认服务端是否仍有响应。
op 玩家名授予 OP只给可信管理员;长期管理建议使用权限插件。
save-all请求保存世界可在维护或备份前执行,但不替代完整备份。
stop保存并正常关闭服务端日常关服应优先使用。

6. 启动失败时先看哪里

  1. 先打开 logs/latest.log;它通常比窗口里一闪而过的文字完整。
  2. UnsupportedClassVersionError:脚本调用的 Java 版本不符合服务端要求。
  3. Unable to access jarfile:脚本中的文件名或工作目录不对,注意 Windows 可能隐藏扩展名。
  4. Address already in usebind failed:端口已被占用,或 server-ip 填错。家用单服的 server-ip 通常应留空。Paper 官方排错指南也将这两项列为常见原因。
  5. 配置相关错误:先备份,再检查最近改过的文件;不要把删除 server.properties 当作第一反应。

7. 正确关闭服务端

在控制台输入 stop,等待进程自行退出。直接关闭窗口、断电或强制结束进程会增加未写完世界数据的风险。准备更新、装插件或大改配置前,请先按备份与恢复创建可还原的备份。

参考

On this page