管理员命令速查表 · Minexa 说明书

朋友在游戏里喊“给我一组钻石”，你打开 Minexa 的终端，输入框就在那儿，但你不确定要不要打 /，也不确定 <玩家名> 这几个字要不要原样敲进去。命令本身不难，难的是在哪输入、谁能用、写了会不会生效。

这一页按场景把 Java 版常用命令排成表，每条都标了控制台写法和所需权限等级。表里的示例统一用控制台写法（不带 /）；游戏聊天框里每条前面加 / 即可。

查表时先认准一句话：表里的 <玩家名> 要换成真实名字，尖括号不能留。写错一个符号，命令会以 Unknown command 或 That player does not exist 收场，两者的处理方法完全不同。

本页要点

先分清在哪输入：游戏聊天框带 /，Minexa 的「MC 控制台」不带 /。
同一条命令敲了没权限，多半是 OP 等级不够，不是命令写错。
控制台不受 OP 等级限制，所以远程管理最省事。
带 @a、@e 的命令影响范围会放大，先在测试世界跑一遍。

三个输入位置，两种写法#

位置	要不要 `/`	权限从哪来	适合
游戏内聊天框	要，例如 `/op <玩家名>`	你账号的 OP 等级	边玩边管
Minexa 终端 →「MC 控制台」	不要，例如 `op <玩家名>`	控制台权限，等同服主	手机远程管理
服务器控制台 / RCON	不要	控制台权限	电脑运维

只有「MC 控制台」接收 Minecraft 命令。终端里的 Termux 1 是 Linux shell，敲 op 只会提示找不到程序。服务端没运行时，控制台命令会被静默丢弃。

在 Minexa 里输入命令

底部导航点「终端」，切到「MC 控制台」会话，回执会直接刷在同一个窗口里。发完没反应，先看服务端是否在运行。

命令语法里的符号也有固定含义：

写法	含义
`<玩家名>`	必填，替换成真实名字，不输入尖括号
`[原因]`	可选，不写也能执行
`@p` / `@a` / `@r` / `@s`	最近玩家 / 所有玩家 / 随机玩家 / 自己
`@e`	所有实体，包括动物、掉落物、盔甲架
`~ ~ ~`	相对坐标，`~` 表示当前位置

权限等级：为什么同一条命令你敲就没权限#

原版命令的权限跟着 OP 等级走，等级不够，命令拼对了也会被拒绝：

能做的事	最低等级	典型命令
普通玩家功能	0	`list`、`tell`、`help`
绕过出生点保护	1	无专用命令，影响破坏/放置
作弊类	2	`give`、`tp`、`gamemode`、`time`
管理类	3	`op`、`kick`、`ban`、`whitelist`
维护类	4	`stop`、`save-all`、`reload`

op-permission-level 决定新 OP 的默认等级，默认是 4。装了权限插件时，插件可能接管命令权限，这时加 OP 等级没有用，要去查权限组。

权限与玩家管理#

whitelist 是“门禁”，op 是“给钥匙”，要分开做：先 whitelist add，再 whitelist on，顺序反了可能把自己锁在外面。

命令	作用	示例	等级
`op <玩家名>`	授予 OP（按默认等级）	`op <玩家名>`	3
`deop <玩家名>`	取消 OP	`deop <玩家名>`	3
`whitelist add\|remove <玩家名>`	加入 / 移出白名单	`whitelist add <玩家名>`	3
`whitelist on` / `off` / `list`	开 / 关 / 查看白名单	`whitelist on`	3
`kick <玩家名> [原因]`	踢出，还能再进	`kick <玩家名> 挂机太久`	3
`ban <玩家名> [原因]`	永久封禁	`ban <玩家名> 破坏建筑`	3
`ban-ip <IP或玩家名>`	封禁 IP	`ban-ip 192.168.1.9`	3
`pardon <玩家名>` / `pardon-ip <IP>`	解除封禁	`pardon <玩家名>`	3
`banlist [players\|ips]`	查看封禁列表	`banlist`	3
`list`	在线人数与名单	`list`	0

传送、位置与物品#

tp 后面写坐标是绝对坐标，~ 才是相对坐标；跨维度传送要先传维度再给坐标。<物品> 建议带 minecraft: 前缀，模组服同名物品多，容易给错。

