用法
如何运行程序:
使用命令行参数:
Windows
只需运行 MinecraftClient.exe
提示
在 Windows 上,最好使用 Windows Terminal 获取最佳体验和外观。 部分功能例如 /chunk 命令中的表情符号等在 CMD 或 Powershell 5 中无法正常显示
Linux, macOS
运行MCC需要您在终端输入以下命令:
./MinecraftClient如果您想要在后台运行它,您可以使用screen(仅限Linux)
示例:
# 启动一个名为 mcc 的 screen 会话
screen -S mcc
# 运行 Minecraft 客户端
./MinecraftClient
# 按下 Ctrl + A,然后按 D 键,从 screen 会话中分离
# 如果想重新连接,可以使用以下命令
screen -r mcc了解更多关于如何使用屏幕命令的信息: YouTube
Docker
参考 使用 Docker 运行
命令行用法
Minecraft 控制台客户端包含多个实用的命令行参数。 本节涵盖了最重要的内容。
对于不熟悉命令行的人
命令行基础介绍
对于不熟悉命令行程序的人(终端),在这里,我们将解释每个步骤,如果您熟悉相关内容,您可以选择跳过。
在命令行(终端)中,您可以使用程序名称+启动参数的方式运行程序,通常程序有额外的启动参数,用不同的启动参数启动程序是通过命令行实现的。
启动参数是在程序名称之后写的,用空格分隔,可以有几种不同的方式,例如:
someparameter-some-parameter--some-other-parameter--some-setting="some value"-a=5
单个破折号的参数(-)通常表示单个参数(简写),双破折号的参数(--)通常用于一个较长/全名的参数。
当您阅读例子时,您常常会看到这样的<something here>,这意味着这是一个参数,应该使用一定的值。输入的参数不应含有<``>
例如,<username>您需要修改为您喜欢的用户名,例如:notch(< 和 > 不应该包括在内)
[ 和]代表这个是可选参数。
它们还可以具有某些值,用MCC举个例子:
MinecraftClient.exe --debugmessages=false当一个参数内含有空格时,您需要使用英文的双引号("),例如:--some-parameter="一些参数具有空格"
下面是使用--help参数的例子,它会使MCC显示如何使用MCC的界面。
MinecraftClient.exe --helpMCC 还支持一些维护和调试参数,例如 --upgrade、--force-upgrade、--generate、--keyboard-debug、BasicIO 和 BasicIO-NoColor。
通过示例快速使用 MCC
注意
在 Linux 和 macOS 上,您需要输入:./MinecraftClient 而不是 MinecraftClient.exe
MinecraftClient.exe --help
MinecraftClient.exe <username> <password> <server>
MinecraftClient.exe --setting=value [--other settings]
MinecraftClient.exe --section.setting=value [--other settings]
MinecraftClient.exe <settings-file.ini> [--other settings]注意
Microsoft 帐户使用 OAuth 2.0 设备码流程,无需在命令行中输入密码。 MCC 会显示一个验证码和一个 URL,供您通过浏览器登录(支持完整的双重身份验证)。 你可以直接留空密码,或使用 "" 作为占位符。**
示例:
# Microsoft account: connect to a server (you will sign in via device code in your browser)
MinecraftClient.exe player@example.com "" mc.someserver.com:25565
# Offline account: connect with a chosen username
MinecraftClient.exe Steve - mc.someserver.com:25565
# Overriding a setting from MinecraftClient.ini using a command-line parameter
MinecraftClient.exe --debugmessages=false
# Providing a custom settings file and overriding the language to Chinese
MinecraftClient.exe CustomSettingsFile.ini --language=zh使用命令行参数的规则:
你可以按照以下规则混合搭配参数:
- 第一个参数可以是登陆参数或者是设置文件.
- 其他位置参数按顺序读取:用户名、 密码、 服务器、 命令.
- 以
--开头的参数可以放在任何顺序和位置。
例子和解释:
MinecraftClient.exe <login> <password> <server>- 将会自动连接到您选定的服务器。
- 您可以不写密码或者服务器,例如只写用户名。
- 对于 Microsoft 帐户,无需输入密码(使用设备码流程)。 该句子出自 Minecraft 控制台客户端 (MCC),这是一款用于《我的世界》Java 版的文本型客户端。内容包括应用界面字符串、机器人/自动化配置、内部命令、状态消息,以及涵盖物品栏、地形、实体、合成、移动、服务器连接和 CLI/配置主题的用户文档。 翻译时,请优先使用《我的世界》游戏内的官方术语。若玩家社区已广泛采用其他术语,则应选用更易识别的用法。请按照《我的世界》客户端工具领域的风格进行翻译。 如需指代服务器,请使用
""作为占位符。 - 如果要使用离线模式登入,请在使用
-作为密码。
MinecraftClient.exe <login> <password> <server> "/mycommand"- 将会自动发送
/mycommand到服务器并自动关闭。 - 如需发送多条命令或保持连接,请改用
ScriptScheduler机器人。
MinecraftClient.exe <myconfig.ini>- 这将会加载指定的配置文件。
- 如果文件中包含登录信息或服务器 IP,程序将自动连接。
- 对于 Microsoft 帝国账号,认证采用设备码流程进行(配置文件中无需填写密码)。
MinecraftClient.exe --setting=value [--other settings]- 在命令行指定MCC的设置,请到配置文件查看对应的值。
- 使用
--section.setting=value用于设置[Main]以外的设置。 - 例如:
-antiafk.enabled=true将会启用反挂机检测功能。
MinecraftClient.exe <myconfig.ini> <login> <password> <server> [--other settings]- 加载指定的配置文件并覆盖配置文件中的一些设置。
内置命令
这些命令可以从聊天、脚本或远程控制中执行。
从聊天中执行的命令前默认必须加/,例如 /quit
在脚本和远程控制充,执行命令不需要加/,例如 quit
注意
一些命令可能尚未被记录或在ChatBots的描述中定义, 使用 "/help" 列出所有命令,或您可以为此页面做出贡献。
animation
描述:
切换主手(mainhand)/副手(offhand)。
使用方法:
/animation <mainhand|offhand>
achievement
描述:
显示当前 MCC 已知的成就或进度。
在 Minecraft
1.8至1.11.2版本中,MCC 会追踪旧版成就,例如achievement.openInventory。在 Minecraft
1.12+版本中,MCC 会追踪诸如minecraft:story/root等成就。使用方法:
/achievement /achievement list /achievement locked /achievement unlocked示例:
列出 MCC 当前已知的所有内容:
/achievement仅显示未完成的条目:
/achievement locked仅显示已完成条目:
/achievement unlocked当翻译时,优先使用《我的世界》游戏内的官方术语。如果玩家社区已广泛采用不同的术语,则应选择更易识别的用法。翻译应符合《我的世界》客户端工具领域的风格。
该命令仅显示服务器已发送至 MCC 的数据。
旧版成就在协议中不包含标题和描述,因此较老的服务器通常会直接显示原始 ID。
bed
描述:
让您的机器人睡觉,所有与睡觉有关的都在这个命令。
使用方法:
基本用法:
bed leave|sleep <x> <y> <z>|sleep <radius>示例:
离开床:
/bed leave在坐标为124 84 76 的床上睡觉:
/bed sleep 124 84 76使用相对坐标睡在床上:
/bed sleep ~ ~ ~-2在50个方块半径内自动寻找一张床并睡在上面:
/bed sleep 50
blockinfo
注意
您需要启用 地形和移动处理 才能使用这个命令。
描述:
显示指定位置的方块类型。
如果使用
-s选项,它还会报告周围方块的类型。使用方法:
基本用法:
/blockinfo <x> <y> <z> [-s]
bots
描述:
允许您列出和卸载指定机器人或所有机器人。
在调试和开发脚本时非常有用。
使用方法:
/bots <list|unload <bot name|all>>示例:
卸载名为 CustomScript 的机器人
/bots unload CustomScript卸载所有机器人
/bots unload all
changeslot
描述:
更改当前选择的快捷栏
注意
你需要启用 物品栏处理 才能使这个机器人工作.
使用方法:
/changeslot <1-9>
chunk
描述:
用一种很好的方式显示区块的加载状态。
警告
要使用此功能,您需要启用 地形处理和移动处理
注意
** 您需要一个支持emoji表情的终端,例如 Powershell 7,Windows Terminal或者Alacritty,如果您的终端不支持emoji表情或者是使用cmd或Powershell 5,禁用表情符号
enableemoji**使用方法:
/chunk status [chunkX chunkZ|locationX locationY locationZ]它的外观

dig
描述:
在指定坐标上挖掘一个方块。
使用方法:
/dig <x> <y> <z>示例
/dig 127 63 12使用相对坐标:
/dig ~ ~-1 ~2
dropitem
enchant
注意
你需要启用 物品栏处理 才能使这个机器人工作.
描述:
允许使用附魔台附魔物品。
您需要先打开一个附魔台,然后在附魔台中放置您想要附魔的物品和青金石。然后您可以执行命令。
可以通过
useblock命令来打开附魔台。使用方法:
基本用法:
/enchant <top|middle|bottom>
effects
描述:
列出当前应用到你角色身上的状态效果。
使用方法:
/effects
entity
描述:
攻击一个实体,使用一个实体或者获取您周围的实体类型。
使用方法:
基本用法:
/entity <id|entitytype> <attack|use>获取周围的实体类型:
/entity注意
您可以在这里找到所有的实体名称:[here]https://mccteam.github.io/r/entity/#L15).
示例:
攻击一个僵尸:
/entity Zombie attack
execif
描述:
在满足指定条件时执行指定命令。
条件是一个C#表达式,可以使用
set,setrnd或配置文件设置的本地变量。状态总是以布尔值形式返回,仅可以进行比较,如果需要,请将表达式结果强制转换为 bool。
MCC 的实例也可以与
MCC一起使用。注意
在应用程序中,所有局部变量都被视为字符串,在比较其值时,你可以使用
<variable> == "<value>",或者使用.Equals方法使用方法:
基本用法:
/execif <condition (C# expression)> <command>示例:
设置变量并使用它:
/set test=Something /execif 'test == "Something"' "send Success!"/set test2=1 /execif 'test2 == "1"' "send Success 2!"基本 C# 表达式:
/execif "1 + 2 + 3 == 6" "send Success!"使用 MCC 的类:
/execif "MCC.GetHealth() == 20.0" "send Success!"与
execmulti结合使用:/execif "1 == 1" "execmulti send 1 -> send 2 -> send 3"注意
如果表达式中包含双引号 (
"),可用单引号 (') 将其括起来也可在双引号前加反斜杠(
\),例如/execif "test == \"Something\"" "send Success!"
execmulti
描述:
允许您单行中了连续执行多个命令,推荐用于调试或者
execif。命令被
->分隔使用方法:
基本用法:
execmulti <command 1> -> <command 2> -> <command 3> ->...示例:
/execmulti send 1 -> send 2 -> send 3 -> sneak
quit
别名:
exit描述:
断开与服务器的连接并关闭MCC
reco
描述:
断开并重新连接服务器
使用方法:
/reco [account]注意
[account]是指设置文件中账户列表中定义的账户别名,查看关于accountlist的用法
reload
描述:
重新加载当前配置文件和聊天机器人。
注意
部分设置无法重新加载,因为它们在客户端初始化之前就被使用了。 命令行中传递的设置也会覆盖配置文件中的值。
使用方法:
/reload
recipebook
描述:
列出已解锁的合成表条目,并请求服务器将其中一条放入当前合成栏。
注意
您需要启用物品栏管理才能使此命令生效。
注意
craft和craftall需要有可用的玩家工作台、熔炉、高炉、烟熏炉或石匠工作台界面。警告
合成表制作在 Minecraft 1.13 及更高版本中支持。
list会显示 MCC 当前正在追踪的合成表条目。在较新的版本中,列表可以包含数字形式的显示 ID,而非简单的配方名称。 当看到类似
838: 橡木木板的条目时,请使用838结合craft或craftall命令。craft和craftall会向服务器发送配方书请求。 它们不会自动帮你拾取合成结果物品。 配方出现在活动背包后,像处理其他背包操作一样取出输出栏位中的物品即可。使用方法:
/recipebook list/recipebook craft <recipe id>/recipebook craftall <recipe id>示例:
显示当前追踪的合成表条目:
/recipebook list请求一个合成表位置:
/recipebook craft minecraft:oak_planks在较新版本中,请使用
/recipebook list命令显示的数字ID:/recipebook craftall 838如果将合成配方放入玩家的合成网格,请从槽位
0取出结果:/inventory player click 0
connect
描述:
连接到指定的服务器并重启脚本。
使用方法:
/connect <server> [account]注意
<server>在配置文件中的服务器列表[serverlist]中定义了服务器的IP及别名,查看关于serverlist的相关信息注意
[account]是指设置文件中账户列表中定义的账户别名,查看关于accountlist的用法
script
描述:
运行一个包含命令的脚本(文本文档)。
使用方法:
/script <script name>
send
描述:
发送一个聊天消息或者命令到服务器。
使用方法:
/send <text>
respawn
描述:
如果您死了,请使用它来重生(相当于点击游戏中的重生)。
使用方法:
/respawn
log
描述:
在控制台显示一些日志(对于脚本有用)
使用方法:
/log <text>示例:
/log this is some text
list
描述:
显示服务器的玩家列表(相当于在服务器中按下Tab的查看玩家列表)
使用方法:
/list
tab
描述:
以比
/list更详细的格式显示当前玩家列表。在经典控制台中,
/tab会打印出包含延迟和玩家名称的彩色表格。 队伍前缀、后缀和显示名称会在服务器发送时应用。在 TUI 模式下,
/tab会打开一个实时叠加层,该叠加层在可见时会自动刷新。 按Esc键关闭。如果需要单独的队伍列,请启用 Console.TabList.ShowTeams。
使用方法:
/tab当翻译时,请优先使用《我的世界》游戏内的官方术语。如果玩家社区已广泛采用不同的术语,则应选择更易识别的用法。翻译应符合《我的世界》客户端工具领域的风格。
/tab使用服务器发送的标签页列表信息,因此在服务器标签页中被隐藏的玩家不会在此处显示。- TUI 叠加层会跟随实时玩家列表,因此玩家加入、离开、延迟更新以及记分板队伍更新都会直接显示,无需重新打开。
set
描述:
设置一个值
%variable%(类似变量名),可以用在后面的命令中。使用方法:
/set <variable>=<value>示例:
/set abc=123
setrnd
描述:
设置
%variable%为A-B的随机值。使用方法:
/setrnd <variable> string1 "\"string2\" string3"示例:
/setrnd <variable> -7 to 10(设置一个从-7到10的数字变量
%variable%)
sneak
描述:
切换到潜行。
使用方法:
/Sneak
tps
描述:
获取服务器 TPS (每秒Tick数)
使用方法:
/tps
teams
描述:
列出服务器发送的所有记分板队伍及其成员和设置。
使用方法:
/teams示例输出:
队伍 ‘RedTeam’(显示名:RedTeam,颜色:12,前缀:空,后缀:空,名字标签可见性:始终可见,碰撞规则:始终碰撞,友军伤害:开启,可见隐形生物:开启) 成员(2人):Steve、Alex 队伍 ‘BlueTeam’(显示名:BlueTeam,颜色:9,前缀:空,后缀:空,名字标签可见性:始终可见,碰撞规则:始终碰撞,友军伤害:开启,可见隐形生物:开启) 无成员。
useitem
描述:
使用你手中的物品,包括像用铲子平整方块这样的交互动作。
注意
你需要启用 Inventory Handling 才能使用这个功能.
警告
Inventory Handling 目前不支持
1.4.6 -- 1.9使用方法:
/useitem在特定方块上使用物品:
/useitem <x> <y> <z>
useblock
描述:
在特定位置放置方块或者打开容器。
- 箱子/陷阱箱
- 熔炉
- 酿造台
- 发射器/投掷器
- 漏斗
- 潜影盒
- 织布机
注意
您需要启用Inventory Handling和Terrain and Movements,才能使用这个功能
注意
并非每一个容器都有一个ASCII格式的GUI。
警告
Inventory Handling不支持
1.4.6 - 1.9.使用方法:
/useblock <x> <y> <z>示例:
/useblock 43 72 7
follow
描述:
使机器人跟随指定玩家。
注意
此命令仅在启用跟随玩家聊天机器人时可用。
注意
您需要启用Inventory Handling 才能使这个机器人工作.
注意
你需要启用实体处理才能使此功能生效。
使用方法:
/follow <player name|stop>示例:
/follow milutinke
wait
描述:
等待 X 格(20 格 ≈ 1 秒)。 仅限脚本中使用)
使用方法:
固定时间:
/wait <time>随机时间:
/wait <最短时间> to <最长时间>提示
你可以使用
-代替to示例:
/wait 20/wait 20 to 100/wait 20-35
move
描述:
在启用地形和移动功能后进行简单的移动。
注意
您需要启用[Terrain and Movements]](configuration.md#terrainandmovements)才能使其工作
警告
“1.4.6-1.6”中当前不支持[Terrain and Movements](configuration.md#terrainandmovements)
使用方法:
/move <on|off|get|up|down|east|west|north|south|center|x y z|gravity [on|off]> [-f]: walk or start walking. "-f":强制不安全的动作,例如摔落或触碰火焰。示例:
启用重力
/move gravity on移动到坐标:
/move 125 72 34移动到方块中央;
/move center
nameitem
描述:
此命令允许您在打开铁砧物品栏和第一个插槽(插槽号0)中的项目时命名项目,(插槽的概念见下方库存管理)
将物品放入砧座的第一个槽后,使用此命令,然后单击槽2以从砧座中获取物品,然后单击物品栏中的空槽。
使用方法:
/nameitem <name of the item>示例:
/nameitem My super duper sword 2000带铁砧的完整示例:
# 打开铁砧 /useblock 12 74 321 # 点击容器中槽位12的斧头 /inventory container click 12 # 将斧头放入铁砧的槽位0 /inventory container click 0 # 设置新名称 /nameitem 我的花式斧头 # 点击铁砧中槽位2的斧头 /inventory container click 2 # 将斧头放回你的背包槽位12 /inventory container click 12 # 关闭铁砧 /inventory container close
look
描述:
启用地形和移动后可指定视野方向
使用方法:
/look <x y z|yaw pitch|up|down|east|west|north|south>示例:
/look up/look east
inventory
描述:
用于物品栏管理。
注意
你需要启用 物品栏处理 才能使这个机器人工作.
警告
Inventory Handling不支持
1.4.6 - 1.9.MCC将物品栏定义为内部容器,所以玩家的物品栏、箱子、投掷器、发射器、漏斗、箱子矿车,木桶、熔炉等等,都被视为容器,每个容器都有它自己的ID,“容器”和“物品栏”两个词可以互换使用。
物品栏内的每一个物品框都有对应的ID
注意
这个命令并不会去打开一个容器 (例如箱子),你需要先使用
useblock去打开容器。一个用有ASCII码表示的物品框ID和物品列表的玩家背包:

使用方法:
基本用法:
/inventory <player|container|<id>> <action> [action parameters] | /inventory <inventories/i> | /inventory <search/s> <item type> [amount]注意
** player 和 container 可以相应地用p和c简化**
动作:
clickdrop
显示/预览物品栏中的项目:
/inventory <player|id>左键单击/shift+左键单击物品栏中的一个物品:
/inventory <player|container|<id>> <click> <slot id> [left|right|middle|Shift|ShiftRight]注意
如果不指明,默认左键单击
关闭当前容器
/inventory <player|container|<id>> close从容器/背包中丢出物品
/inventory <player|id> drop <slot id> <number of items|all>注意
要从指定物品框中丢出所有物品,可以使用:
all从创造玩家的背包中拿出指定物品
/inventory creativegive <slot id> <item type> <amount>注意
所有物品id可以在here找到。
在创造模式下的玩家的背包中删除物品:
/inventory creativedelete <slot id>显示所有的物品栏:
/inventory inventories在物品栏中搜索指定类型的物品:
/inventory search <item type>示例:
显示玩家的物品栏:
/inventory player使用id显示/预览项目:
/inventory 3单击玩家背包内物品栏id为
36的物品:/inventory player click 36右键单击 /id
2在物品栏中 /id4的物品/inventory 2 click 4 right关闭一个id为
2的物品栏:/inventory 2 close掉落玩家的物品栏中编号是 /id
36的物品:/inventory player drop 36 1掉落玩家的物品栏中的全部编号是 /id
37的物品:/inventory player drop 37 all从创造玩家的背包中拿出指定物品
/inventory creativegive 36 diamondblock 64注意
所有物品id可以在here找到。
在创造模式下删除玩家的物品栏中编号 /id
36的物品/inventory creativedelete 36在可用的物品栏中搜索10个史莱姆方块:
/inventory s SlimeBlock 10
debug
描述:
切换调试消息,这对chat bot的开发人员很有用。
help
描述:
显示命令帮助。
注意
使用"/send /help" 获取服务器帮助
