Minexa说明书
入门APP 使用说明

文件管理页(含 FTP 入口)

在手机上直接建目录、改文件名、复制粘贴、批量删除、看详情;哪些操作仍然要交给 FTP 或电脑。

朋友发来一个插件 LuckPerms.jar,你把它存在手机的「下载」文件夹里,现在要挪进 plugins/;server.properties 里的端口想改成 25566;还有人问你能不能把这个世界打包发给他。这三个动作都在底部导航的「文件」页,而且从 1.4.2 起,这一页已经能自己干完:新建、重命名、复制粘贴、批量删除、排序、看详情都在页面里,不用再为了改个文件名导出到别的管理器。

先认清两件事,能省掉很多「按钮在哪」的烦躁。第一,这一页只认当前服务器的目录,切服要去「服务器管理」;第二,路径卡上写的是完整绝对路径,不再是旧版那个容易误会的 servers/ 别名。

第三件事更重要:删文件、存配置都不检查服务端是否在跑。服务端正跑着,你删掉 world/,应用照样执行,不会有一句「请先停服」。正确顺序永远是:先停服 → 先备份 → 再动手。

本页要点
  • 这一页解决什么:放插件、改配置、整理目录、打包世界,日常文件操作全在这。

  • 入口是底部导航的「文件」;想用电脑批量操作,走「更多 → FTP 文件管理」。

  • 真实路径就是路径卡上显示的那一串,形如 /storage/emulated/0/Minexa/Minecraftserver/<目录名>/。

  • 重命名、复制粘贴、批量删除、排序、新建文件都已经有了,不用再找第三方管理器。

  • 仍然做不到的是解压和全文搜索;这两件事交给 FTP 或电脑。

  • 删文件、存配置都不会拦你停服,动任何东西之前先手动备份一次。

入口在哪:底部「文件」,电脑操作用 FTP#

在应用底部导航点「文件」,进去就是当前服务器的目录。想切到另一台服务器的文件,先在「服务器管理」里切换当前服务器,再回文件页。

页面从上到下分四块:

  1. 路径卡:等宽字体显示完整绝对路径,多深都折行显示、不截断,右侧两个图标是「复制路径」和「刷新」;

  2. 工具条:一排图标动作,横向可滑,见下一节;

  3. 多选条:只在选择模式下出现,显示「已选 N 项」、全选、删除、退出;

  4. 文件列表:每行是图标、文件名、应用自带的一行说明、大小与修改时间,右侧是这一行的动作。

列表里文件名下面那行灰色的「【服务端核心文件】」「【主世界存档文件夹】」之类注释,是应用内置的说明,只在它认识的常见文件和目录上出现,别的文件不显示——不是文件有问题。

工具条:九个图标各管什么#

工具条的图标数量会变(粘贴只在剪贴板有内容时出现),一排最多九个:

图标作用什么时候会灰掉
房子(根目录)一键跳回服务器根目录已经在根目录
上箭头回上一层已经在根目录
上传从手机任意位置选文件复制进当前目录未授权存储
新建文件夹在当前目录建空文件夹—
新建文件建一个空文本文件,可指定文件名—
排序名称 / 修改时间 / 大小,再点同一项切换升降序—
眼睛显示 / 隐藏以 . 开头的文件—
勾选清单进入 / 退出多选模式—
粘贴把刚才「复制」的内容粘到当前目录没有复制过东西时不出现

排序与隐藏文件过滤都是纯内存操作:切换排序不会重新扫盘,目录里有几万个文件也不会卡。文件夹永远排在文件前面,排序只影响同一类内部的顺序。

行内动作:一行文件能做的事#

把鼠标(手指)落在某一行右侧,会看到这几个图标,多的时候收进溢出菜单:

  • 导出:文件原样复制出去;文件夹自动打包成 zip,默认名 <文件夹名>.zip;

  • 编辑文本:打开支持的文本文件(见后文编辑器一节);

  • 重命名:原地改名,输入框预填原名;

  • 复制:记下来源,之后换到目标目录点工具条的「粘贴」;

  • 粘贴到此处:目标是文件夹时直接把剪贴板内容粘进去;

  • 复制路径:把这个文件的绝对路径放进剪贴板;

  • 详情:类型、大小、修改时间、完整路径;

  • 删除:有确认框。