命令	作用	示例	等级
`tp <玩家名> <目标玩家名>`	把 A 传到 B 身边	`tp <玩家名> <目标玩家名>`	2
`tp <玩家名> <x> <y> <z>`	传到指定坐标	`tp <玩家名> 100 64 200`	2
`spawnpoint [玩家名] [x y z]` / `setworldspawn`	设个人重生点 / 世界出生点	`spawnpoint <玩家名>`	2
`spreadplayers <x> <z> <最小距离> <最大范围> <是否随机> <目标>`	把玩家分散到附近	`spreadplayers 0 0 10 50 false @a`	2
`worldborder set <直径>` / `center <x> <z>`	设世界边界大小 / 中心	`worldborder set 2000`	2
`give <玩家名> <物品> [数量]`	给物品	`give <玩家名> minecraft:diamond 64`	2
`clear <玩家名> [物品] [数量]`	清空背包或某物品	`clear <玩家名> minecraft:dirt`	2
`xp add <玩家名> <数量> [levels\|points]`	给经验	`xp add <玩家名> 30 levels`	2
`gamemode <模式> [玩家名]`	切换游戏模式	`gamemode creative <玩家名>`	2
`effect give <玩家名> <效果> [秒] [等级]`	给状态效果	`effect give <玩家名> minecraft:speed 60 1`	2
`enchant <玩家名> <附魔> [等级]`	给手持物品附魔	`enchant <玩家名> minecraft:sharpness 5`	2

模式名可写 survival、creative、adventure、spectator 或 0–3。effect 的等级从 0 起算，写 1 是二级效果；enchant 只作用于手持物品。

时间、天气与规则#

规则名和值区分大小写，keepInventory 写成 keepinventory 会提示找不到规则。

命令	作用	示例	等级
`time set day` / `night`	设为白天 / 夜晚	`time set day`	2
`time add <数量>`	时间前进若干刻	`time add 1000`	2
`weather clear` / `rain` / `thunder`	放晴 / 下雨 / 雷雨	`weather clear`	2
`difficulty <难度>`	改难度	`difficulty normal`	2
`gamerule <规则> <值>`	改游戏规则	`gamerule keepInventory true`	2
`seed`	查看世界种子	`seed`	2

新手服最值得先改的是 gamerule keepInventory true：死亡不掉落，能省掉大量“装备没了”的纠纷。

世界、方块与实体#

这一组会真的改世界，执行前先 save-all，重要建筑先备份；fill、clone 这类范围命令先用小范围测试。

命令	作用	示例	等级
`kill <目标>`	清除实体	`kill @e[type=minecraft:item]`	2
`summon <实体> [x y z]`	生成实体	`summon minecraft:zombie 0 64 0`	2
`setblock <x> <y> <z> <方块>`	放置单个方块	`setblock 0 64 0 minecraft:stone`	2
`fill <x1> <y1> <z1> <x2> <y2> <z2> <方块>`	填充区域	`fill 0 64 0 10 64 10 minecraft:stone`	2
`clone <x1> <y1> <z1> <x2> <y2> <z2> <目标x> <目标y> <目标z>`	复制区域	`clone 0 64 0 10 70 10 20 64 0`	2
`execute as <玩家名> at @s run <命令>`	以某玩家为执行者运行	`execute as <玩家名> at @s run tp @s 0 64 0`	2
`say <消息>` / `tell <玩家名> <消息>`	全服公告 / 私聊	`say 五分钟后重启`	2
`title <玩家名> title <文本>`	屏幕中央标题	`title <玩家名> title 欢迎`	2
`bossbar add <id> <名称>`	新建 Boss 血条	`bossbar add minexa:event "活动"`	2

保存、维护与信息#

命令	作用	示例	等级
`save-all`	立即保存世界	`save-all`	4
`save-off` / `save-on`	暂停 / 恢复自动保存	`save-off`	4
`stop`	保存并关闭服务端	`stop`	4
`reload`	重载插件或数据包	`reload`	4
`tps`	查看服务器 TPS	`tps`	Paper/Spigot
`help [命令]`	查看命令帮助	`help give`	0

tps 需要 Spigot/Paper 系核心；reload 在 Bukkit 系重载插件、在原版重载数据包。/reload 不能当重启用，风险见插件安装、启停与排错。

