ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

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

如何用 Paperclip jar 完成 Paper 服务器的下载与首次运行 如何用 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.jarproject 为paper。方式二从源码构建 jarREADME.md How To (Compiling Jar From Source) 一节给出的完整步骤环境要求JDK 25 和互联网连接克隆本仓库在仓库根目录依次执行./gradlew applyPatches ./gradlew createPaperclipJar构建产物位于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.propertiesMain.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 JREPaper 启动时会做 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表