重命名碰到同名会直接拦下并提示「同名项目已存在」,不会像旧版那样把原文件覆盖掉。复制时如果想把一个文件夹粘到它自己内部,也会被拦住——那种操作会把磁盘写满。

多选与批量删除#

点工具条的勾选清单进入选择模式,每行左侧出现复选框:

  1. 进入选择模式:点勾选清单图标,列表左侧出现复选框。

  2. 挑要删的:逐行点选,或点「全选」一次选中当前目录所有可见项。

  3. 确认数量:多选条上显示「已选 N 项」,这个数字是你最后核对的机会。

  4. 点删除:弹框明确写「将永久删除 N 项内容,此操作不可撤销」。

  5. 看结果:执行完分别报告成功几项、失败几项。

换目录时选择会自动清空。这不是小事:旧版切目录后仍显示「已选 N 项」,指向的却是上一层路径,接着点删除就删错了地方。

空列表的四种原因,界面会分开告诉你#

「列表是空的」以前有四种完全不同的原因,却长得一模一样。现在分别说明:

你看到的提示真实原因怎么办
需要文件管理权限没拿到「所有文件访问」点「去授权」按系统提示给权限
根目录还没创建还没下载或导入过服务器,全新安装的正常状态去「下载」页装一个服务器
当前目录只有隐藏文件文件都在,被「眼睛」过滤掉了点工具条的「显示隐藏文件」
这个目录是空的真的空正常,可以上传或新建

另外,文件浏览不依赖 Java 运行环境:首次启动、引导包还没下完时,也能正常查看磁盘上已有的服务器。

上传和导出:都走系统文件选择器#

上传用的是 Android 标准文件选择器(SAF,就是那个「最近 / 下载 / 图片」的系统面板),可以选手机里任意位置的文件。选完后文件被复制进当前所在目录——所以先切到 plugins/ 再上传插件。

从手机装一个插件,完整操作是这样:

  1. 切到目标目录:在文件列表里点进 plugins/,确认路径卡末尾是 plugins。

  2. 点「上传」:在系统面板里找到那个 .jar,选中并确认。

  3. 看结果:列表里出现新文件,底部弹出「文件上传成功」,大小和原文件一致。

  4. 重启服务端:插件只在启动时加载,不重启等于没装。

上传有一个容易踩的点:同名文件直接覆盖,没有「是否替换」的确认。传新版本前先想清楚旧文件要不要留,或者先复制一份备份。

导出分两种。文件导出是把文件原样复制到你选的位置;文件夹导出会自动打包成 zip。想把整个世界发给朋友,就点 world 那一行的导出,得到的就是一个包含世界的压缩包——不需要先压缩再导出。导出只是复制,不会删除原来的文件。

装整合包不用手动解压

拿到 .mrpack 整合包或完整的服务端压缩包时,不要在这里想办法解压。这一页没有解压功能,去下载页用「导入服务器」让应用按格式处理,见 导入服务器与整合包。

文本编辑器:UTF-8、1 MiB、只认六种扩展名#

点某一行的「编辑文本」进入编辑器,整页替换文件列表。它不是通用编辑器,限制非常明确:

  • 编码固定 UTF-8,没有编码可选,也不处理 BOM;

  • 单文件上限 1 MiB,超了会提示你先导出再编辑;

  • 只有 properties、yml、yaml、json、txt、log 这六种扩展名能编辑,其它文件连按钮都不出现;

  • 文件前 4 KB 里有 NUL 字节会被当成二进制,拒绝打开;

  • 保存 JSON 前会先做语法校验,格式不对直接报错,不写盘;

  • 写入方式是「先写临时文件、再原子替换」,中途失败不会留下半个文件。

编辑器顶部的按钮是返回、刷新(重新从磁盘读一次)、复制(把当前编辑的内容放进剪贴板)、保存。正文是一个等宽字体的多行输入框。

