企业官网建设流程全解析

如何用 Paperclip jar 完成 Paper 服务器的下载与首次运行

【免费下载链接】PaperThe most widely used, high performance Minecraft server that aims to fix gameplay and mechanics inconsistencies项目地址: https://gitcode.com/GitHub_Trending/pa/Paper

如果你的任务是搭一台 Paper Minecraft 服务器，起点就是拿到并运行 Paperclip jar。Paper 的 README.md 对服务器管理员的说明只有三句话：Paperclip 是"可以像普通 jar 文件一样下载和运行"的 jar；从官方下载页获取它；然后"直接在服务器上运行这个 Paperclip jar"。这篇文章把这条路径展开：如何获取这个 jar（官方下载或从本仓库源码构建）、首次运行时必须处理的 EULA 与配置文件、以及用启动日志判断服务器是否真正跑起来。

Paperclip 是什么

按 README.md 的 "How To (Server Admins)" 一节的原文：

Paperclip is a jar file that you can download and run just like a normal jar file.

也就是说你不需要额外的启动器或构建环境来运行正式服务器——一个 jar 文件即可。README 同时把详细使用文档指向 docs.papermc.io 文档站，本文只覆盖"下载 + 首次运行"这一环节。

当前仓库的版本线索：README 的版本徽章过滤条件为26.2.*，插件开发示例依赖为io.papermc.paper:paper-api:26.2.build.+，即当前主线对应 26.2 版本系列；1.8–1.21.3 的旧版本则被 README 指向 archive 仓库（README "Old Versions" 一节）。

获取 Paperclip jar

有两条文档给出的路径：从官方下载页获取（主路径），或从源码构建（可选分支，适合想验证构建流程或需要定制补丁的人）。

方式一：从官方下载页获取

README.md "How To (Server Admins)" 一节（第 19 行）提供了官方 downloads page 的链接，从该页面下载当前版本（26.2 系列）的 Paper jar 即可。下载得到的就是 Paperclip jar，文件名以页面上实际给出的为准，命名格式为paper-<version>-<build>.jar（该命名规则见 paper-server/build.gradle.kts 中 fill 插件的nameResolver配置："$project-$version-$build.jar"，project 为paper）。

方式二：从源码构建 jar

README.md "How To (Compiling Jar From Source)" 一节给出的完整步骤：

1. 环境要求：JDK 25 和互联网连接；
2. 克隆本仓库；
3. 在仓库根目录依次执行：

./gradlew applyPatches ./gradlew createPaperclipJar

4. 构建产物位于paper-server/build/libs目录。

CONTRIBUTING.md 对这一步的补充说明：

• Windows 下执行gradlew命令时去掉开头的./；
• Paper 构建需要 JDK 25，但借助 Gradle Toolchains 特性，仅安装 JRE 21+ 也可以构建（Gradle 找不到现成 JDK 25 时会自动配置）；
• 如果习惯用 Docker 编译，CONTRIBUTING 给出了 Adoptium 的eclipse-temurin镜像示例命令（该命令会拉取镜像并以$(pwd)挂载到容器/data，属网络下载副作用，仅在确认可用时使用）：

# docker run -it -v "$(pwd)":/data --rm eclipse-temurin:25.0.2_10-jdk bash

构建完成后，仓库提供 Gradle 任务来验证这个 jar 本身可运行：runPaperclip任务的描述是 "Spin up a test server from the Mojang mapped Paperclip jar"（见 paper-server/build.gradle.kts）。在仓库根目录执行：

./gradlew runPaperclip

它直接用刚构建出的 Paperclip jar 拉起一个测试服务器，适合在部署到目标机器前先确认 jar 没有问题。

首次运行

运行 jar

把下载或构建得到的 jar 放到服务器目录后，按 README 的说法直接运行——"Run the Paperclip jar directly from your server. Just like old times." README 没有给出固定命令行，因为它声明该 jar 与普通 jar 用法一致；按此说明，通用运行命令为：

