Minexa说明书
基础配置与管理

管理员命令速查与实战

给 OP、传送、给物品、改时间、保存档、踢人、白名单……40 条能直接复制的命令,以及在哪输入。

朋友在群里喊:“给我两组钻石,再把我传到出生点。”你人在外面,手里只有手机。打开 Minexa 的终端,光标在输入框里闪,你却不确定——要不要打 /?<玩家名> 要不要带尖括号?为什么昨天还能用的命令,今天提示没有权限?

这一页把常用管理命令按用途整理成能直接抄的表,每条写清语法、一个示例,以及敲错会不会踢人甚至停服。表里的命令都是原版或常见插件、核心确实提供的;哪条不是原版会单独标出。

本页要点
  • 位置决定写法:游戏内要打 /,Minexa 控制台不用打。

  • 玩家、世界、存档三组命令能覆盖 90% 的日常管理。

  • 会出事的只有三条:stop、kill @e[type=!player]、whitelist off,终端会弹二次确认。

  • 概览的「停止」就是发 stop:最多等 180 秒,超时不会强杀。

  • 装插件请用重启,/reload 只是应急。

命令在哪里输入:三种位置,两种写法#

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

一句话:游戏内要 /,控制台不要 /。Minexa 会自动去掉开头的 /,两种写法都发得出去,但只有游戏内才需要斜杠。

别在 Termux 会话里发 MC 命令

终端有两个会话:「MC 控制台」和「Termux 1」,只有 MC 控制台接收 Minecraft 命令。页面没有连接状态提示,服务端没运行时命令会被静默丢弃——发完没反应,先回概览看是不是在运行。

语法与权限:<玩家名> 和 1~4 级#

<玩家名> 必填,尖括号只是占位,不要真打出来;op <玩家名> 实际输入是 op Steve。[原因] 可选,中间带空格也不用加引号。@p 最近的玩家、@a 所有人、@r 随机一人、@s 自己、@e 所有实体(含动物、掉落物)。~ ~ ~ 是相对坐标,tp Steve ~ ~10 ~ 把人抬高 10 格。

名字要照抄游戏内显示的样子:离线模式下 Steve 和 steve 是两个不同 UUID,白名单和 OP 会对不上。作用于在线玩家的命令(give、tp、gamemode、xp、kick)目标不在线会报“找不到玩家”;op、whitelist add、ban 则可以直接写离线名字。

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

你想做的事至少需要
绕过出生点保护1
/give、/tp、/gamemode、/time 等作弊类2
/op、/deop、/kick、/ban 等管理类3
/stop、/save-all、/reload 等维护类4

控制台不受等级限制。op-permission-level 决定新 OP 的默认等级(默认 4);手动指定 OP 等级后,要重启才会按手动等级生效。装了权限插件时命令可能被插件接管——OP 明明是 4 级还说没权限,去查插件的权限组,别继续往上加等级。细节见 白名单、OP 与封禁管理。

玩家管理:加 OP、管白名单、封人#

用途语法一个示例风险
给 OPop <玩家名>op Steve等于交出拆服权
取消 OPdeop <玩家名>deop Steve—
加入白名单whitelist add <玩家名>whitelist add Steve—
移出白名单whitelist remove <玩家名>whitelist remove Steve名单开着会当场被踢
看名单whitelist listwhitelist list—
开 / 关白名单whitelist on / offwhitelist onoff 等于开门
重读名单文件whitelist reloadwhitelist reload—
踢出kick <玩家名> [原因]kick Steve 挂机太久还能再进
永久封禁ban <玩家名> [原因]ban Steve 破坏建筑名字错就封错人
封 IPban-ip <IP或玩家名>ban-ip 192.168.1.9可能误伤同网段
解除封禁pardon <玩家名>pardon Steve—
解除 IP 封禁pardon-ip <IP>pardon-ip 192.168.1.9—
在线名单listlist—

whitelist on 只锁门、不添人,顺序必须是先 add 再 on,反了会把自己锁在外面。list 的回执还会校正 Minexa 玩家页的在线人数——应用就是靠这行判断谁在线的,页面上的按钮操作见 玩家页:在线、OP、白名单与封禁。

封禁前先确认名字

ban 拼错一个字母,被踢下线的可能是另一个人,真正捣乱的人还在。封禁前从 list 的输出里复制名字;封错了能用 pardon 解,但已经被踢走的人不会自动回来。

世界与时间:改时间、天气、难度和规则#

用途语法一个示例
设为白天 / 夜晚time set day / nighttime set night
时间前进time add <数量>time add 1000
放晴weather clearweather clear
下雨 / 雷雨weather rain / thunderweather thunder
改难度difficulty <难度>difficulty hard
改游戏规则gamerule <规则> <值>gamerule keepInventory true
设世界出生点setworldspawn <x> <y> <z>setworldspawn 0 64 0
查世界种子seedseed

gamerule keepInventory true 是新手服最值得改的一条:死亡不掉落,能省掉大量“装备没了”的纠纷。doDaylightCycle false 会冻结昼夜,适合建筑服,但依赖夜晚的玩法就没得玩了。规则名照抄大小写,keepInventory 不能全小写;拿不准就先只打 gamerule,让服务端把规则全列出来。

setworldspawn 不带坐标就设在脚下;spawnpoint <玩家名> 设的是个人重生点。不同版本的规则名会增减,完整清单见 server.properties 全项速查表。

传送、物品与模式:一次给一群人#

