Minecraft服务器显示在线人数,最直接的办法是在控制台或游戏内输入 /list;如果要把人数常驻显示在计分板、Tab列表、网页或QQ机器人里,原版服可用计分板命令方块方案,插件服推荐 PlaceholderAPI 配合 TAB 或计分板插件。下面按 Java 版、基岩版、插件服和网页查询几种场景拆开讲,命令和路径都能直接对照操作。
mc服务器怎么用指令显示在线人数:先分清 Java 版和基岩版
Java 版原版 /list 指令与权限
Java 版最基础的查询指令就是 /list,在游戏内聊天框输入:
/list:列出当前在线玩家。/list uuids:在部分版本中附带 UUID 信息。- 控制台直接输入
list:不需要斜杠,返回在线人数和玩家名单。
据 Minecraft 官方文档,/list 的用途就是列出在线玩家,多数原版服务端默认允许普通玩家使用,但如果你装了 LuckPerms 这类权限插件,要确认玩家组拥有 minecraft.command.list 权限,否则会出现“输入后没反应”或“没有权限”的提示。
基岩版 /list 与查询差异
基岩版服务端同样可以在控制台输入 list,游戏内使用 /list,不同服务端核心和版本对权限要求不完全一样,部分版本需要 OP 才能执行,操作路径是:服务端控制台输入 list,看返回的在线人数;游戏内先确认自己是否为 OP,再输入 /list。
控制台和 RCON 查询在线人数
如果你不想进游戏,只想在后台或脚本里查,RCON 更合适,先在 server.properties 中确认:
enable-rcon=truercon.port=25575rcon.password=你的密码
然后用 mcrcon 这类工具执行:
mcrcon -H 127.0.0.1 -P 25575 -p 你的密码 "list"
通常会包含在线人数和玩家名单,RCON 端口不要直接暴露到公网,建议只允许本机或内网访问,网页查询通过后端代理转发。
用原版计分板把在线人数常驻显示在侧边栏
命令方块方案:每 tick 重置再累加
Java 版原版可以用计分板虚拟玩家名记录人数,先创建目标:
/scoreboard objectives add online dummy "在线人数"
然后放置一个循环命令方块,设置为“循环、保持开启、无条件”,输入:
scoreboard players set #online online 0
后面接一个链命令方块,设置为“链、保持开启、无条件”,输入:
execute as @a run scoreboard players add #online online 1
最后执行:
/scoreboard objectives setdisplay sidebar online
这样侧边栏会显示 #online 的分数,也就是当前在线人数,每 tick 刷新一次,实际就是每秒约 20 次,如果服务器 TPS 压力较大,可以把循环命令方块改为每 20 tick 执行一次的红石时钟,或者用数据包 tick 函数控制频率。
计分板显示在线人数的常见坑
- 虚拟玩家名不要和真实玩家重名,用
#online这类带符号的名字更稳妥。 - 命令方块方向要正确,循环方块后面接链方块,箭头方向别放反。
- 权限和作弊状态要开启,单人存档或测试世界先
/gamerule commandBlockOutput false减少刷屏。 - 不同服务端核心对
execute store result返回值处理可能有差异,建议先用简单累加方案测试,再决定是否用返回值方案。
mc服务器在线人数显示插件哪个好:PlaceholderAPI 加 TAB 组合实操
插件组合与变量
如果你想让在线人数显示在 Tab 列表、侧边栏、Boss 栏或聊天前缀里,插件方案更稳,常见组合是:
- PlaceholderAPI:提供变量解析。
- TAB:控制 Tab 列表头部、尾部和玩家前缀。
- 计分板插件:把变量放进侧边栏。
操作路径:
- 把 PlaceholderAPI 和 TAB 放入
plugins文件夹,重启服务器。 - 控制台执行
papi ecloud download Server。 - 执行
papi reload。 - 在 TAB 配置里使用
%server_online%和%server_max_players%。
TAB 的配置文件中,把头部或尾部改成类似:
在线人数:%server_online%/%server_max_players%
保存后执行 tab reload,如果变量不解析,先检查 PlaceholderAPI 的 Server 扩展是否下载成功,再确认 TAB 是否依赖 PlaceholderAPI。
原版指令和插件方案怎么选
| 方案 | 适合场景 | 优点 | 限制 |
|---|---|---|---|
/list 指令 |
临时查询、后台排查 | 零配置、原版可用 | 不能常驻显示 |
| 计分板命令方块 | 原版生存服、轻量服 | 不装插件也能侧边栏显示 | 配置稍繁琐,基岩版语法有差异 |
| PlaceholderAPI + TAB | 插件服、需要 Tab 显示 | 变量灵活、可扩展 | 需要装插件和扩展 |
| RCON/网页查询 | 官网、QQ 机器人、面板 | 可外部展示 | 要处理端口安全和脚本 |
行业共识认为,插件服优先用 PlaceholderAPI 做变量层,再让 TAB 或计分板插件消费变量,后期换显示位置不用重写命令。
国内mc服务器在线人数显示方案:网页和机器人查询
RCON 定时查询与网页展示
不少服主想把在线人数放到官网或群里,稳妥做法是后端定时执行 RCON list,解析返回字符串,再把人数写入网页接口,路径如下:
- 服务端开启 RCON,限制来源 IP。
- 写一个定时任务,每 30 秒到 60 秒执行一次
list。 - 解析
There are X of a max of Y players online这类返回文本。 - 网页只读取后端缓存,不直接连 RCON。
如果只需要人数、不需要玩家名单,也可以用 Java 版 Server List Ping 协议读取 players.online,不必开 RCON,RCON 更适合需要玩家名单、执行后台命令的场景。
QQ 机器人查询在线人数
国内不少服务器用 QQ 群机器人做查询,常见链路是:机器人框架调用后端接口,后端通过 RCON 或 Server List Ping 获取人数,再返回文本,注意不要把 RCON 密码写进前端页面,也不要把 25575 端口直接映射到公网,机器人查询适合“玩家在群里发指令看人数”的场景,但要做好频率限制,避免被刷。
mc服务器在线人数显示插件收费吗:免费与付费差异
基础方案通常零成本:PlaceholderAPI、TAB 这类插件多数是开源免费的,RCON 查询也不需要额外授权,是否收费主要看两点:一是你用的面板或托管商是否把“在线人数展示”做成增值功能;二是某些整合插件、定制计分板或主题是否收费,开服新手可以先跑通免费组合,再根据是否需要多服同步、历史曲线、权限分级决定是否上付费工具。
权限、刷新频率和版本兼容的实操细节
权限节点与 OP 设置
- Java 版
/list默认多数玩家可用,但权限插件可能拦截,检查minecraft.command.list。 - 计分板命令方块需要 OP 或后台权限,普通玩家不要给命令方块权限。
- PlaceholderAPI 的
papi命令建议只给管理员。 - TAB 重载命令
tab reload通常需要控制台或管理员权限。
刷新频率和性能
计分板每 tick 刷新会持续执行命令,玩家数量多、命令方块多时,建议把刷新间隔调到 20 tick 到 100 tick,插件显示在线人数一般 1 秒到 5 秒刷新一次就够,业内专家指出,在线人数展示本身开销不大,真正影响性能的是高频全服扫描和大量变量解析,配置时优先减少无必要的每秒刷新。
基岩版与 Java 版不要混用命令
Java 版 1.13 以后 execute 语法变化较大,基岩版的 execute 参数顺序也不同,网上搜到的命令要先看版本号,基岩版计分板同样可以创建 dummy 目标,但累加命令要按基岩版语法写,最稳的办法是在测试世界跑一遍,再复制到正式服。
mc服务器指令显示在线人数常见问题解答
mc服务器输入 /list 没反应或显示不全怎么办?
先看控制台是否返回正常,如果控制台正常、游戏内没反应,检查权限插件是否拦截 minecraft.command.list,如果只显示部分玩家,确认是否装了隐身插件或消失插件,这类插件会影响名单显示,Java 版还可以用 /list uuids 辅助排查。
不装插件,能用指令把在线人数显示在 Tab 列表吗?
原版 /scoreboard objectives setdisplay list online 可以把计分板目标显示在玩家列表区域,但它展示的是每个玩家的分数,不是“总人数”这一行,要把总人数固定显示在 Tab 头部或尾部,通常需要 TAB 这类插件或数据包配合,纯原版更稳的是侧边栏计分板方案。
网页查询在线人数需要开放哪些端口?
如果用 RCON,需要开放 RCON 端口,但只建议本机或内网访问,不要直接暴露公网,如果只用 Server List Ping 查人数,走的是 Minecraft 服务端游戏端口,通常是 25565,具体以你的 server.properties 中 server-port 为准,网页后端应做缓存和频率限制,避免频繁请求打到游戏服。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/788394.html


