用法

如何运行程序：

在 Windows 上运行
在 Linux 和 MacOS 上运行
使用 Docker 运行

使用命令行参数：

示例
命令行参数
内置命令

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 --help

MCC 还支持一些维护和调试参数，例如 --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。

book

注意

你需要启用物品栏处理才能使这个机器人工作.

描述：
Read the book in your main hand, or edit it if it is a writable book.
In TUI mode, /book read opens a page viewer instead of printing the whole book to chat. The same viewer also opens automatically when the server tells the client to open a book.
If you are holding a writable book, you can replace all pages, update one page, insert a page, delete a page, and sign the finished book.
使用方法：
Read the current book or a single page:
```
/book read [page]
```
Replace the whole writable book from inline text or a file:
```
/book write text <text>
/book write file <path>
```
Open the TUI editor or edit specific pages from the command line:
```
/book edit
/book edit page <page> <text>
/book edit insert <page> <text>
/book edit delete <page>
```
Sign the writable book in your main hand:
```
/book sign <title>
```
当翻译时，请优先使用《我的世界》游戏内的官方术语。如果玩家社区已广泛采用不同的术语，则应选择更易识别的用法。翻译应符合《我的世界》客户端工具领域的风格。
read works with a writable book or a written book in your main hand.
write, edit, and sign require a writable book in your main hand.
Use \n for line breaks and \f for page breaks when passing inline text.
MCC checks page count, page length, and title length against the current protocol before sending the packet.
The interactive editor is only available in TUI mode.
In the TUI book view, PageUp/PageDown switches pages.

示例：

Read the held book:

/book read

Show only page 2:

/book read 2

Write two pages from the command line:

/book write text First page\nSecond line\fSecond page

Load the book text from a file:

/book write file ./letter.txt

Replace page 3:

/book edit page 3 Updated text for page three

Insert a new page before page 2:

/book edit insert 2 This page goes before the old page 2

Delete page 4:

/book edit delete 4

Sign the current writable book:

/book sign Meeting Notes

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

描述：
从背包丢弃所有指定物品。
注意
你需要启用物品栏处理才能使这个机器人工作.
使用方法：
```
/dropitem <itemtype>
```
注意
所有物品可以在here找到。
示例：
```
/dropitem diamond
```

enchant

注意

你需要启用 Inventory Handling 才能使用这个功能.

描述：
允许使用附魔台附魔物品。
您需要先打开一个附魔台，然后在附魔台中放置您想要附魔的物品和青金石。然后您可以执行命令。
可以通过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
```

clear-console

描述：
Clear the visible console output.
In TUI mode this clears the log panel. In the classic console it clears the terminal screen.
使用方法：
```
/clear-console
/cc
```

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 才能使这个机器人工作.
警告
The Inventory Handling is currently supported on 1.8+ and is unavailable on 1.4.6 - 1.7.10.
使用方法：
```
/useitem
```
在特定方块上使用物品：
```
/useitem <x> <y> <z>
```

useblock

描述：
在特定位置放置方块或者打开容器。
- 箱子/陷阱箱
- 熔炉
- 酿造台
- 发射器/投掷器
- 漏斗
- 潜影盒
- 织布机
注意
您需要启用Inventory Handling和Terrain and Movements，才能使用这个功能
注意
并非每一个容器都有一个ASCII格式的GUI。
警告
The Inventory Handling is currently supported on 1.8+ and is unavailable on 1.4.6 - 1.7.10.
使用方法：
```
/useblock <x> <y> <z>
```
示例：
```
/useblock 43 72 7
```

follow

描述：
使机器人跟随指定玩家。
注意
此命令仅在启用跟随玩家聊天机器人时可用。
注意
你需要启用物品栏处理才能使这个机器人工作.
注意
你需要启用实体处理才能使此功能生效。
使用方法：
```
/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

描述：
用于物品栏管理。
注意
你需要启用物品栏处理才能使这个机器人工作.
警告
The Inventory Handling is currently supported on 1.8+ and is unavailable on 1.4.6 - 1.7.10.
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简化**
动作：
- click
- drop
显示/预览物品栏中的项目：
```
/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在物品栏中 /id 4的物品
```
/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
```

console-chat

描述：
Temporarily show or hide chat in the console.
This changes the current session only. If you want the same behavior every time MCC starts, use Console.General.Display_Chat.

使用方法：

/console-chat
/console-chat on
/console-chat off

示例：
Hide chat until you turn it back on:
```
/console-chat off
```
Show chat again:
```
/console-chat on
```

debug

描述：
切换调试消息，这对chat bot的开发人员很有用。

help

描述：
显示命令帮助。
注意
使用"/send /help" 获取服务器帮助