java -jar paper-<version>-<build>.jar

其中paper-<version>-<build>.jar替换为你实际下载/构建出的文件名。运行所需的 Java 版本，本仓库文档没有针对"运行已下载 jar"单列要求（JDK 25 / JRE 21+ 的说明只针对源码构建），实际以你机器上已安装的 Java 为准；启动时若 Java 环境有问题，日志会给出明确报错（见下文"启动失败时看什么"）。

处理 EULA（首次运行必过的一关）

首次启动时服务器会检查eula.txt。如果你还没有同意 Mojang 的 EULA，服务器不会启动，启动日志输出：

You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

然后进程直接退出。这是正常的预期行为，不是故障。按eula.txt文件内自带的说明完成同意操作后，再次运行 jar 即可。

Paper 在此处有一个扩展（来源：Main.java.patch 中启动逻辑的 Paper 改动）：可以通过系统属性-Dcom.mojang.eula.agree在命令行上直接表示同意 EULA，例如：

java -Dcom.mojang.eula.agree -jar paper-<version>-<build>.jar

使用此属性时服务器会在日志中输出警告：它代表你已表示同意 Mojang EULA，如果你实际不同意，需要停止服务器并移除该属性。是否使用它取决于你的部署方式；常规做法仍然是直接编辑eula.txt。

server.properties 与世界生成

EULA 通过之后，服务器读取工作目录下的server.properties（Main.java.patch 中为Paths.get("server.properties")，并会对该配置执行forceSave()回写）。

如果你只想先让服务器生成初始配置文件再退出，可以传启动选项initSettings。补丁中对该选项的说明原文是 "Initializes 'server.properties' and 'eula.txt', then quits"，即初始化这两个文件后退出，成功后日志输出：

Initialized 'server.properties' and 'eula.txt'

首次启动一个不存在的存档时，如果工作目录里没有已有世界数据，日志会输出：

No existing world data, creating new world

看到这一行，说明服务器已经开始创建新世界，首次运行流程走到这里即算完成。

启动失败时看什么

以下现象均来自 Main.java.patch 中记录的启动逻辑，日志文本可按原文对照：

• EULA 未同意：输出 "You need to agree to the EULA in order to run the server. Go to eula.txt for more info." 后退出。解决方式见上文"处理 EULA"。

• headless JRE：Paper 启动时会做 headless JRE 检测。如果你使用的 JRE 发行版缺少 Minecraft 服务器所需的图形库，日志输出错误：

  You are using a headless JRE distribution. This distribution is missing certain graphic libraries that the Minecraft server needs to function.

  日志会指引你去 docs.papermc.io 上的 java-install 页面（README 指向的文档站）按说明安装非 headless 的 JRE。

• 世界升级参数：补丁明确标注世界升级与 region 文件重建尚未实现，传入forceUpgrade或recreateRegionFiles选项时服务器会报错退出，日志原文为 "World upgrade and region file recreation are not yet implemented in Paper 26.1."。首次运行新服务器不需要这两个选项，遇到此报错说明启动参数用错了。

限制与下一步

• 本仓库文档没有给出"运行已下载 jar"所需 Java 版本的独立说明，构建要求（JDK 25 / JRE 21+ toolchain）不能直接套用到运行场景；Java 环境不满足时以上文的 headless JRE 日志判断为准。
• 首次运行完成后，服务器配置、插件管理等后续使用内容在 README 指向的 docs.papermc.io 文档站中，本文不展开。
• 如果你需要 1.8–1.21.3 旧版本，按 README.md "Old Versions" 一节前往 archive 仓库，本文步骤仅适用于当前主线（26.2 系列）的 Paperclip jar。

【免费下载链接】PaperThe most widely used, high performance Minecraft server that aims to fix gameplay and mechanics inconsistencies项目地址: https://gitcode.com/GitHub_Trending/pa/Paper