导入服务器与整合包

你电脑上还留着一个开了一半的 Paper 服，存档、插件、白名单都在里面；或者朋友在群里发来一个 .mrpack 整合包，说“装上就能玩”。你不想从零再配一遍，也不想在手机上把几十个文件重传一次。把这些现成的东西搬进 Minexa，就是「导入服务器」要做的事。

但导入不是“把文件拖进去就完事”。来源有四种（文件夹、压缩包、单个 JAR、Modrinth 整合包），每种都有自己的格式和限制；核心认不出来时要手动改；整合包还会联网下载模组、逐个校验哈希。搬错一步的结果往往不是一句明确的报错，而是“服务器建好了，但一启动就出错”。

下面按 选方式 → 导入 → 检查 → 排错 的顺序走。

什么时候该用「导入」，而不是「下载」#

先给结论：已经有现成的服务端文件就导入，从零开始就下载。 两条路最后都落到同一个位置——公共存储里的 /storage/emulated/0/Minexa/Minecraftserver/<目录名>/，区别只在“文件是谁准备的”。

三种情况分清楚，不要混着用：

• 用下载：从零开始，或只想换一个干净的核心。下载页会拉官方版本、写好 EULA、建好目录，最省心，见 下载页：选核心、选版本与下载。

• 用导入：你已经有完整服务端目录、别人打包的压缩包、单个核心 JAR，或 Modrinth 整合包——里面有你的存档、配置和插件。

• 两个都不用：只想换个核心版本，直接在下载页下新的、点「选用」就行。

入口有两个，效果完全一样：下载页最下方的整宽按钮「导入服务器」，或者「选择核心类型」右上角的小字「支持导入服务器」。找不到按钮时先确认页面已经滚到底部。

四种导入方式，先选对来源#

弹窗里先选来源：文件夹、压缩包、JAR、整合包。选错不会立刻报错，只会在后面某一步失败，所以先对号入座。

文件夹限制最少，没有体积和条目上限。如果选的目录本身不像服务器根、但里面恰好只有一个子目录像，应用会自动下钻；有多个像则提示“所选文件夹包含多个服务器目录”，这时要直接选到那一层。

压缩包是“先复制、再嗅探、后解压”：判断它是 zip 还是各种 tar，剥掉多余外层目录再解。JAR 只搬核心文件，世界和配置都要你自己补。

大小与安全限制#

压缩包解压有两条硬红线：总体积 32 GiB、条目数 40 万，超了立刻中止并删掉已解出的部分。包内带 ..、盘符或绝对路径的会被直接拒绝，tar 里的符号链接一律跳过，这是防压缩炸弹和路径穿越的手段。文件夹导入和单 JAR 导入没有体积上限。

导入前：先停服、先备份、对齐版本#

导入会往公共存储写一整个服务器目录，比下载重得多，中途失败也可能留下半个目录。动手前花两分钟确认四件事：

1. 原服务器已停止。 运行中的世界文件还在往外写，复制出来可能是半截的。先在原设备上正常 stop，等它自己退出。

2. 原目录已备份。 导入失败会回滚并删掉目标目录，但不会修复你的源文件，压缩包也留一份原包。

3. 版本能对上。 导入只搬文件，不会升级或降级世界。1.21.4 的世界用 1.21.1 的核心开，很可能直接报错。

4. 手机空间够。 导入过程中源文件和目标目录同时存在，等于要双份空间。

从旧手机或电脑迁移#

换设备是最常见的导入场景，四条经验能省掉大半返工：

• 整目录搬，不要只搬 world。 核心 jar、server.properties、ops.json、whitelist.json 都要一起，只搬世界会连权限和白名单一起丢。

• 先停服再复制。 运行中的世界文件随时可能在写，复制出来就是坏的。

• 版本保持一致。 换手机不换版本最稳；想顺手升级，先备份再走升级流程，见 选版本、升级与降级。

• 也可以直接把文件夹拷进 Minecraftserver/。 拷完打开「服务器管理」，应用会自动识别并提示“已自动添加”，不想再复制一遍时更快。

步骤：选来源、填名称、等进度#

成功标志有三个，缺一说明还没完：弹窗自己消失、下载页的「已安装核心列表」里多出一条、概览页「当前核心」显示成刚导入的那个。