改完会留在文件里吗#

命令	改了什么	重启后
`op` / `deop`	`ops.json`	保留
`whitelist add` / `remove`	`whitelist.json`	保留
`ban` / `pardon`	`banned-players.json`	保留
`whitelist on` / `off`	当前运行状态	回到 `server.properties` 的 `white-list`
`save-off`	当前自动保存状态	恢复自动保存
`give` / `gamemode` / `effect`	玩家数据	随玩家存档保留
`time` / `weather`	当前世界状态	随世界存档恢复

端口、人数上限、MOTD、正版验证这些没有对应命令，只能改 server.properties 再重启。命令适合“现在立刻生效”，配置适合“以后一直这样”。

高频 10 条：复制就能用#

把下面整段粘进「MC 控制台」，逐条执行，<玩家名> 换成真实名字、尖括号删掉。

Minecraft 命令

list
op <玩家名>
whitelist add <玩家名>
tp <玩家名> 0 64 0
give <玩家名> minecraft:diamond 64
gamemode creative <玩家名>
time set day
weather clear
save-all
stop

把 <玩家名> 换成选择器就能一次操作多人：give @a minecraft:bread 16、gamemode adventure @a、kill @e[type=minecraft:item]（只清掉落物）。选择器还能加距离限制，例如 @a[distance=..10] 只选 10 格内的玩家。

最后一条 stop 会关服，确认没人在玩再执行；聊天框里每条前面加 /。

选择器写错，影响范围会放大

@a 和 @e 是“所有人/所有实体”。一条 kill @e 可能把全服的掉落物、动物、展示框一次清空；一条 tp @a 可能把正在打 BOSS 的人全部拉走。带选择器的命令，先在单人测试世界跑一遍。

危险命令、版本差异与报错#

Minexa 终端只对三条命令做二次确认，且是精确匹配：stop、kill @e[type=!player]、whitelist off。多一个空格、少一个参数，都不会弹确认框。

stop：保存并关闭服务端，所有玩家断开。
kill @e[type=!player]：清除除玩家外的所有实体，掉落物、村民、盔甲架全没，清掉就找不回来。
whitelist off：白名单立刻失效，知道地址的人都能进。

动手前先备份

kill @e 清掉的可能不止掉落物，还有别人养了一周的村民交易站。whitelist off 之后如果地址暴露在公网，几分钟内就可能有人进来。执行前先手动打一份备份；只想清掉落物，就用 kill @e[type=minecraft:item]。

版本差异也要留意：

1.13 起 /execute 改成子命令式，旧教程的 execute <实体> <x> <y> <z> <命令> 不再适用。
1.13 起 部分 gamerule 名称改为驼峰写法（如 keepInventory），大小写敏感。
1.20.5 起 give 的物品 NBT 改为组件语法，照抄旧教程的 {...} 会报错。
/tp 与 /teleport、/xp 与 /experience 是同义命令，两套写法都能用。
这份表是 Java 版命令；基岩版（PowerNukkitX 等）是另一套命令，不能直接套用。

报错怎么查#

提示	意思	怎么处理
`Unknown command`	命令不存在、拼错，或核心不支持	查拼写；确认是不是插件命令
`You do not have permission`	OP 等级不够，或被权限插件拒绝	提高等级或查权限组
`That player does not exist`	名字错，或人不在线	从在线列表复制名字
`No player was found`	选择器没匹配到目标	确认 `@p` / `@a` 有人在线
发了完全没反应	服务端没运行，命令被静默丢弃	回概览启动服务端

中文输入法的全角空格和全角斜杠看起来和英文一样，命令却会解析失败，敲之前切到英文输入法。

上机自查

在「MC 控制台」输入 list 有回执，能看到在线玩家名字。
在游戏聊天框输入 /list 也能用，说明你账号有基础权限。
给朋友 op 之后，他能执行 /gamemode creative，不再提示没权限。
whitelist add 加上某人、再 whitelist on 之后，名单外的人进不来。

下一步#

命令的实战讲法与输出解读：管理员命令速查与实战
命令在哪输入、终端怎么用：终端与控制台
白名单、OP、封禁的完整规则：白名单、OP 与封禁管理