朋友刚进服就在聊天框里喊“给我 OP”;过了一会儿,一个你没见过的名字开始在出生点拆家;你想知道现在到底谁在线、谁有权限。这三个动作都在「玩家」页,但它们都建立在一个前提上:服务端正在运行。
没开服时打开这一页,按钮大多是灰的,还会提示“服务器未运行,所有命令操作不可用”。这不是坏了,也不是权限没给够:玩家管理本质上是向服务端发命令,服务端不在,命令就没有接收方。启动后回到这一页,按钮自己就恢复了。
所以顺序永远是:先去概览页启动服务端、等终端出现 Done,再回这一页动手。下面按“先看状态 → 再看四个标签 → 最后处理具体的人”来讲,每一步都写清点哪里、看到什么。
这一页管四件事:看谁在线、给 OP、管白名单、封禁玩家。
所有写操作都要求服务端正在运行,按钮灰着不是应用坏了。
加 OP 走“配置文件默认等级”不用重启;手动指定 1~4 级要重启才生效。
在线名单靠日志推送,会慢一两秒,别指望它和游戏里完全同步。
白名单开关只发命令、不改配置文件,重启后可能自己关掉。
先看状态横幅:四种状态#
页面顶部有一条「服务器状态」横幅,右上角是刷新图标。它先把当前情况说清楚,你再看下面四个标签就有底了:
| 横幅状态 | 含义 | 你能做什么 |
|---|---|---|
| Termux 环境未就绪 | 运行环境还没初始化 | 先去概览页完成初始化 |
| 未选择服务端核心 | 还没选用核心 | 去概览页或下载页选一个 |
| 服务器未运行 | 进程没起来 | 先启动;本页写操作全部不可用 |
| 服务器运行中 · 在线 x / y | 正常 | 可以加 OP、改白名单、封禁、踢人 |
看到第三种就要停手了:没开服时这一页只能看,不能改。横幅上的“在线 x / y”里,y 是配置里的最大人数,x 是当前解析到的在线人数,两者都可能有一点点延迟。
点横幅右侧的刷新图标,会重新读一遍玩家数据。切到「在线玩家」标签时,应用还会主动向服务端发一次 list,让在线名单尽量新。这两个动作都只是“再问一遍”,不等于强制同步。
加 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,只允许名单里的人进服)的逻辑是“先开门,再点名”,两步都要做,顺序也不能反:
在「白名单」标签顶部打开开关,状态会变成「白名单已开启 · 仅白名单内玩家可加入」;
在「添加白名单」里输入玩家名,点「添加」。
只开开关不加人,名单是空的,谁都进不来。所以更稳的顺序是:先把自己加进去,再开白名单开关,最后逐个加朋友。移除某个玩家不在列表行上,而是点进玩家详情,用「移出白名单」。
这里有一个必须记住的限制:玩家页的白名单开关只向服务端发 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 拿到手。
状态横幅显示「服务器运行中 · 在线 x / y」,不是「服务器未运行」。
点「刷新在线列表」后,在线人数和你朋友游戏里看到的一致。
OP 列表里能搜到刚加的玩家,右侧徽标显示
Lv.4(或你选的等级)。白名单开关打开后,副行显示「仅白名单内玩家可加入」。
被封的玩家在「封禁列表」里能看到,徽标是「永久」或「限时」。
关键操作做完后,终端里没有
Unknown command之类的红字。
下一步#
白名单、OP、封禁的通用规则与最佳实践:白名单、OP 与封禁管理
命令本身怎么写、还有哪些管理命令:管理员命令速查
想做更细的权限(不同人不同命令):装权限插件,见 插件与模组管理
开服前就该避开的坑:新手常见误区