用途语法一个示例
A 传到 B 身边tp <玩家名> <目标玩家名>tp Steve Alex
传到指定坐标tp <玩家名> <x> <y> <z>tp Steve 100 64 200
回出生点spawnspawn
设个人重生点spawnpoint <玩家名>spawnpoint Steve
给物品give <玩家名> <物品> [数量]give Steve minecraft:diamond 64
给经验xp add <玩家名> <数量> [levels|points]xp add Steve 30 levels
换游戏模式gamemode <模式> [玩家名]gamemode creative Steve
给状态效果effect give <玩家名> <效果> [秒] [等级]effect give Steve minecraft:speed 60 1
清背包clear <玩家名> [物品] [数量]clear Steve minecraft:dirt

spawn 不是原版命令,来自传送类插件(Bukkit 服常见的 Essentials 类),提示 Unknown command 不是拼错,是没人提供它。tp 的坐标是绝对坐标,要相对位移就得用 ~。物品和效果名带 minecraft: 前缀最稳,模组服里同名物品很多;enchant <玩家名> <附魔> [等级] 只对当前手持的物品生效,手里空着会失败。gamemode 模式名可写 survival、creative、adventure、spectator 或 0–3。

把 <玩家名> 换成选择器,就能一次对一群人执行:

Minecraft 命令
give @a minecraft:bread 16
gamemode adventure @a
tp @a 0 64 0
选择器写错,影响范围会放大

@a / @e 是“所有人 / 所有实体”。kill @e 会把掉落物、动物、展示框一次清空,tp @a 会把正在打 BOSS 的人全部拉走。带选择器的命令先在小号测试服跑一遍;只想清掉落物,就用 kill @e[type=minecraft:item]。

存档与数据:save-all 和两个开关#

用途语法什么时候用
立即保存save-all备份、改配置、关服前
暂停自动保存save-off只有长时间复制文件时
恢复自动保存save-on用完立刻补上
save-off 之后忘了 save-on,丢的不止几分钟

关了自动保存,世界就停止写盘。save-off 后必须马上 save-on,否则崩溃那一刻的进度全没了。做整服备份前,应用会先发一次保存命令,但不会替你关自动保存;备份与还原的步骤见 备份策略与恢复演练。

哪些命令改的东西留得住,按这张表记:

命令改了什么重启后
op / deop、whitelist add / remove、ban / pardonops.json、whitelist.json、banned-players.json保留
whitelist on / off当前运行状态不保留,回到配置里的 white-list
give、gamemode、time、weather玩家数据、世界状态跟着存档走

所以端口、人数上限、MOTD、正版验证都没有对应命令,只能改 server.properties 再重启;想长期开白名单,也要把 white-list=true 写进配置。

服务器控制:stop、reload 与公告#

用途语法一个示例注意
保存并关服stopstop立刻断开所有人
重载reloadreload语义按核心不同
全服公告say <消息>say 五分钟后重启所有在线玩家可见
私聊tell <玩家名> <消息>tell Steve 来一下只有对方可见

在概览页点「停止」,等于替你发 stop:先存档再退出,最多等 180 秒,超时不会强杀,只提示你可以点「强制停止」,而强制停止会丢掉未保存的数据。应用没有独立的重启按钮——先停止,看到状态变成未运行,再点启动。

reload 在 Bukkit 系核心上是重载插件,在原版上是重载数据包,语义完全不同;/reload 只是应急,装插件请重启,热重载留下半个旧类是常见故障来源,见 插件安装、启停与排错。

二次确认只认三条精确命令

终端只对 stop、kill @e[type=!player]、whitelist off 弹确认框,而且是精确匹配:多一个空格、把后者写成 kill @e,都会直接发出去。后者会清掉除玩家外的所有实体,动手前先手动备份。

调试与报错:tps 不是原版命令#

命令看什么谁提供
tps每秒游戏刻,20 是满分Spigot / Paper 系核心,原版没有
mspt每刻耗时,单位毫秒部分核心或性能插件,视版本而定

发 tps 提示 Unknown command 很正常,原版核心确实没有这条命令。TPS 持续低于 15 就该查了,先降视距再看内存,见 TPS 与 MSPT。mspt 同样不是原版命令,只有部分核心或性能插件提供,它比 TPS 更早暴露卡顿。

命令的回执能说明问题,对照下表能少走弯路:

提示意思怎么处理
Unknown command拼错、命令不存在,或核心不支持检查拼写,确认是不是插件命令
You do not have permission…OP 等级不够,或被权限插件拒绝提等级或查权限组
That player does not exist名字错,或人不在线从 list 里复制名字
No player was found选择器没匹配到人确认 @p / @a 有目标
Expected ...参数类型或数量不对对照语法,一次只改一处
发了完全没反应服务端没运行,命令被静默丢弃回概览启动服务端

中文输入法还有个坑:全角空格和全角斜杠看着像英文,命令却会解析失败。切英文输入法再敲。

上机自查
  • 在「MC 控制台」发 list,能收到 There are N of a max of M players online 这样的回执。

  • whitelist list 里有你自己的名字,whitelist on 之后你仍然进得去。

  • gamerule keepInventory 改成 true 后,死一次装备还在。

  • tps 能返回数字(原版核心提示 Unknown command 属于正常)。

  • 知道 save-off 之后要立刻 save-on,没有让它一直关着。

  • 关服走的是概览的「停止」,不是从系统任务里划掉应用。

下一步#

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

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