Minexa说明书
入门APP 使用说明

玩家页:在线、OP、白名单与封禁

给朋友 OP、加白名单、封人、看谁在线;为什么必须先开服,为什么改了 OP 等级要重启。

朋友刚进服就在聊天框里喊“给我 OP”;过了一会儿,一个你没见过的名字开始在出生点拆家;你想知道现在到底谁在线、谁有权限。这三个动作都在「玩家」页,但它们都建立在一个前提上:服务端正在运行。

没开服时打开这一页,按钮大多是灰的,还会提示“服务器未运行,所有命令操作不可用”。这不是坏了,也不是权限没给够:玩家管理本质上是向服务端发命令,服务端不在,命令就没有接收方。启动后回到这一页,按钮自己就恢复了。

所以顺序永远是:先去概览页启动服务端、等终端出现 Done,再回这一页动手。下面按“先看状态 → 再看四个标签 → 最后处理具体的人”来讲,每一步都写清点哪里、看到什么。

本页要点
  • 这一页管四件事:看谁在线、给 OP、管白名单、封禁玩家。

  • 所有写操作都要求服务端正在运行,按钮灰着不是应用坏了。

  • 加 OP 走“配置文件默认等级”不用重启;手动指定 1~4 级要重启才生效。

  • 在线名单靠日志推送,会慢一两秒,别指望它和游戏里完全同步。

  • 白名单开关只发命令、不改配置文件,重启后可能自己关掉。

先看状态横幅:四种状态#

页面顶部有一条「服务器状态」横幅,右上角是刷新图标。它先把当前情况说清楚,你再看下面四个标签就有底了:

横幅状态含义你能做什么
Termux 环境未就绪运行环境还没初始化先去概览页完成初始化
未选择服务端核心还没选用核心去概览页或下载页选一个
服务器未运行进程没起来先启动;本页写操作全部不可用
服务器运行中 · 在线 x / y正常可以加 OP、改白名单、封禁、踢人

看到第三种就要停手了:没开服时这一页只能看,不能改。横幅上的“在线 x / y”里,y 是配置里的最大人数,x 是当前解析到的在线人数,两者都可能有一点点延迟。

点横幅右侧的刷新图标,会重新读一遍玩家数据。切到「在线玩家」标签时,应用还会主动向服务端发一次 list,让在线名单尽量新。这两个动作都只是“再问一遍”,不等于强制同步。

按钮灰着不是 bug

加 OP、切白名单、封禁、踢人,全部要求服务端正在运行。很多人第一次用会以为“权限没给够”或“应用坏了”,其实只是没开服。服务端一启动,按钮立刻恢复。

四个标签各看什么#

四个标签的分工很明确,别在错的标签里找人:

标签看什么数据从哪来
在线玩家当前在线的人,可搜索、踢出、切游戏模式日志解析 + list 命令回执
OP 列表谁是管理员、等级多少ops.json(PNX 可能读 ops.txt)
白名单谁被允许进入、白名单开关whitelist.json(PNX 可能读 white-list.txt)
封禁列表被封的人、原因、时限banned-players.json

标签上的数字是当前条目数,例如「在线玩家 3」。每个标签都有自己的搜索框,名字太长或人太多时用得上。搜索不是只能打全名:stve 这种少打一个字母也能命中 Steve。

行里的副标题也带信息:OP 行显示等级和 UUID 前几位,白名单行显示完整 UUID,封禁行显示「永久封禁」或「限时至某时」。这些字段来自文件本身,不是实时状态。

列表空不一定是真没有

这些 JSON 文件由服务端维护,应用读的时候采用宽松解析:文件不存在、为空、格式坏了,都会显示成空列表,界面不区分“确实没有”和“文件读不出来”。如果明明有 OP 却显示空,先去 文件管理页 看看 ops.json 是不是被改坏了。

在线列表是日志“推”出来的#

Minexa 没有向服务端查询玩家列表的实时接口。在线判定靠两件事:

  • 日志里出现 Steve joined the game / Steve left the game,就对应加人、减人;

  • 发一次 list,从 There are N of a max of M players online: ... 这行回执里校正人数和名单。

