Purpur：可高度配置的 Paper 兼容 Minecraft 服务器端安装与迁移教程

获取下载链全程约 1 分钟

1. 打开微信，搜索「软件教程管家」关注，或长按下方二维码关注
2. 回复关键词 Purpur 复制关键词
3. 公众号自动回复网盘链接，点击即可保存下载

打开微信扫一扫关注
或搜索【软件教程管家】

官方渠道：GitHub 仓库

30 秒速读：Purpur 是 Paper 的直接替代实现，给 Minecraft Java 服务器用的服务端程序，最大卖点是可配置程度远超原版 Paper。插件生态与 Paper、Spigot、Bukkit 互通，已有 Paper 服基本可以平替换 jar 迁移；新开服直接用最新版 26.3。本文讲清版本怎么选、第一次启动怎么做、装完先改哪几处配置。

Purpur 软件信息

Purpur 是什么：Paper 的可配置替代品

Purpur 定位很明确：它不是新写一个服务端，而是基于 Paper 生态的服务端实现，主打两点——更细的服务器行为配置，以及一批 Paper 原生没有的玩法功能。你的 Paper 插件、Spigot 插件和 Bukkit 插件原则上都能继续用，世界存档、权限数据也不用转换格式。对服主来说，它解决的是 Paper“想调的东西调不动”的痛点，而不是推倒重来。

对应的代价也要先说明：Purpur 的额外玩法功能会改变部分默认行为，改配置之前不知道它动了什么，就等于给全服玩家埋了个未知数。所以这篇的安装步骤之后，重点放在“装完先改哪几处、每次只动一类、改完先在测试环境验证”这个工作流上。

版本选择：新服跟最新版，老服先核插件

推荐：新服直接上 26.3；已有 Paper 服想迁，先在测试服把 26.3 与现有插件组合跑一遍，确认无报错再动生产服。下载只认两个官方出口：Purpur 官网下载页，或官方下载 API（api.purpurmc.org/v2/purpur/版本号/latest/download），不要从第三方搬运站下 jar 包。

Purpur 安装步骤（以 Linux / Windows 通用流程为准）

1. 装 Java：按目标版本装对应 Java（1.21.x 用 Java 21），装完用 java -version 确认版本号，别等启动报错才发现装错大版本。
2. 建空文件夹：给服务器单独建一个空目录，所有文件都放里面，不要和别的服务端混在一个目录。
3. 下载 jar 包：从官网下载页或下载 API 拿对应版本的最新构建，改名保存为 purpur.jar，放到刚建的目录里。
4. 第一次启动：在该目录执行 java -jar purpur.jar nogui（生产服建议加内存参数，见下一节）。首次运行会生成配置文件与世界文件，然后停下来提示你同意 EULA。
5. 同意 EULA：打开生成的 eula.txt，把 eula=false 改成 eula=true 保存。这是 Minecraft 服务端的强制步骤，不改会一直起不来。
6. 再次启动：重新执行启动命令，看到 Done 提示即启动完成；本地测试用 localhost:25565 进服，确认能正常进入再往下配。
7. 放行端口：需要外网玩家进服时，在服务器防火墙与路由器上放行 25565 端口（TCP），只给熟人玩就先开白名单，别直接裸奔公网。

装完必改设置：5 处按顺序调

1. 启动内存参数：把启动命令写成 java -Xms4G -Xmx4G -jar purpur.jar nogui，起步给 4G；玩家与插件多了再按实际占用往上加。Xms 与 Xmx 设成一样，避免运行中反复扩容抖动。
2. server.properties 核心项：文件在服务器目录下，改这几项——online-mode=true（只要正版验证就保持 true，改 false 等于放行盗版登录）；max-players 按机器与带宽定，别贪多；view-distance 与 simulation-distance 先设 10，卡了再往下调；spawn-protection 按需设，OP 自己建家就把它改成 0。
3. purpur.yml 主配置：这是 Purpur 区别于 Paper 的核心文件，第一次启动后生成。按分类逐项看，只开你理解的那一项：生物、方块、玩家机制各有独立小节，改一类、重启、进服验证，再改下一类。
4. 白名单与 OP：server.properties 里开 white-list=true，配合 whitelist.json 管进服名单；OP 权限用 op 命令单独给，不要图省事给所有人。
5. 备份计划：第一次成功启动后，立刻把世界文件夹、purpur.yml、server.properties 与插件目录整体备份一次；之后每次改配置或升级前都先备份，养成固定动作。

从 Paper 迁移到 Purpur：四步平替

1. 全量备份：停服后把整个 Paper 服务器目录复制一份，世界、插件、配置一个都不能少。
2. 替换 jar 包：把 paper.jar 换成同版本的 purpur.jar，启动脚本里的文件名同步改掉，其余目录结构原样保留。
3. 测试服先跑：先在测试服启动，逐个检查核心插件是否正常加载、权限是否生效、出生点与世界是否完好，报错的插件先隔离再处理。
4. 上线后观察：正式切过去后头几天留意 TPS 与玩家反馈，Purpur 的额外玩法功能如果与老插件打架，优先在 purpur.yml 里关掉对应项，而不是删插件。

注意事项：6 个常见坑

1. Java 大版本装错最常见：启动直接报 UnsupportedClassVersionError 基本就是 Java 版本不对，对照目标 Minecraft 版本重装 Java，不要改 jar 包。
2. EULA 没同意会反复停：第一次启动后必须把 eula.txt 改成 true 再启动，只改 server.properties 没用。
3. 插件不兼容先隔离：某个插件报错就先把它移出 plugins 文件夹再启动，确认是它的问题再去找替代品，不要同时动多个插件，定位会乱。
4. 不要在生产服直接升级：升 Purpur 版本或 Minecraft 版本前，先在测试服把世界与插件组合跑通，确认无丢数据、无报错再上生产服。
5. 配置文件改前备份：purpur.yml、server.properties、bukkit.yml 改之前各复制一份，改崩了能秒回滚。
6. 公网开服先想安全：正版验证、密码强度、OP 名单、端口只开必需的——开服第一天就被盗号或刷服，比任何配置问题都贵。

适合谁，不适合谁

适合：已经跑在 Paper 生态上、想要更细配置与玩法扩展的服主与社区运营者；愿意花时间读配置、做测试服验证的团队；以及想在 Paper 兼容基础上定制玩法的插件开发者。

不适合：只想“装完就能玩”、不想碰任何配置文件的纯玩家——这类需求直接用原版服务端或开个 Realms 更省事；以及插件强依赖原版行为、一个配置偏差就全服报错的特殊服，迁移前必须逐项核对。

前往 GitHub 查看 Purpur

正式构建见 Purpur 官网下载页，或用官方下载 API 拉取对应版本的最新构建。

GitHub 国内访问较慢，如打不开可多刷新几次

一句话总结：Purpur 就是“Paper + 更细的配置权”。插件生态不用换，世界不用转，代价是多一份读配置、做验证的功课。愿意做这份功课，它就是目前 Paper 生态里定制自由度最高的服务端之一。

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

学习教程Paper Pal论文审阅工具下载|跨平台（LaTeX 本地 AI）下载器JDownloader2打不开/启动失败？Java环境问题排查指南开发WordPress 7.1.3 中文版下载｜开源网站搭建程序下载器JDownloader2 免费下载开发Neovim v0.12.6 中文版下载｜可高度定制启动器uTools 7.8.0 中文版下载