Minexa说明书
新手必看新手快速入门

5 分钟极速开服(保姆级)

从安装 App 到朋友进服,一条不用懂原理的最短路线;每一步都写清点哪里、看到什么、成功是什么样。

你只是想和朋友玩一会儿,不想先学一遍 Linux、Java 和网络原理。可以,这一页就是为这个场景写的:不解释原理,只给你一条能走通的最短路线。跟着做,大约 5 分钟能开好服;第一次要下载运行环境,实际时间会更长一点。

开始之前,确认三件事:手机是 Android 8.0 及以上、arm64 架构;手机和朋友的设备连在同一个 Wi-Fi;你有一份 Minecraft Java 版(电脑版)客户端。少了任何一条,先去看 开服前置准备清单,否则中途会卡住。

如果你连“内存”“端口”“Java”这些词都没听过,也不用先去补课:这一页每冒出一个新词,后面都会跟一句大白话。实在被卡住,就打开 大白话术语表 查一句,或者看 新手避坑 里别人翻车的地方。下面的路线图就是全部流程,每一格都能点进去。

  1. 装 Minexa下载 arm64 安装包,装完先别开省电
  2. 等环境 + 装 Java约 50 MB,只装一次
  3. 下一个核心选 Paper,版本和朋友的客户端一致
  4. 启动并发地址看到 Done 再把 IP:端口 发出去
本页要点
  • 最短路线只有四步:下载核心 → 回概览点启动 → 等终端出现 Done → 把地址发给朋友。

  • 第一次启动要 1~3 分钟,慢是正常的,不要在没看到 Done 时反复重启。

  • EULA 由应用自动写入,你不会看到“是否同意”的弹窗,也不用自己改文件。

  • 只开给同一个 Wi-Fi 的朋友;跨网络要先换联机方式,不是重启服务端能解决的。

第一步:安装 Minexa#

  1. 在手机浏览器打开项目的 Releases 页面。

  2. 下载文件名里带 arm64-v8a 的 APK。不要下错成其他架构的包,Minexa 只支持 arm64。

  3. 点开 APK 安装。系统提示“未知来源应用”时,允许当前浏览器安装即可。

APK 就是安卓的安装包,相当于电脑上的 .exe:下载下来、点开、确认安装,就完事了。

下载页面全是英文,只看一个地方

页面上那一大段英文是更新说明,不用读。你只需要找标题是 Assets 的那一块,点名字里带 arm64-v8a、结尾是 .apk 的文件。点成 Source code (zip) 下载的是源代码,装不上的。

安装完成后先不要急着下载核心,第一次打开应用还有两件事:初始化运行环境、安装 Java。

装完先别开省电模式

很多手机默认会在后台清理应用。开服前把 Minexa 加入“电池优化白名单 / 允许后台活动”,能少掉一半“莫名其妙自己停了”的问题。设置入口在「更多 → 保活」,见 后台保活。

第二步:等运行环境初始化完成#

第一次打开 Minexa,概览页会出现「初始化运行环境」卡片,提示下载约 50 MB 的 Termux 兼容运行环境。初始化会自动开始,你只需要等进度条走完。

这一层是 Minexa 在手机私有目录里准备的一套迷你 Linux 环境,服务端之后就在里面跑。它只需要装一次,以后启动不会再下载。

  • 成功标志:初始化卡片消失,概览页不再提示“正在下载并解压”。

  • 如果卡住或失败:先点卡片里的「切换到下个镜像源」再重试;还不行就看卡片底部显示的控制台最后几行,带着报错去 启动失败排查。

  • 不要在这一步反复杀应用重开,下载中断后重新进应用会继续。

第三步:安装 Java#

Minecraft 服务端是用 Java 写的,所以要先有 Java 运行环境。Minexa 不会替你偷偷装,但会把缺什么直接显示出来。

有两种入口,任选其一:

  • 概览页出现「Java 运行环境」卡片时,直接点「安装 Java」;

  • 或者点概览右上角的「依赖与环境管理」→「Java 版本」→ 展开 Termux JDK → 选 Java 21 → 点「安装」。

对大多数 1.21.x 的 Paper 服务端,Termux JDK 21 是最省事的选择。安装需要联网,等它下载并校验完成,状态变成“已安装”即可。

为什么是 Java 21

Minecraft 1.21 及更新的版本通常需要 Java 21;1.17~1.20.6 用 Java 17;1.16 及更老才需要 Java 8。Minexa 会在启动前按版本自动选,但只会在你选的来源里换版本,不会替你换来源。具体对应关系见 游戏版本与 Java 版本。

第四步:下载一个服务端核心#

点底部导航的「下载」。这一页看起来选项很多,第一次只需要做三件事:选核心、选版本、点下载。

  1. 选核心:在「选择核心类型」里点 Paper。它是目前最常用、对插件最友好的 Java 服务端核心(核心 = 真正运行游戏逻辑的那个程序),性能也比原版好。

  2. 选版本:在版本列表里选一个和朋友们客户端一致的版本。如果大家都用最新版,就选列表里最新的 1.21.x 稳定版(列表默认只显示最近 8 个,没看到就点「显示全部」)。客户端和服务端版本必须一致,1.21.4 的客户端进不了 1.21.1 的服。

  3. 点下载:等进度走完。Paper 不需要额外安装器,下载完就能用。

成功标志:下载页的「已安装核心列表」里出现 Paper,并标着「当前选用」;概览页的「启动服务端」卡片不再显示“尚未下载服务端核心”。

别在下载页反复切换核心