所以它有两个特点:有延迟、依赖日志。刚进服的人可能过一两秒才出现;日志被刷掉时名单可能暂时不准,点「刷新在线列表」或切到在线标签重新发 list 就好。

名字的识别也有条件:只认 [A-Za-z0-9_]、1~16 位,且要出现在日志的前缀位置,否则可能被当成聊天内容忽略。PowerNukkitX 的日志措辞和 Java 系不同,应用按它自己的关键字判断,所以别拿 Java 的日志行去对照基岩服。

另一个容易误会的点:OP、白名单、封禁这三个列表不显示在线状态。想知道某个 OP 在不在线,只能去「在线玩家」标签里对照名字。

加 OP:默认等级不用重启,手动等级要重启#

OP(Operator,管理员)能给玩家执行管理命令的权限。页面里的添加区有一个默认勾选的复选框:「使用配置文件默认 OP 等级(无需重启服务器)」,下面还会显示“当前配置默认 OP 等级:几”或“未配置(默认 4)”。

  • 保持勾选:新 OP 的等级取自 server.properties 的 op-permission-level(默认 4)。这条路只发一条 op <名字> 命令,默认等级这条路不用重启。这是给朋友加管理员最省事的方式,按钮写着「添加 OP(默认等级)」。

  • 取消勾选:出现 1~4 的等级下拉,按钮变成「添加 OP(等级 x)」。这条路会先发 op 命令,等约 800 毫秒让服务端把玩家写进 ops.json,再直接改文件里的 level 字段。界面会用红字提示「下次重启服务器后生效」——权限系统只在启动时读这个等级,所以手动指定的等级必须重启才生效。

等级大致对应:

等级能做什么
1基本只能绕过出生点保护
2单人作弊类命令,如切换模式、给予物品、传送
3多人管理类命令,如 OP、踢人、封禁
4全部命令,包括停服、保存世界(默认等级)

PowerNukkitX 下,手动指定等级不会写入等级字段,只有默认等级那条路可靠。无论哪种核心,OP 都不要乱给:等级 4 的人可以停服、改规则、拆掉你的一切。

不想让朋友等重启

先用默认等级把 OP 加上,他能立刻用管理命令;确实需要降级时,再去掉勾选改成低等级,然后挑一个没人的时间重启。复选框旁边的「前往配置」可以直接跳到 服务器配置页 改 op-permission-level 的默认值。

白名单:开关和加人是两步#

白名单(whitelist,只允许名单里的人进服)的逻辑是“先开门,再点名”,两步都要做,顺序也不能反:

  1. 在「白名单」标签顶部打开开关,状态会变成「白名单已开启 · 仅白名单内玩家可加入」;

  2. 在「添加白名单」里输入玩家名,点「添加」。

只开开关不加人,名单是空的,谁都进不来。所以更稳的顺序是:先把自己加进去,再开白名单开关,最后逐个加朋友。移除某个玩家不在列表行上,而是点进玩家详情,用「移出白名单」。

这里有一个必须记住的限制:玩家页的白名单开关只向服务端发 whitelist on/off 命令,不会修改 server.properties。界面上的开关状态是跟着命令走的,文件里那一行 white-list 依然是旧值。

重启后白名单可能“自己关了”

因为开关没有写进配置文件,重启后服务端会按 server.properties 里的 white-list 重新决定。想让它长期有效,去 服务器配置页 把 white-list 改成 true,再回玩家页加人。只靠玩家页的开关,重启后可能回到关闭状态。

封禁:能封玩家,没有 IP 封禁#

「封禁列表」标签里可以填玩家名、原因(可选)和时长。时长有永久、30 分钟、1 小时、6 小时、1 天、7 天、30 天;永久走 ban,限时走 tempban,按钮文案也会跟着变(「永久封禁」或「限时封禁(1 天)」)。