导入和下载一样会写 eula.txt（eula=true，BDS 除外），并补上 plugins/ 之类的基础目录。所以你不用自己去找 EULA 文件，也不会看到任何询问弹窗。

名称和已有服务器重复时应用会生成新目录，不会覆盖旧服——所以真正的风险是你以为覆盖了，其实多出一个新服。

它会自动识别核心和版本#

导入时，应用会离线扫描目录内容，按一套固定顺序判断核心类型：

• 目录里有 bedrock_server → BDS；

• 有 powernukkitx.jar 或 PNX 的类 → PowerNukkitX；

• 有 quilt-server-launch.jar → Quilt，fabric-server-launch.jar → Fabric；

• 有 Forge/NeoForge 的 libraries/ 目录 → 对应加载器；

• 根目录 jar 叫 server.jar → Vanilla；有 paper、purpur、leaves 的类 → 对应核心；

• 全都不匹配 → 核心为空，登记为「未知」。

版本识别也是分层的：先读根目录的 version.json，其次读核心 jar 内嵌的 version.json，再按目录布局推算。任何一步失败都只是“识别不出”，核心识别失败不影响文件已经搬完——服务器照样建好了，只是应用不知道按哪种核心启动它。这时去「服务器管理」→「修改服务器信息」，把核心类型和显示版本号改对，再回概览启动。

这个弹窗的能力有边界：它改的是显示名称、显示版本号，以及应用按哪种核心来对待这个服（启动参数、插件/模组目录等）。它不会替换实际的 jar，也不会升级游戏版本；核心文件本身要换，得回下载页下新的。

.mrpack 整合包：会自动下载服务端模组#

Modrinth 整合包不是“解压就完”的压缩包。它里面只有一个索引 JSON 和一堆覆盖文件，真正的模组要按索引联网下载。

导入时应用会按顺序做五件事：

1. 读 dependencies，确定 Minecraft 版本和加载器（Fabric / Forge / NeoForge / Quilt）；

2. 按 downloads[].url 逐个下载服务端文件，用 hashes.sha1 校验；

3. 跳过标记为仅客户端的文件（env.server 为 unsupported）——这一步很关键，客户端专用模组装进服务端会直接崩；

4. 解开 overrides/ 和 server-overrides/，覆盖到服务器目录；

5. 删掉临时的索引和覆盖目录。

所以 整合包导入必须联网，而且比普通压缩包慢得多。校验失败或任何一个文件下载失败都会中止，不会留下半个整合包——这点比手动解压安全。

导入后必做四件事#

1. 确认 Java。 1.21+ 用 Java 21，1.17～1.20.6 用 17，1.16 及以下要 Java 8（只有 PRoot focal 提供）。见 运行环境管理。

2. 启动并等 Done。 不要看到“运行中”就放人进。第一次启动可能补文件、生成世界，1～3 分钟都算正常。

3. 看日志找缺失依赖。 导入不会自动安装插件依赖，模组缺前置、插件缺依赖都会在日志里报出来，对照 模组安装、依赖与排错 和 模组冲突与插件报错。

4. 马上备份。 导入后第一次成功启动，是备份的最佳时机，见 备份、还原与世界管理。

导入搬的是“文件”，不是“依赖关系”。模组版本、插件前置、Java 版本全靠你按日志自己补，所以第一轮启动请全程盯着 终端与控制台。

导入失败先看这张表#

如果导入成功了、但服务器起不来，那已经不属于导入问题，按 启动失败排查 逐层查。别一生气就删目录重导——导入只是复制，修不好版本不匹配。

五个最常见的新手误操作#

1. 导入还在跑就切页面。 进度会继续，但你回来不知道结果。

2. 只导出 world 文件夹。 世界有了、核心和配置没了，等于新开一个空服加一张旧地图。

3. 把 .mrpack 解压后当文件夹导入。 只能得到索引和覆盖文件，模组一个都没有。

4. 导入后不选核心就启动。 先用 Done 前确认概览页「当前核心」对得上。

5. 反复导入同一个包。 每次都新建一个目录，很快把空间吃满。

下一步#

• 需要先补一个干净的核心：下载页：选核心、选版本与下载

• 导入的是模组服：模组核心：Fabric、Forge、NeoForge、Quilt

• 启动不了、卡在某一行：启动失败排查