每切一次核心,版本列表都会重新请求,旧请求会被丢弃。选好 Paper 和版本后,耐心等下载完成;中途切来切去只会让你不知道下到哪一步了。

第五步:回概览,点启动#

回到「概览」,找到「启动服务端」卡片:

  1. 确认「当前核心」是刚下载的 Paper;

  2. 确认「当前运行环境」是 Termux · Java 21(或你实际安装的版本);

  3. 点绿色的「启动」长条。

第一次启动会生成世界、写配置文件,通常要 1~3 分钟,慢一点也正常。你会看到启动阶段进度和终端输出。

成功标志:终端出现类似下面这一行——

文本
[Server thread/INFO]: Done (3.214s)! For help, type "help"

看到 Done,才说明服务端真正启动完成、端口已经开始监听(端口 = 同一台手机不同程序的“门牌号”)。在这之前,即使状态显示“运行中”,也先别让朋友连。

EULA 不用你管

原版服务端第一次启动会生成 eula.txt 并停下来等你同意。Minexa 在下载或导入服务端时,如果发现没有这个文件,会直接写入同意状态,所以你不会看到 EULA 询问,也不需要自己改文件。这代表你同意 Minecraft EULA,使用前请确认你接受其条款。

第六步:把地址发给朋友#

服务端启动后,概览页的「服务器地址」卡片会显示一行「局域网」,格式是 手机IP:端口,例如 192.168.1.23:25565。点右边的复制按钮。

这行字里的冒号是分界线:冒号前面是手机在这个 Wi-Fi 里的地址,冒号后面是程序的门牌号。两个数字都要,少一个就连不上,也不要在中间加空格。

让朋友在同一个 Wi-Fi 下:

  1. 打开 Minecraft Java 版;

  2. 进入「多人游戏」→「添加服务器」;

  3. 名称随便填,地址粘贴刚才复制的 IP:端口;

  4. 保存后双击进入。

成功标志:游戏里能看到服务器 MOTD,进度条走完进入世界;同时你的终端里会出现 Steve joined the game 这样的加入日志。

如果朋友不在同一个 Wi-Fi,这一招不成立。先看 我该用哪种联机方式,不要在这里反复重启服务端。

启动日志看不懂?只看这四行#

第一次启动时终端会刷几十行英文,新手容易以为出错了。其实只要盯住四个位置:

你看到的行含义要不要管
Starting org.bukkit.craftbukkit…核心开始加载正常,等
Preparing level "world"正在生成/读取世界正常,第一次会久一点
Done (3.214s)! For help, type "help"启动完成,可以进了关键,看到它才算成功
FAILED TO BIND TO PORT端口被占用要处理,见下

如果卡在 Preparing spawn area,通常是手机性能弱、世界大,再等一两分钟;超过五分钟没有任何新日志,才按 启动失败排查 处理。

常见卡点:只查这三处#

第一次开服失败,90% 的情况不需要重装。按顺序看三个地方:

卡在哪先看哪里常见原因
点启动没反应/按钮灰概览的启动卡提示、Java 卡片运行环境没初始化、Java 没装
启动了但没有 Done终端最后 20 行Java 版本不对、端口被占、核心损坏
有 Done 但朋友进不来服务器地址、是否同一 Wi-Fi、正版验证地址错、不同网络、没正版账号
端口被占用怎么办

FAILED TO BIND TO PORT 的意思是手机上的 25565 端口已经被别的程序占了。最常见的原因是:上一次服务端没真正退出、开了两个服务端、或者你之前装过别的开服工具。先回概览确认状态,必要时点「强制停止」,再重新启动。

还是卡住?看别人从头做一遍

看视频时留意两点:多数教程是在 Termux 里手敲命令,Minexa 已经把这些步骤做成了按钮;教程里的版本号也可能和你不一样,一切以你下载页里能选的版本为准。视频由 UP 主独立制作,界面以你手机上的实际版本为准。

开服成功之后,建议马上做三件事#

  1. 加白名单:只让认识的人进。见 白名单、OP 与封禁。

  2. 备份一次:现在世界还是干净的,备份最省事。见 备份、还原与世界管理。

  3. 改 MOTD 和人数:让服务器列表里显示你想要的介绍。见 服务器配置页。

关于正版验证

Minexa 默认开启正版验证(online-mode=true),没有正版账号的玩家进不来。关闭它能让人进来,但任何人都可能冒用别人的名字,只建议在信任的小圈子里使用,并且必须配合白名单。公网开放 + 关闭正版验证 = 把家门钥匙挂在门上。

关机前先正常停止#

想结束的时候,不要在系统任务里划掉 Minexa——那样等于直接掐断进程,世界可能还没存盘。

正确做法是回概览点「停止」,它会向控制台发送 stop 命令,最多等 180 秒让服务端存档退出。超时后应用不会硬杀,而是提示你可以点「强制停止」;强制停止会丢未保存的数据,只在卡死时用。

上机自查
  • 概览页「当前核心」显示 Paper,没有“尚未下载核心”的提示。

  • 终端出现过 Done (...s)! For help, type "help",不是停在 Starting server。

  • 「服务器地址」卡片显示了 IP:端口,且手机 IP 是 192.168. 开头(说明连的是局域网)。

  • 朋友在同一个 Wi-Fi 下,游戏里能看见 MOTD。

  • 已经做过一次整服备份,知道备份放在哪里。

下一步#

读到这儿了,给你点个赞。如果这页内容帮你解决了问题,说明说明书的方向是对的;如果发现错误、过时信息或看不懂的地方,欢迎到 GitHub Issues 告诉我们。

⚡ 回到极速开服 📖 查术语表