封禁成功后,对方会被踢下线,之后按名字被拒绝。解封在玩家详情里,按钮是「解除封禁」,发 pardon。

  • 没有 banned-ips 入口。这个应用不提供按 IP 封禁的管理界面,banned-ips.json 只在文件页作为文件存在,不能在这里增删。

  • 限时封禁依赖核心的 tempban 命令。不是所有核心都保证支持;如果限时封禁没生效,用永久封禁或换核心自带的方式处理。

  • 踢出只是请下线,封禁才会拦住再进。临时捣乱用踢出,反复来的人才用封禁。

想立刻处理在线的人,最快的是「在线玩家」标签里那一行的踢出图标;想留痕、想说明理由,就走封禁表单。

详情页与历史记录#

点任意一行玩家会打开「玩家详情」。字段按类型显示:名字必显示;OP 显示 UUID 和「OP 等级 x / 4」;白名单显示 UUID;封禁显示原因(没填就是「未填写」)、过期时间(空就是永久)和来源。

下方是「快捷操作」,按类型给按钮:

  • 任何类型的玩家,都会先给出「踢出」和「封禁」两个按钮;

  • OP 额外有「取消 OP」,以及四个游戏模式按钮(只对在线玩家有效,离线玩家要先上线);

  • 白名单玩家有「移出白名单」;

  • 被封禁的玩家有「解除封禁」。

从详情页发起的踢出和封禁会带固定原因(管理员踢出 / 管理员封禁),不需要你每次填。如果该玩家有活动记录,详情里还会多一块「活动记录」:最近进服、最近离服、累计在线、最后退出原因。

右上角还有「玩家历史记录」,标题是「玩家进服/离服记录」,顶部一行摘要写着“N 名玩家,累计在线多久”。每条记录标着进服或离服、对应时间和会话时长,异常中断会带一个「中断」后缀。支持搜索、导出 CSV、清空(有二次确认,只影响当前服)。记录存在应用私有目录,不写进服务端目录,换手机或重装不会跟着走。

应用只保证“命令发出去了”#

这是本页最需要知道的一个事实:应用不校验玩家名是否存在、不校验名字是否合法,也不解析服务端的命令回执。它只关心命令有没有写进服务端进程。

后果是:如果服务端回了 Unknown command 或 That player does not exist,界面仍可能弹出“已将某某加入白名单”。提示成功不等于服务端真的执行成功。所以做完关键操作(尤其是加 OP、封人),去 终端与控制台 看一眼有没有报错,或者让对方实际进一次服验证。

手动指定 OP 等级时,如果 ops.json 里找不到该玩家,应用会补一条 UUID 为空的临时记录,重启后由服务端补全;这期间列表可能有点怪,一般会恢复。

离线模式下,名字不是身份#

正版验证开启(online-mode=true)时,UUID 由 Mojang 账号决定,名字和账号绑定;关闭后,服务端只认名字,任何人起同样的名字都能冒充。离线模式里,名字等于全部身份,这也是本页所有权限操作的前提条件。

OP、白名单、封禁三份记录在离线模式下都是按名字记的:你给“小明”加了 OP,别人改名叫“小明”就继承了这个权限;你把捣乱的人封了,他换个名字又能进。

别在离线模式里按名字给 OP

关闭正版验证时,至少要做到:只和认识的人玩、开启白名单、不给陌生人 OP、发现异常先封禁再查。公网 + 离线 + 无白名单,是最危险的组合:任何人都能顶着别人的名字进来,把 OP 拿到手。

上机自查
  • 状态横幅显示「服务器运行中 · 在线 x / y」,不是「服务器未运行」。

  • 点「刷新在线列表」后,在线人数和你朋友游戏里看到的一致。

  • OP 列表里能搜到刚加的玩家,右侧徽标显示 Lv.4(或你选的等级)。

  • 白名单开关打开后,副行显示「仅白名单内玩家可加入」。

  • 被封的玩家在「封禁列表」里能看到,徽标是「永久」或「限时」。

  • 关键操作做完后,终端里没有 Unknown command 之类的红字。

下一步#

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

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