有两点必须提前知道。第一,没有只读模式,也没有「放弃修改」的确认:改完直接点返回,改动就丢了,而且不提示。第二,唯一的软保护是服务端运行中保存时会弹一个框,提醒「保存配置或日志可能影响服务端运行」——你点确认后它照样写,不会阻止你,也不会帮你重载配置。

所以文本编辑器的正确用法只有一条:停服 → 改 → 保存 → 启动 → 看日志确认。改 server.properties 也可以走 服务器配置页 的表单,表单会保留注释和未知键,两种方式不冲突。

删也好、存也好,应用都不会拦你#

这是文件页最大的风险点,必须单独说清楚:

运行中删世界,应用不会阻止你

文件删除和文本保存都不检查服务端是否在运行。运行中删掉 world/、server.jar、plugins/,应用照样执行,不会有「请先停服」的提示。世界正在被写入时删除,可能直接毁掉存档;删掉正在运行的 jar,进程下次就起不来。

删除有确认框,文件夹会额外提示「该文件夹下的所有内容将被一并删除。此操作不可撤销。」,批量删除会写明项数。但确认框只防误点,防不了「你在运行中删了不该删的东西」。删除不可撤销,这一页也没有回收站。

养成两个习惯就够了:动服务端目录里的任何东西之前先停服;删世界、删插件、批量改配置之前先打一份备份,见 备份、还原与世界管理。

新手最常犯的五个操作,提前避开:

误操作后果正确做法
运行中删 world/存档损坏,可能直接打不开先停服,先备份
在根目录上传插件插件不在 plugins/ 里,等于没装先点进 plugins/ 再上传
传新版本插件前删了旧文件想回退时没得回先复制一份再覆盖
改完 server.properties 直接玩配置没生效,还以为改错了改完必须重启服务端
把文件夹粘到自己内部会无限递归把磁盘写满应用会拦,但别去试

电脑上批量改文件:FTP 比数据线方便#

想在电脑上拖插件、改配置、解压整合包,用 FTP 最省事。入口在「更多 → FTP 文件管理」:

  • 点「启动 FTP 服务」,页面会显示 ftp://<手机局域网IP>:<端口>/,可以分别复制完整地址和主机 IP;

  • 默认端口 2121,可改范围 1024~65535,运行中不能改端口,要改先停;

  • 默认不开匿名,默认允许写入;用户名默认 mc、密码默认空,改完会自动重启 FTP 服务生效;

  • 根目录是 /storage/emulated/0/Minexa,比文件页的根更靠上一层,所以能看到 Minecraftserver/ 和备份目录,但看不到应用私有目录里的历史快照。

用电脑连的时候注意四件事:手机和电脑必须在同一个 Wi-Fi;FTP 是明文协议,没有加密,账号密码和文件内容在局域网内理论上可被嗅探,只建议在可信网络里开,用完就停;应用要保持后台运行,进程被杀 FTP 就断;在 MT 管理器这类客户端里,主机和端口要分开填,别把整条 ftp:// 地址粘进主机栏。

找不到文件时按这个顺序查#

  1. 先看路径卡末尾停在哪个目录,别在 .../plugins 里找只有根目录才有的文件;

  2. 看是不是被「眼睛」过滤了——目录里只有隐藏文件时,列表看起来也是空的;

  3. 用电脑或 MT 管理器打开 /storage/emulated/0/Minexa/Minecraftserver/,看文件夹到底在不在;

  4. 文件夹在、但应用里没有对应的服务器,去 服务器管理页 让它重新登记;

  5. 文件夹也不在了,再想是不是被删了、被还原覆盖了,去备份里找,见 备份、还原与世界管理;

  6. 都不对,就看 服务端目录结构与文件说明,确认这个文件本来是不是就该存在。

上机自查
  • 路径卡能显示完整的 /storage/emulated/0/Minexa/Minecraftserver/<目录名> 路径。

  • 列表里能看到 server.properties 和 world 文件夹。

  • 上传前已经点进目标目录(例如 plugins/),不是停在根目录。

  • 试过一次重命名成已存在的名字,应用确实拦下了,原文件还在。

  • 编辑过 server.properties 之后重启了服务端,并确认改动生效。

  • 删除任何文件之前,备份列表里已经有了一份当天的备份。

下一步#

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

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