指令機器人

關於

Minecraft Console Client has a number of default built in Chat Bots (Scripts/Plugins) which allow for various types of automation.

Note

**設定時可以參考 configuration 文件中的 configuration.md **

指令機器人的內建列表

指令機器人

提醒

描述：
在聊天中檢測到指定字詞時收到提醒
用於緩和您的服務器或檢測何時有人在和你說話。
設定:
變數: ChatBot.Alerts
All settings
Enabled
- Description:
  是否讓 Alerts Chat Bot 開啟？
- 選擇的值: true 和 false.
- 類型: boolean
- 默認: false
Beep_Enabled
Note
這是否起作用，取決您的作業系統或控制台 (terminal emulator)。
- 描述:
  在此可更改是否想在收到警報時，聽到蜂鳴聲。
- 類型: boolean
- 默認值: true
Trigger_By_Words
- 描述:
  在收到指定的關鍵詞後觸發提醒。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Trigger_By_Rain
- 描述:
  在開始下雨和停止下雨時觸發提醒。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Trigger_By_Thunderstorm
- 描述:
  在雷暴天氣的開始與結束觸發提醒。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Log_To_File
- 描述:
  如為true，則警報機器人開始記錄日誌。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Log_File
- 描述:
  如果 Log_To_File 被設定為 true，提醒的內容將被記錄到此檔案中。
- 類型: string
- 預設為 "alerts-log.txt".
Matches
- 描述：
  觸發提醒的聊天關鍵詞列表。
- 類型: array of strings
- 範例:
```
Matches = [ "Yourname", " whispers ", "-> me", "admin", ".com", ]
```
Excludes
- 描述：
  出現這些關鍵詞後該條訊息一定不觸發提醒。
- 類型: array of strings
- 範例:
```
Excludes = [ "myserver.com", "Yourname>:", "Player Yourname", "Yourname joined", "Yourname left", "[Lockette] (Admin)", " Yourname:", "Yourname is", ]
```

反掛機踢出（Anti AFK）

描述:
定期發送命令或讓機器人隨機走動，以防止掛機檢測。
設定:
變數: ChatBot.AntiAFK
All settings
Enabled
- 描述:
  設定是否啟用反掛機檢測。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Delay
- Description:
  執行操作的間隔時間。（秒）
  如果 Min and max 是相同的，間隔將是一致的。然而，如果情況不相同，外掛將在 Min 和 Max之間選擇一個隨機數，如果你想要用隨機的間隔來防止Anti AFK外掛，這將會有幫助。
- 格式： { min = <秒>, max = <秒> }
- 型別： 列表
- 默認值: { min = 60.0, max = 60.0 }
Command
- 描述:
  要發送的金額。
- 類型: string
- 默認值: /ping
Use_Sneak
- Description:
  如果不能夠欺騙Anti AFK，請啟用。
- 類型: boolean
- 默認值: false
Use_Terrain_Handling
Note
您需要在設定中啟用地形處理，建議將機器人放入圍欄中，以免走失。 (推薦大小 5x5x5)
- 描述:
  如果機器人使用地形處理而不是命令方法，請啟用。
  這將使你的機器人能夠隨機移動，從而產生更好的效果。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Walk_Range
- 描述:
  機器人將用來行走的範圍 (-X 到 +X 和 -Z 到 +Z, 不使用 Y)。
  機器人計算路徑的速度可能較慢，建議設定為2-5。
- 默認值: 5
Walk_Retries
Note
任務的每個執行點都會觸發此設定，因此它不能夠永久切換到其他方法。
- 描述:
  這是機器人嘗試路徑的次數，如果他無法找到20次有效的路徑，他將使用命令方法。
- Default: 20

自動攻擊（Auto Attack）

Note

你需要先將這些功能啟用 inventoryhandling and entityhandling 好讓自動化腳本運作

描述：
自動攻擊人物周圍的怪物，你也可以在MinecraftClient.ini文件中設定參數，讓人物攻擊指定的怪物和生物。
設定:
變數: ChatBot.AutoAttack
All settings
Enabled
- 描述：
  是否讓 Auto Attack Chat Bot 啟用
- 選擇的值: true 和 false.
- 類型: boolean
- 默認: false
Mode
- Description:
  可用值
  - single
    每次只攻擊一隻怪物。
  - multi
    每次都攻擊一群怪物。
- 類型: string
- 默認值: single
Priority
- 描述：
  可用值
  - health （優先針對生命值較低的生物）
  - distance （優先瞄準距離近的暴徒）
- 類型: string
- 默認值: distance
Cooldown_Time
- Description:
  每次攻擊之間等待的時間，以秒為單位。
  啟用它, 設 Custom (boolean) to true 和更改 value (double) 為你的首選值 (eg. 1.5).
  By default, this is disabled and MCC calculates it based on the server TPS.
- 格式: Cooldown_Time = { Custom = <is enabled (true|false)>, value = <seconds (double)> }
- 類型: inline table
- 範例: Cooldown_Time = { Custom = true, value = 1.5 }
- 默認值: { Custom = false, value = 1.0 }
Interaction
- 描述：
  選擇的值:
  - Attack
    只攻擊怪物 (默認值)
  - Interact
    只與怪物互動
  - InteractAt
    邊攻擊邊跟怪物互動
- 類型: string
- 默認值: Attack
Attack_Hostile
- 描述:
  是否啟動 Auto Attack Chat Bot 讓人物攻擊敵對生物。
- 選擇的值: true 和 false
- 類型: boolean
- 默認值: true
Attack_Passive
- 描述：
  是否啟動 Auto Attack Chat Bot 讓人物攻擊被動生物。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
List_Mode
- 描述:
  此設定值為 Entites_List 用於更改 Auto Attack Chat Bot 的使用模式。
- 可用的值: whitelist (只攻擊列表中的怪物) and blacklist (不攻擊列表中的怪物).
- 類型: string
- 默認值: false
Entites_List
- 描述:
  白名單或黑名單的生物列表，可在List_Mode中更改。
  你可以在這列表中找到所有生物名稱 Here.
- 格式: ["<entity type>", "<entity type>", ...]
- 類型: string
- 範例: [ "Spider", "Skeleton", "Pig", ]
- 默認值: false

自動合成（Auto Craft）

Note

您需要啟用物品欄處理才能開啟自動合成，此外，如果您想使用工作臺，還需要啟用地形移動，機器人才能去到工作臺

Description:
自動合成功能的物品，會在你的背包中，或在合成臺中。
指令：
- /autocraft list
  列出所有可合成的配方。
- /autocraft start <name>
  使用您選擇的配方，來開始自動合成的功能。
- /autocraft stop
  停止合成功能。
- /autocraft help
  在遊戲中，開啟輔助提示。
設定:
變數: ChatBot.AutoCraft
All settings
Enabled
- 描述：
  您可在這選擇是否要請用"自動合成的功能"。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
CraftingTable
- Description:
  此設定指定了工作臺的位置。
- 格式：
  此設定是 列表 型別，具有以下子選項/設定；
  - x - X 座標，型別： 小數 (例如： 123.0)
  - y - Y 座標，型別： 小數 (例如： 64.0)
  - z - Z 座標，型別： 小數 (例如： 456.0)
- 例如：
```
CraftingTable = { X = 123.0, Y = 65.0, Z = 456.0 }
```
OnFailure
- 描述：
  此設定指定了自動合成機器人在合成失敗時，應做些什麼。
  當沒有可用的材料，或無法使用工作臺時，可能會失敗。
- 有效值： abort和 wait。
- 類型： string
- 默認值： abort
設定默認配方
Note
如果你需要使用工作臺，你需要設定 CraftingTable 。
配方定義可以在 [ChatBot.AutoCraft] 底下的選項[[ChatBot.AutoCraft.Recipes]]中被找到。
[[ChatBot.AutoCraft.Recipes]] 部分需要包含以下設定：
- 名稱
  你的配方名稱可以是你喜歡的任何值。
  型別：string
- 型別
  Available values: player and table
- Result
  This is the type of resulting item.
  類型: string
  Example: "StoneBricks"
- Slots
  This setting is an array/list of material names (strings) that go into an each slot (max 9 elements). Empty slots should be marked with "Null"
  類型: array of strings
  格式:
```
Slots = [ "<material/item type>", "<material/item type>", ... ]
```
  Slots are indexed as following:
  2x2 (Player)
```
╔═══╦═══╗
║ 1 ║ 2 ║
╠═══╬═══╣
║ 3 ║ 4 ║
╚═══╩═══╝
```
  3x3 (Crafting Table)
```
╔═══╦═══╦═══╗
║ 1 ║ 2 ║ 3 ║
╠═══╬═══╬═══╣
║ 4 ║ 5 ║ 6 ║
╠═══╬═══╬═══╣
║ 7 ║ 8 ║ 9 ║
╚═══╩═══╩═══╝
```
這些是範例
```
# Stone Bricks using the player inventory
[[ChatBot.AutoCraft.Recipes]]
Name = "Recipe-Name-1"
Type = "player"
Result = "StoneBricks"
Slots = [ "Stone", "Stone", "Stone", "Stone", ]

# Stone Bricks using a crafting table
[[ChatBot.AutoCraft.Recipes]]
Name = "Recipe-Name-2"
Type = "table"
Result = "StoneBricks"
Slots = [ "Stone", "Stone", "Null", "Stone", "Stone", "Null", "Null", "Null", "Null", ]
```
小提示
If you have a case where you have to leave some fields empty, use "Null" to mark them as empty. Example for stone bricks: Slots = [ "Stone", "Stone", "Null", "Stone", "Stone", "Null", "Null", "Null", "Null", ]
All item types can be found here.
Make sure to provide materials for your bot by placing them in inventory first.

自動挖礦

描述:
Automatically digs block on specified locations.
Note
You need to have inventoryhandling and terrainandmovements enabled in order for this bot to work.
Note
Since MCC does not yet support accurate calculation of the collision volume of blocks, all blocks are considered as complete cubes when obtaining the position of the lookahead.
指令：
- /digbot start - Starts the digging
- /digbot stop - Stops the digging
設定:
Section: ChatBot.AutoDig
All settings
Enabled
- 描述:
  This setting specifies if the Auto Dig Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Mode
- 描述:
  This setting specifies in which mode the Auto Dig Chat Bot will operate.
- 可用值
- lookat
  Digs the block that the bot is looking at.
- fixedpos
  Digs the block in a fixed location/position/coordinate.
- both
  Dig only when the block you are looking at is in the "Locations" list.
- 類型: string
- Default: lookat
Locations
- 描述:
  This setting specifies an array/list of locations which the bot will dig out.
- 類型/格式:
  The type of this setting is an array of inline table which has the following sub-options/settings:
  - x - X coordinate, the type is double (eg. 123.45)
  - y - Y 座標，型別： 小數 (例如： 64.0)
  - z - Z coordinate, the type is double (eg. 234.5)
- 完整範例 :
```
Locations = [
   { x = 123.5, y = 64.0, z = 234.5 },
   { x = 124.5, y = 63.0, z = 235.5 },
]
```
Location_Order
- Description:
  This setting specifies in which order the Auto Dig Chat Bot will dig blocks.
- 可用值
  - distance
    Digs the block closest to the bot.
  - index
    Digs blocks in the list order.
- 類型: string
- 默認值: distance
Auto_Start_Delay
- Description:
  How many seconds to wait after entering the game to start digging automatically.
  Set to -1 to disable the automatic start.
- 類型: float
- Default: 3.0
Auto_Tool_Switch
- Description:
  Automatically switch to a more suitable tool from your inventory before digging.
  When Durability_Limit is above zero, tools below that durability threshold are skipped.
- Available values: true and false
- 類型: boolean
- 默認值: false
Durability_Limit
- Description:
  Will not use tools with less durability than this.
  Set to 0 to disable this durability check.
- 類型: integer
- 默認值: 2
Drop_Low_Durability_Tools
- Description:
  Drop the replaced tool if its remaining durability is below Durability_Limit.
  This setting is only useful when Auto_Tool_Switch is enabled.
- Available values: true and false
- 類型: boolean
- 默認值: false
Dig_Timeout
- Description:
  If mining a block takes longer than this value, a new attempt will be made to find a block to mine.
- 類型: float
- Default: 60.0
Log_Block_Dig
- Description:
  This setting specifies whether to output logs in to the console when digging blocks.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
List_Type
- Description:
  This setting specifies the mode at which the Blocks setting is operating.
- Available values: whitelist (only dig specified blocks) and blacklist (do not dig specified blocks).
- 類型: string
- 默認值: false
Blocks
- Description:
  This setting specifies the list of blocks which either should not should not be dug out.
  The list of block types can be found here.
- Format: [ "<block type>", "<block type>", ...]
- 類型: array of strings
- Example: Blocks = [ "DiamondOre", "RedstoneOre", "EmeraldOre", "RedstoneBlock" ]
- Default: [ "Cobblestone", "Stone", ]

自動丟棄（Auto Drop）

Description:
Automatically drop items you don't need from the inventory.
Note
You need to have inventoryhandling enabled in order for this bot to work
設定:
Section: ChatBot.AutoDrop
All settings
Enabled
- Description:
  This setting specifies if the Auto Drop Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Mode
- Description:
  This setting specifies the mode of the auto dropping.
  可用值
  - include
    This mode will drop any items specified in the list in the Items setting.
  - exclude
    This mode will drop any other items than specified in the list in the Items setting.
    So it would keep the items specified in the list.
  - everything
    Drop any item regardless of the items listed in the Items setting.
- 類型: string
- Default: include
Items
Note
All item types can be found here.
- Description:
  This setting is where you can specify the list of items which you want to drop, or keep.
- Format: [ "<item type>", "<item type>", ...]
- 類型: array of strings
- Example: [ "Totem", "GlassBottle", ]
- Default: [ "Cobblestone", "Dirt", ]

自動進食（Auto Eat）

Description:
Automatically eat food when your Hunger value is low.
Note
You need to have inventoryhandling enabled in order for this bot to work
設定:
Section: ChatBot.AutoEat
All settings
Enabled
- Description:
  This setting specifies if the Auto Eat Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Threshold
- Description:
  Threshold bellow which the bot will auto eat.
- 類型: integer
- Default: 6

自動釣魚（Auto Fishing）

Description:
Automatically catch fish using a fishing rod. Bite detection combines bobber movement, bobber velocity, and splash sounds.
Note
You need to have entityhandling enabled in order for this bot to work.
Note
To use the automatic rod switching and durability check feature, you need to enable inventoryhandling.
Note
Note: To adjust the position or angle after catching a fish, you need to enable terrainandmovements.
小提示
A fishing rod with Mending enchantment is strongly recommended.
Steps for using this bot (with the default setting)
1. Hold a fishing rod and aim towards the sea before login with MCC
2. Make sure AutoFish is enabled in config file
3. Login with MCC
4. You will be able to see the log "Fishing will start in 3.0 second(s).".
設定:
Section: ChatBot.AutoFishing
All settings
Enabled
- Description:
  This setting specifies if the Auto Fishing Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Antidespawn
- Description:
  This option may be used in some special cases, so if it has not been modified before, leave the default value.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Mainhand
- Description:
  Whether to use the main hand or off hand to hold the rod.
- 可用值
  - true (Main Hand)
  - false (Off Hand)
- 類型: boolean
- 默認值: true
Auto_Start
- Description:
  Whether to start fishing automatically after joining the game or switching worlds.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Cast_Delay
- Description:
  Wait how many seconds after successfully catching a fish before recasting the rod.
- 類型: float
- Default: 0.4
Fishing_Delay
- Description:
  Effective only when auto_start = true.
  After joining the game or switching worlds, wait how many seconds before starting to fish automatically.
- 類型: float
- Default: 3.0
Fishing_Timeout
- Description:
  How long the fish bite is not detected is considered a timeout. It will re-cast after the timeout.
- 類型: float
- Default: 300.0
Durability_Limit
- Description:
  Will not use rods with less durability than this (full durability is 64).
  Set to zero to disable this feature.
  Type/Available values: An integer number from 0 to 64.
- 默認值: 2
Auto_Rod_Switch
- Description:
  在當前魚竿不可用後自動切換到背包中的其他魚竿。（需要啟用庫存處理）
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Stationary_Threshold
- Description:
  For each movement of the fishhook entity (entity movement packet), if the distance on both X and Z axes is below this threshold it will be considered as stationary.
  This is to avoid being detected as a bite during the casting of the hook.
  If set too high, it will cause the rod to be reeled in while casting.
  If set too low, it will result in not detecting a bite.
- 類型: float
- Default: 0.001
Hook_Threshold
- Description:
  For each movement of the fishhook entity (entity movement packet), if it is stationary (check stationary_threshold) and its movement on the Y-axis is greater than this threshold, it will be considered to have caught a fish.
  If it is set too high, it will cause normal bites to be ignored.
  If set too low, it can cause small fluctuations in the hook to be recognized as bites.
- 類型: float
- Default: 0.2
Enable_Velocity_Detection
- Description:
  Enables bite detection using the fishing bobber velocity packet.
  This improves reliability when bobber X/Z movement is constrained (for example by blocks near the water surface).
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Velocity_Hook_Threshold
- Description:
  Velocity Y threshold in blocks/tick for velocity-based bite detection.
  Values below this threshold are considered a bite. Keep this value negative.
- 類型: float
- Default: -0.2
Enable_Sound_Detection
- Description:
  Enables bite detection using nearby splash sounds (entity.fishing_bobber.splash).
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Sound_Distance
- Description:
  Maximum distance in blocks between a splash sound and the tracked bobber to treat it as a bite.
- 類型: float
- Default: 5.0
Detection_Warmup
- Description:
  Delay in seconds after bobber spawn before bite detection starts.
  This helps ignore the initial cast-entry splash/motion.
- 類型: float
- 默認值: 1.0
Log_Fish_Bobber
- Description:
  When turned on it will be print a log every time a fishhook entity movement packet is received.
  If auto-fishing does not work as expected, turn this option on to adjust stationary_threshold and hook_threshold, or create an issue and attach these logs.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Enable_Move
- Description:
  Some plugins do not allow the player to fish in one place for a long time. This setting allows the player to change position/angle after each catch.
  Each position is added as a new [[ChatBot.AutoFishing.Movements]] subsection, more on that bellow.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Adding a position/movement
Each position/movement is added as a new [[ChatBot.AutoFishing.Movements]] subsection of [ChatBot.AutoFishing].
Available settings/options:
- XYZ
  This setting specifies at location the bot should move to.
  The type of this setting is inline table, that has the following sub-settings/options:
  - x - X 座標，型別： 小數 (例如： 123.0)
  - y - Y 座標，型別： 小數 (例如： 64.0)
  - z - Z coordinate, the type is double (eg. -654.0)
  範例:
```
XYZ = { x = 123.0, y = 64.0, z = -654.0 }
```
- facing
  This setting specifies at which angle the bot will look at when he arrives to this position/location.
  The type of this setting is inline table, that has the following sub-settings/options:
  - yaw - The type is double (eg. 12.34)
  - pitch - The type is double (eg. -23.45)
  範例:
```
facing = { yaw = 12.34, pitch = -23.45 }
```
Full example
```
[[ChatBot.AutoFishing.Movements]]
facing = { yaw = 12.34, pitch = -23.45 }

[[ChatBot.AutoFishing.Movements]]
XYZ = { x = 123.45, y = 64.0, z = -654.32 }
facing = { yaw = -25.14, pitch = 36.25 }
```

自動重連（Auto Relog）

Description:
Make MCC automatically relog when disconnected by the server, for example because the server is restating.
設定:
Section: ChatBot.AutoRelog
All settings
Enabled
- Description:
  This setting specifies if the Auto Relog Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Delay
- Description:
  The delay time before joining the server.
  If the min and max are the same, the time will be consistent, however, if you want a random time, you can set min and max to different values to get a random time. The time format is in seconds, and the type is double. (eg. 37.0)
- Format: { min = <seconds (double)>, max = <seconds (double)> }
- 類型: inline table
- Example: { min = 8.0, max = 60.0 }
- Default: { min = 3.0, max = 3.0 }
Retries
Note
This might get you banned by the server owners.
- Description:
  Number of retries.
  Use -1 for infinite retries.
- Default: -1
Ignore_Kick_Message
- Description:
  This settings specifies if the Kick_Messages setting will be ignored, if set to true it will auto relog regardless of the kick messages.
- 類型: boolean
- 默認值: false
Kick_Messages
- Description:
  A list of words which should trigger the Auto Reconnect Chat Bot.
- Format: [ "<keyword>", "<keyword>", ... ]
- 類型: array of strings
- Default: [ "Connection has been lost", "Server is restarting", "Server is full", "Too Many people", ]

自動回覆信息

Description:
Run commands or send messages automatically when a specified pattern is detected in the chat.
注意
Server admins can spoof PMs (/tellraw, /nick) so enable AutoRespond only if you trust server admins.
注意
This bot may get spammy depending on your rules, although the global messagecooldown setting can help you avoiding accidental spam.
設定:
Section: ChatBot.AutoRespond
All settings
Enabled
- Description:
  This setting specifies if the Auto Respond Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Matches_File
Note
This file is not created by default, we recommend making a clone of the sample-matches.ini and changing it according to your needs.
注意
If you want to use variables from this chat bot in scripts, currently that does not work. You will have to use a C# script in that case. We are working on getting this functionality back.
- Description:
  This setting specifies the path to the file which contains the list of rules for detecting of keywords and responding on them.
  To find out how to configure the rules, take a look at the sample-matches.ini which has very detailed examples and a lot of comments.
  PS: In the future we will document the rules here with examples too.
- 類型: string
- Default: matches.ini
Match_Colors
Note
This feature uses the § symbol for color matching
- Description:
  This setting specifies if the Auto Respond Chat Bot should keep the color formatting send by the server.
  You can use this when you need to match text by colors.
  List of all color codes: here
- 類型: boolean
- 默認值: false

聊天紀錄

Description:
Make MCC log chat messages into a file.
設定:
Section: ChatBot.ChatLog
All settings
Enabled
- Description:
  This setting specifies if the Chat Log Chat Bot is enabled.
- 選擇的值: true 和 false.
- 默認值: false
Add_DateTime
- Description:
  This setting specifies if the Chat Log should prepend timestamps to the logged messages.
- 選擇的值: true 和 false.
- 默認值: true
Log_File
- Description:
  This setting specifies the name of the Chat Log file that will be created.
- Default: chatlog-%username%-%serverip%.txt
Filter
- Description:
  Type of messages to be logged into the file.
  可用值
  - all
    All text from the console
  - messages
    All messages, including system, plugin channel, player and server.
  - chat
    Only chat messages.
  - private
    Only private messages.
  - internal
    Only internal messages and commands.
- Default: messages

Discord 通訊

Description:
This Chat Bot allows you to send and receive messages and MCC commands via a Discord channel.
Setup:
In order for this to work you must create a Discord bot on the Discord Developers portal.
First go to Discord Developers portal, click on New Application, fill out the name of your bot and confirm the terms of service and click Create.
Copy the Application ID and save it somewhere.
Click on the Bot tab in the left menu.
Click on Add Bot
Click on the Reset Token button and copy the generated token, then paste it in the Token field in the MCC configuration.
Enable Message Content Intent, Server Members Intent and Presence Intent.

注意
Token is what gives you access to the Bot, do not share it with anyone and keep it safe!
注意
You must Enable Message Content Intent, Server Members Intent and Presence Intent for the bot to work!
Then go to Discord Permissions Calculator. Paste the Application Id that you've copied into the Client ID field, then Check/Enable the Administrator field in General Permissions section. Finally click on the Link down bellow and invite the Bot on to a server you want to interact with the MCC on.
Go to your Discord Client and go to Settings -> Advanced, Enable Developer Mode.
Then right click on a server where you invited the bot to in the server list and click on Copy ID, paste the copied id in GuildId in your MCC configuration.
Then right click on a channel where you want to interact with the bot and click on Copy ID, paste the copied id in ChannelId in your MCC configuration.
Send a message in that channel and right click on your nick and click Copy ID and paste the copied id in OwnersIds list setting in your MCC configuration.
Enable the bot by setting Enabled to true in your MCC configuration and start the MCC.
使用方法：
To send a message simply type it out in the Discord channel and press enter.
To execute a MCC command, you must prefix it with a dot (.). Example: .move 145 64 832
設定:
Section: ChatBot.DiscordBridge
All settings
Enabled
- Description:
  This setting specifies if the Discord Bridge Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Token
- Description:
  This is the token of your Discord bot.
- 類型: string
GuildId
- Description:
  This is the ID of your server/guild where you have invited the bot to.
- Type: unsigned long
ChannelId
- Description:
  This is the ID of a channel on your server/guild where you want to interact with the bot.
- Type: unsigned long
OwnersIds
- Description:
  This is a list of Discord user IDs which can interact with the bot.
- Type: list/array of: unsigned long
Message_Send_Timeout
- Description:
  How long (in seconds) to wait for a message to be sent to Discord before giving up.
- 類型: integer
- Default: 3
Allow_Other_Bot_Messages
- 說明:
  When enabled, messages from other Discord bots in the channel are relayed to Minecraft chat. The bridge always ignores its own messages to prevent loops.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
PrivateMessageFormat
- Description:
  The format used when someone sends you a private message on the server.
  Parts of the message between { and } are replaced by the Chat Bot at runtime; do not change them.
  {message} is replaced with the message text, {username} with the sender's name, and {timestamp} with the current date and time.
  For Discord message formatting, refer to this guide.
- 類型: string
- Default: **[Private Message]** {username}: {message}
PublicMessageFormat
- Description:
  The format used when sending a public message to the Discord channel.
  Parts of the message between { and } are replaced by the Chat Bot at runtime; do not change them.
  {message} is replaced with the message text, {username} with the sender's name, and {timestamp} with the current date and time.
  For Discord message formatting, refer to this guide.
- 類型: string
- Default: {username}: {message}
TeleportRequestMessageFormat
- Description:
  The format used when someone sends you a teleport request.
  Parts of the message between { and } are replaced by the Chat Bot at runtime; do not change them.
  {username} is replaced with the requester's name.
  For Discord message formatting, refer to this guide.
- 類型: string
- Default: A new Teleport Request from **{username}**!

Discord RPC

Description:
This Chat Bot shows your current Minecraft session as a Discord Rich Presence status. It displays information like the server address, your health, current dimension, coordinates, gamemode, and how long you have been connected.
注意
Discord RPC uses a local IPC socket to communicate with the Discord client. MCC and Discord must be running on the same machine for this to work.
Setup:
You need a Discord Application ID to use this bot. Here is how to get one:
1. Go to the Discord Developer Portal and click New Application.
2. Give it a name (this is what shows up in your Discord status, e.g. "Minecraft Console Client"), accept the terms, and click Create.
3. On the General Information page, copy the Application ID and paste it into the ApplicationId field in your MCC configuration.
4. (Optional) If you want a custom image in your status, go to the Rich Presence tab and click Art Assets. Upload an image and give it a name (the key). Use that key in the LargeImageKey or SmallImageKey settings. The default value mcc_icon references a built-in MCC icon already registered on the application -- no upload needed if you are happy with that.
5. Enable the bot by setting Enabled to true in your MCC configuration and start MCC with Discord already running.
Discord updates Rich Presence at most once every 15 seconds regardless of how often MCC sends updates, so you may notice a short delay before your status reflects changes.

設定:

Section: ChatBot.DiscordRpc

All settings

`Enabled`

Description:
This setting specifies if the Discord RPC Chat Bot is enabled.
選擇的值: true 和 false.
類型: boolean
默認值: false

`ApplicationId`

Description:
Your Discord Application ID. Create one at discord.com/developers/applications.
類型: string

`PresenceDetails`

Description:
The top line of the Rich Presence display. Supports placeholders (see below).
類型: string
Default: Playing on {server_host}:{server_port}

`PresenceState`

Description:
The second line of the Rich Presence display. Supports placeholders (see below).
類型: string
Default: {dimension} - HP: {health}/{max_health}

`LargeImageKey`

Description:
您上传到 Discord 應用程式的大型圖片資源的密鑰。 Leave empty to show no image.
類型: string
Default: mcc_icon

`LargeImageText`

Description:
Tooltip text shown when hovering over the large image. Supports placeholders (see below).
類型: string
Default: Minecraft Console Client

`SmallImageKey`

Description:
The key of the small image asset uploaded to your Discord application. Leave empty to hide the small image.
類型: string
Default: (empty)

`SmallImageText`

Description:
Tooltip text shown when hovering over the small image. Supports placeholders (see below).
類型: string
Default: (empty)

`ShowServerAddress`

Description:
Show the server address in the Discord presence. When set to false, {server_host} and {server_port} are replaced with Hidden and ****.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowCoordinates`

Description:
Show your coordinates in the Discord presence. When set to false, {x}, {y}, and {z} are replaced with ?.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowHealth`

Description:
Show health and food level in the Discord presence. When set to false, {health}, {max_health}, and {food} are replaced with ?.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowDimension`

Description:
Show the current dimension in the Discord presence. When set to false, {dimension} is replaced with Hidden.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowGamemode`

Description:
Show the current gamemode in the Discord presence. When set to false, {gamemode} is replaced with Hidden.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowElapsedTime`

Description:
Show how long you have been connected to the server as an elapsed time in the Discord presence.
選擇的值: true 和 false.
類型: boolean
默認值: true

`ShowPlayerCount`

Description:
Show the number of online players as a party size in the Discord presence.
選擇的值: true 和 false.
類型: boolean
默認值: true

`UpdateIntervalSeconds`

Description:
How often (in seconds) to refresh the Discord presence. Minimum value is 1.
Note: Discord itself only accepts presence updates once every 15 seconds, so setting this lower than 15 has no visible effect on the Discord side.
類型: integer
Default: 10

Placeholders

The following placeholders can be used in PresenceDetails, PresenceState, LargeImageText, and SmallImageText:

Placeholder	描述
`{server_host}`	Server hostname (masked if `ShowServerAddress` is `false`)
`{server_port}`	Server port (masked if `ShowServerAddress` is `false`)
`{username}`	Your Minecraft username
`{health}`	Current health (masked if `ShowHealth` is `false`)
`{max_health}`	Maximum health, always `20` (masked if `ShowHealth` is `false`)
`{food}`	Current food level (masked if `ShowHealth` is `false`)
`{dimension}`	Current dimension name, e.g. `Overworld` (masked if `ShowDimension` is `false`)
`{gamemode}`	Current gamemode, e.g. `Survival` (masked if `ShowGamemode` is `false`)
`{x}`	X coordinate (masked if `ShowCoordinates` is `false`)
`{y}`	Y coordinate (masked if `ShowCoordinates` is `false`)
`{z}`	Z coordinate (masked if `ShowCoordinates` is `false`)
`{player_count}`	Number of players currently online
`{protocol}`	Minecraft protocol version number

自動種植

Note

You need to have Terrain And Movements and Inventory Handling enabled in order for this bot to work.

注意

This a newly added bot, it is not perfect and was only tested in 1.19.2, there are some minor issues with it and you should treat it as an experimental bot.

Description:
This bot can farm crops for you. When you start it it will plant, break and bonemeal crops in order.
Supported crops:
- Beetroot
- Carrot
- Melon
- Netherwart
- Pumpkin
- Potato
- Wheat
Current list of issues:
- Sometimes the bot will not bone meal carrots/potatoes or melon/pumpkin stems (you will see it in a pattern of crops that have not been bonemealed)
- Sometimes the bot can jump on to the crops and break the farmland when coming form a different height, it's advised to keep the farming area flat and fenced off so the items to not fly out of the farming area
- If you have a farming platform that is 1 block thick and has air bellow, make it a few blocks thick because the bot can fall through sometimes when logging in and standing on farmland
- Sometimes the bot can be kicked for "invalid movement" packets when farming netherwart on soul sand, we haven't been able to figure why this happens in some parts of the world, while on other it's completely fine, it's advised to keep the farming area small and flat.
We're working on solving these issues.
What the bot does not do as of the time of writing, but are planned features:
- Does not collect items which fly off to the side, (it's advised to fence off the farming area with 2 high wall)
- Does not put items to the chest once the inventory is full
- Does not warn you when the inventory is full
- Does not refill inventory with seeds or bonemeal from chests by it self.
ℹ️ NOTE: The default radius of scanning is 30 blocks, we suggest that you do not use radius too big because it might slow down the bot. The bigger the radius, the slower the scanning and processing is.
指令：
When enabled will add the /farmer command.
Usage:
```
/farmer <start <crop type> [radius:<radius = 30>] [unsafe:<true/false>] [teleport:<true/false>] [debug:<true/false>]|stop>
```
Options marked with [ and ] are optional and in case of this command can have whatever order you prefer after the <crop type> field.
Options that have = means that the value after the = is a default value, in case of this command the default radius is 30 blocks.
範例:
Farming wheat in a radius of 40 blocks.
```
/farmer start wheat radius:40
```
Farming melon with debug output and direct teleporting:
```
/farmer start melon debug:true teleport:true
```
Stopping the bot:
```
/farmer stop
```
設定:
Section: ChatBot.Farmer
All settings
Enabled
- Description:
  This setting specifies if the Farmer Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Delay_Between_Tasks
- Description:
  This setting specifies the delay in seconds between each task performed by the bot.
- 類型: integer
- Default: 1
- Minimum: 1

Follow player

Description:
This bot enables you to make a bot follow a specific player.
Note
The bot can be slow at times, you need to walk with a normal speed and to sometimes stop for it to be able to keep up with you, it's similar to making animals follow you when you're holding food in your hand. This is due to a slow pathfinding algorithm, we're working on getting a better one. You can tweak the update limit and find what works best for you. (NOTE: Do not but a very low one, because you might achieve the opposite, this might clog the thread for terrain handling) and thus slow the bot even more.
Note
You need to have terrainandmovements and entityhandling enabled in order for this bot to work.
設定:
Section: ChatBot.FollowPlayer
All settings
Enabled
- Description:
  This setting specifies if the Follow Player Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Update_Limit
- Description:
  The rate at which the bot does calculations (second).
  You can tweak this if you feel the bot is too slow.
- 類型: float
- Default: 1.5
Stop_At_Distance
- Description:
  Do not follow the player if he is in the range of X blocks (prevents the bot from pushing a player in an infinite loop).
- 類型: float
- Default: 3.0

猜字謎

Description:
Hangman game is one of the first bots ever written for MCC, to demonstrate ChatBot capabilities.
Create a file with words to guess (examples: words-en.txt, words-fr.txt) and set it in config inside the [Hangman] section.
Also set enabled to true, then, add your username in the botowners INI setting, and finally, connect to the server and use /tell <bot username> start to start the game.
Note
If the bot does not respond to bot owners, see the Detecting chat messages section.
設定:
Section: ChatBot.HangmanGame
All settings
Enabled
- Description:
  This setting specifies if the Hangman Chat Bot is enabled.
- 選擇的值: true 和 false.
- 默認值: false
英文
- Description:
  This setting specifies if the Hangman Chat Bot should use English.
- 選擇的值: true 和 false.
- 默認值: true
FileWords_EN
Note
This settings file is for English and is not created by the default
- Description:
  This setting specifies the path to the file which Hangman will use for the list of words, each word is added on a separate line.
- Default: hangman-en.txt
- Example: words-en.txt
FileWords_FR
Note
This settings file is for French and is not created by the default
- Description:
  This setting is same as the above but for French.
- Default: hangman-fr.txt
- Example: words-fr.txt

郵差

描述：
Relay messages between players and servers, like a mail plugin.
This bot can store messages when the recipients are offline, and send them when they join the server.
The Mailer bot can store and relay mails much like Essential's /mail command.
- /tell <Bot> mail [RECIPIENT] [MESSAGE]: Save your message for future delivery
- /tell <Bot> tellonym [RECIPIENT] [MESSAGE]: Same, but the recipient will receive an anonymous mail
The bot will automatically deliver the mail when the recipient is online. The bot also offers a /mailer command from the MCC command prompt:
- /mailer getmails
  Show all mails in the console.
- /mailer addignored [NAME]
  Prevent a specific player from sending mails.
- /mailer removeignored [NAME]
  Lift the mailer restriction for this player.
- /mailer getignored
  Show all ignored players.
注意
The bot identifies players by their name (Not by UUID!). A nickname plugin or a Minecraft rename may cause mails going to the wrong player! Never write something to the bot you wouldn't say in the normal chat (You have been warned!).
注意
Server admins can spoof PMs (/tellraw, /nick) so enable RemoteControl only if you trust server admins.
Mailer Network:
- The Mailer bot can relay messages between servers.
- To set up a network of two or more bots, launch several instances with the bot activated and the same database.
- If you launch two instances from one .exe they should synchronize automatically to the same file.

設定:
Section: ChatBot.Mailer
Enabled
- 描述:
  This setting specifies if the Mailer Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
DatabaseFile
- 描述：
  This setting specifies the path to the file where the Mailer Chat Bot will store the mails.
  This file will be auto created by the Mailer Chat Bot.
- Default: MailerDatabase.ini
IgnoreListFile
- Description:
  This setting specifies the path to the file where the Mailer Chat Bot will load people who are to be ignored by the Chat Bot. If you want to prevent someone from using this chat bot, add him in this file by writing his nickname on a new line.
  This file will be auto created by the Mailer Chat Bot.
- Default: MailerIgnoreList.ini
PublicInteractions
- Description:
  This setting specifies if the Mailer Chat Bot should be interacted with in the public chat (in addition to private messages).
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
MaxMailsPerPlayer
- Description:
  This setting specifies how many mails the Mailer Chat Bot should store per player at maximum.
- 類型: integer
- Default: 10
MaxDatabaseSize
- Description:
  This setting specifies the maximum database file size of Mailer Chat Bot in Kilobytes.
- 類型: integer
- Default: 10000 (10 MB)
MailRetentionDays
- Description:
  This setting specifies how long should the Mailer Chat Bot save/store messages for (in days).
- 類型: integer
- 默認值: 30

MCP Server

Description:
This lets you control MCC from an AI agent such as Claude Code, Codex, Cursor, OpenCode and others.
Once enabled, your AI client can connect to the running MCC session and ask it to do things like read chat, check nearby players, move around, inspect inventories, or interact with entities.
The MCP server starts after MCC joins the game. By default it listens on http://127.0.0.1:33333/mcp.
This bot does not log in to Minecraft on its own. MCC still connects to the server normally first. The MCP part simply gives your AI agent a way to use the session that is already running.
We recommend protecting it with an auth token, even for local use.
注意
This feature is new and experimental, it still requires a lot of testing and polish. Please leave your feedback on our Discord server.
注意
The performance of task execution depends on how smart the LLM (Large Language Model) (e.g. Sonnet 4.6, GPT 5.4) and Harness/AI Agent (e.g. Claude Code) are.
Recommended harnesses / agents
- Claude Code
- Codex
- OpenCode
- Cursor
- Open Claw
Recommended models
Model rankings are based on the Agentic Intelligence Benchmark.
Frontier (best results, higher cost):
- Claude Opus 4.6
- GPT 5.4
- GLM-5 -- cheapest in this tier
Open-source (close to frontier, lower cost):
- MiMo-V2-Pro
- MiniMax M2.7 -- cheapest in this tier
- Kimi K2.5
Budget (good for medium and simpler tasks):
- Google Gemini 3 Flash -- recommended
- NVIDIA Nemotron 3 Super: free tier / paid tier / NVIDIA Build -- free tier may hit rate limits; your data is used for model training
- DeepSeek V3.2
Ultra-budget (for very simple tasks):
- Google Gemini 3.1 Flash Lite Preview
設定:
Section: ChatBot.McpServer
Quick start
1. Enable ChatBot.McpServer.
2. Set Transport.RequireAuthToken = true.
3. Export a token before starting MCC:
```
export MCC_MCP_AUTH_TOKEN="replace-me"
```
4. Leave Transport.BindHost = "127.0.0.1" unless you intentionally want to expose the endpoint to other machines.
5. Start MCC and join a Minecraft server.
6. Connect your AI client to http://127.0.0.1:33333/mcp.
The embedded host starts after the bot joins the game, not at process launch.
Tool availability still depends on MCC runtime support. Movement, inventory, and entity tools need the corresponding MCC features to be available for the current version and session.
Recommended config
```toml [ChatBot.McpServer] Enabled = true Transport = { BindHost = "127.0.0.1", Port = 33333, Route = "/mcp", RequireAuthToken = true, AuthTokenEnvVar = "MCC_MCP_AUTH_TOKEN" } Capabilities = { SessionStatus = true, ChatAndCommands = true, Movement = true, Inventory = true, EntityWorld = true } ```
For a local setup, keeping the bind host on 127.0.0.1 is the safest default.
We recommend enabling bearer-token protection and exporting the token before starting MCC:
```
export MCC_MCP_AUTH_TOKEN="replace-me"
```
All settings
Enabled
- Description:
  Enables or disables the built-in MCP server bot.
- 類型: boolean
- 默認值: false
Transport.BindHost
- Description:
  Hostname or IP address the embedded HTTP server binds to.
  Use 127.0.0.1 for local-only access. Binding to 0.0.0.0 exposes the endpoint to your network.
- 類型: string
- Default: 127.0.0.1
Transport.Port
- Description:
  TCP port used by the embedded HTTP MCP server.
- 類型: integer
- Default: 33333
Transport.Route
- Description:
  HTTP path used by the MCP endpoint.
- 類型: string
- Default: /mcp
Transport.RequireAuthToken
- Description:
  Require an Authorization: Bearer ... header before clients can use the server.
  Recommended: true
- 類型: boolean
- 默認值: false
Transport.AuthTokenEnvVar
- Description:
  Environment variable name MCC reads when bearer-token auth is enabled.
- 類型: string
- Default: MCC_MCP_AUTH_TOKEN
Capabilities.SessionStatus
- Description:
  Enables session, server, chat-history, event-history, reference, and status-reporting tools.
- 類型: boolean
- 默認值: true
Capabilities.ChatAndCommands
- Description:
  Enables chat sending, internal command execution, respawn, disconnect, quit, and related direct-control tools.
- 類型: boolean
- 默認值: true
Capabilities.Movement
- Description:
  Enables movement, path preview, look, reachability, and nearby block/player queries.
- 類型: boolean
- 默認值: true
Capabilities.Inventory
- Description:
  Enables inventory snapshots, container open/close, window actions, item selection, item use, drop, deposit, and withdraw tools.
- 類型: boolean
- 默認值: true
Capabilities.EntityWorld
- Description:
  Enables entity queries, sign search, block lookup, nearby dropped-item listing, and item pickup helpers.
- 類型: boolean
- 默認值: true
The client examples below assume the default local endpoint http://127.0.0.1:33333/mcp.
The recommended setup is to keep RequireAuthToken = true. If you temporarily disable auth for local testing, you can omit the auth-header parts.
Claude Code
Official docs: Claude Code MCP
These commands assume the default local MCC endpoint:
```
claude mcp add --transport http mcc http://127.0.0.1:33333/mcp
claude mcp list
```
If you enabled bearer-token auth in MCC:
```
claude mcp add --transport http mcc http://127.0.0.1:33333/mcp \
  --header "Authorization: Bearer $MCC_MCP_AUTH_TOKEN"
```
You can check the server status inside Claude Code with /mcp.
Codex
Official docs: OpenAI Docs MCP quickstart
Add the MCC server with the Codex CLI:
```
codex mcp add mcc --url http://127.0.0.1:33333/mcp
codex mcp list
```
You can also place it directly in ~/.codex/config.toml:
```
[mcp_servers.mcc]
url = "http://127.0.0.1:33333/mcp"
```
If your Codex setup supports custom MCP headers, add the same Authorization: Bearer ... header you use in the other examples.
Cursor
Official docs: Cursor MCP docs
Create ~/.cursor/mcp.json and add:
```
{
  "mcpServers": {
    "mcc": {
      "url": "http://127.0.0.1:33333/mcp"
    }
  }
}
```
Restart Cursor after saving the file.
If your Cursor setup uses auth headers for remote MCP servers, add Authorization: Bearer ... with your MCC token.
OpenCode
Official docs: OpenCode MCP servers
Put this in ~/.config/opencode/opencode.json for a global setup, or in opencode.json in your project root:
```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcc": {
      "type": "remote",
      "url": "http://127.0.0.1:33333/mcp",
      "enabled": true
    }
  }
}
```
If you enabled bearer-token auth in MCC, add headers like this:
```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mcc": {
      "type": "remote",
      "url": "http://127.0.0.1:33333/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:MCC_MCP_AUTH_TOKEN}"
      }
    }
  }
}
```
Available MCP tools
These are the tools currently exposed by ChatBot.McpServer.
Session, status, and reference
- mcc_session_status: Get the current MCC session state and feature availability.
- mcc_server_info: Get the active server connection info and current TPS.
- mcc_player_state: Get the current controlled-player state.
- mcc_world_state: Get world state, chunk loading progress, and last observed time and weather values.
- mcc_chunk_status: Check chunk loading status for the player location or a target coordinate.
- mcc_player_stats: Get player stats, orientation, and current location.
- mcc_status_effects: List active player status effects.
- mcc_loaded_bots: List loaded built-in bots and scripts.
- mcc_internal_commands_list: List available MCC internal commands.
- mcc_agent_guidance: Return the MCC MCP operator prompt bundle for external agents.
- mcc_materials_list: List known MCC material names.
- mcc_block_types_list: List known MCC block types.
- mcc_entity_types_list: List known MCC entity types.
- mcc_world_block_at: Get block information at a world coordinate.
Observed state
- mcc_recent_events: Read recent high-signal runtime events such as weather, titles, death, respawn, inventory open/close, and joins/leaves.
- mcc_chat_history: Read recent chat and system lines seen by MCC.
- mcc_players_list: List online players known to MCC.
- mcc_players_detailed: List tracked players with UUID, latency, gamemode, and coordinates when available.
Chat and direct control
- mcc_send_chat: Send chat text or a slash command to the server.
- mcc_quit_client: Quit MCC cleanly.
- mcc_disconnect: Disconnect MCC from the server without quitting the process.
- mcc_respawn: Respawn the controlled player when dead.
- mcc_run_internal_command: Run an MCC internal command.
- mcc_animation: Play a hand-swing animation.
- mcc_toggle_sneak: Start or stop sneaking.
- mcc_toggle_sprint: Start or stop sprinting.
- mcc_change_hotbar_slot: Change the active hotbar slot.
- mcc_select_item: Select a hotbar item by item type.
- mcc_use_item_on_hand: Use the currently held item.
- mcc_use_item_on_block: Use the held item on a target block.
- mcc_dig_block: Dig a block at a target location.
- mcc_place_block: Place the currently held block or item at a target location.
Movement, view, and nearby queries
- mcc_raycast_block: Raycast from the player's view and return the first non-air block hit.
- mcc_path_preview: Compute a path without moving there.
- mcc_block_scan: Scan nearby blocks around the player.
- mcc_blocks_find: Find nearby blocks by name, type, or ID.
- mcc_player_nearby: Check whether a player is nearby.
- mcc_player_locate: Locate a tracked player by name.
- mcc_entity_nearest: Find the nearest tracked entity that matches the requested filters.
- mcc_can_reach_position: Check whether MCC can path to a coordinate without moving there.
- mcc_move_to: Path to a world coordinate and verify arrival.
- mcc_move_to_player: Locate a tracked player, move to them, and verify arrival.
- mcc_look_at: Rotate the view toward a world coordinate.
- mcc_look_direction: Rotate the view to a cardinal direction or straight up/down.
- mcc_look_angles: Rotate the view to explicit yaw and pitch angles.
Inventory and container workflows
- mcc_inventory_snapshot: Read a snapshot of one inventory.
- mcc_inventory_search: Search the player inventory and optionally open containers for matching items.
- mcc_inventories_list: List open inventories and containers known to MCC.
- mcc_container_open_at: Open a container block at world coordinates and wait for its inventory.
- mcc_container_close: Close an open non-player container.
- mcc_inventory_window_action: Perform a window action on an inventory slot.
- mcc_inventory_drop_item: Drop an exact item count from an inventory.
- mcc_container_deposit_item: Move items from the player inventory into an open container.
- mcc_container_withdraw_item: Move items from an open container into the player inventory.
Entities, signs, and dropped items
- mcc_entities_query: Query tracked entities.
- mcc_entities_list: List tracked entities with optional filters.
- mcc_entity_info: Get detailed info for one tracked entity.
- mcc_entity_interact: Interact with a tracked entity.
- mcc_entity_attack: Attack a tracked entity.
- mcc_signs_find: Find nearby signs by text.
- mcc_items_list: List nearby dropped item entities.
- mcc_items_pickup: Move to and pick up nearby dropped items of a given type.
Simple example usage
Once your client is connected, keep the prompts simple and concrete.
- What server is MCC connected to right now?
- List online players and tell me whether Steve is nearby.
- Preview a path to 10 80 0. If the path looks valid, move there.
- Show my player inventory, then open the chest at 2 80 0 and tell me what is inside.
- List nearby dropped Stone items and pick them up.
- Find the nearest ArmorStand and show me its details.

地圖

Description:
This Chat Bot allows you to render items maps in the console, to .bmp images and to relay them to Discord using the Discord Bridge Chat Bot.
This is useful for solving captchas on servers which require it, or saving the map art into an image.
The maps are rendered into Rendered_Maps folder which will be auto created in the same folder where the client executable is located.
指令：
When enabled will add the /maps command.
Usage:
```
/maps <list/render <id>> | maps <l/r <id>>
```
設定:
Section: ChatBot.Map
All settings
Enabled
- Description:
  This setting specifies if the Map Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Render_In_Console
- Description:
  This setting specifies if the Map Chat Bot should render the map in the console.
  It is recommended to use something like Power Shell for the best map quality (at least for Windows users).
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Save_To_File
注意
If you want the Discord relay feature, you must enable this setting!
- Description:
  This setting specifies if the Map Chat Bot should render the map and save it into a file (.bmp format)
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Auto_Render_On_Update
注意
On some versions older than 1.17 this could cause some performance issue on older hardware if there a lot of maps being rendered, since map updates are sent multiple times a second. Be careful.
- Description:
  This setting specifies if the Map Chat Bot should automatically render maps as they're received from the servers.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Delete_All_On_Unload
- Description:
  This setting specifies if the Map Chat Bot should automatically delete rendered maps when un-loaded or reloaded.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Notify_On_First_Update
- Description:
  This setting specifies if the Map Chat Bot should notify you when it got a map from the server for the first time.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Resize_Rendered_Image
Note
The bigger the size, the less is the quality.
小提示
For upscaling your maps you could use (getting a bit better quality): https://deepai.org/machine-learning-model/torch-srgan
- Description:
  This setting specifies if the Map Chat Bot should resize the rendered image (the one that is saved to a file).
  This is useful if you're relying map images to Discord via the Discord Bridge Chat Bot.
  The default map size is 128x128.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Resize_To
Note
Might be a bit slow on less powerful systems when rendering a lot of maps. Lower down the resolution if you have any performance issues. If your system is not that powerful and can't handle it, use external tools for upscaling and resizing.
- Description:
  Which size the map should be resized to if Rasize_Rendered_Image is true.
- 類型: integer
- Default: 512
Send_Rendered_To_Discord
注意
The Discord Bridge Chat Bot must be enabled and configured!
注意
You need to enable Save_To_File in order for this to work.
Note
Sometimes when the client connects, the Discord Bridge will be loaded a tiny bit after. Rendered map images are queued up and sent in order as soon as the Discord Bridge is ready and connected.
- Description:
  Send a rendered map (saved to a file) to a Discord channel via the Discord Bridge Chat Bot.
- 類型: boolean
- 默認值: false

玩家列表記錄器

Description:
定期記錄當前的玩家列表到檔案中。
設定:
Section: ChatBot.PlayerListLogger
All settings
Enabled
- Description:
  This setting specifies if the PlayerList Logger Chat Bot is enabled.
- 選擇的值: true 和 false.
- 默認值: false
File
- Description:
  This setting specifies the name of the player list Log file that will be created.
- Default: playerlog.txt
Delay
- Description:
  Save the list of players every how many seconds.
- 類型: float
- Default: 60.0

遠端控制（Remote Control）

Description:
Send MCC console commands to your bot through server PMs (/tell).
You need to have ChatFormat working correctly and add yourself in botowners to use the bot.
注意
Server admins can spoof PMs (/tellraw, /nick) so enable RemoteControl only if you trust server admins.
設定:
Section: ChatBot.RemoteControl
All settings
Enabled
- Description:
  This setting specifies if the Remote Control Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
AutoTpaccept
- Description:
  This setting specifies if the Remote Control Chat Bot should automatically accept teleport requests.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
AutoTpaccept_Everyone
- Description:
  This setting specifies if the Remote Control Chat Bot should automatically accept teleport requests from everyone.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false

回放模組-回憶建造過程

Description:
啟用遊戲錄製 (/replay start)，稍後可以使用 Replay Mod (https://www.replaymod.com/) 進行重播。
注意
在1.19的版本中無法使用，我們正在尋找維護這部分的人，歡迎你的加入<3
Note
請注意，由於技術門檻，使用Bot錄製時，不會將Bot也錄製進去。
注意
您應該使用 /replay stop 或使用 /quit 優雅地退出程序，否則錄製的文件可能會損壞！
設定:
Section: ChatBot.ReplayCapture
All settings
Enabled
- Description:
  此設定來指定是否啟用 Replay Mod Chat Bot。
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Backup_Interval
- Description:
  設定多少秒，當作儲存文件的時間間隔。
  Use -1 to disable.
- 類型: float
- Default: 300.0

腳本排程（Script Scheduler）

Description:
Schedule commands and scripts to launch on various events such as server join, date/time or time interval.
設定:
Section: ChatBot.ScriptScheduler
All settings
Enabled
- Description:
  This setting specifies if the Script Scheduler Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Defining a task
小提示
It is recommended that you align subsections to the right by one tab or 4 spaces for better readability.
- Description:
  Each task is defined as a new subsection [[ChatBot.ScriptScheduler.TaskList]] of the section: [ChatBot.ScriptScheduler].
  Subsection format:
```
[[ChatBot.ScriptScheduler.TaskList]]
<setting> = <value>
<setting> = <value>
```
  Available settings/options:
  - Trigger_On_First_Login
    Will trigger the task when you login the first time.
    Available values: true and false
    Type: boolean
  - Trigger_On_Login
    Will trigger the task each time you login.
    Available values: true and false
    Type: boolean
  - Trigger_On_Times
    This will enable the task to trigger at exact time(s) you want.
    The type of this setting is inline table, that has the following sub-settings/options:
    - Enable - Enables/Disables the setting (Boolean, so either true or false)
    - Times - An array/list of times on which the task should run/trigger (each element is of the Local Time type, eg. 14:00:00, so: hours:minutes:seconds)
    範例:
    Trigger_On_Times = { Enable = true, Times = [ 14:00:00, 22:35:8] }
  - Trigger_On_Interval
    This will enable the task to trigger at certain interval which you've defined.
    The type of this setting is inline table, that has the following sub-settings/options:
    - Enable - Enables/Disables the setting (Boolean, so either true or false)
    - MinTime - Time in seconds (the type is double, eg. 3.14)
    - MaxTime - Time in seconds (the type is double, eg. 3.14)
    If MinTime and MaxTime are the same, the interval will be consistent, however if they are not, the ChatBot will generate a random interval in between those two numbers provided, each time the task is run.
    範例:
    Trigger_On_Interval = { Enable = true, MinTime = 30.0, MaxTime = 160.0 }
Full example
```
[ChatBot.ScriptScheduler]
Enabled = true

    [[ChatBot.ScriptScheduler.TaskList]]
    Task_Name = "Task Name 1"
    Trigger_On_First_Login = false
    Trigger_On_Login = false
    Trigger_On_Times = { Enable = true, Times = [ 14:00:00, ] }
    Trigger_On_Interval = { Enable = true, MinTime = 3.6, MaxTime = 4.8 }
    Action = "send /hello"

    [[ChatBot.ScriptScheduler.TaskList]]
    Task_Name = "Task Name 2"
    Trigger_On_First_Login = false
    Trigger_On_Login = true
    Trigger_On_Times = { Enable = false, Times = [ ] }
    Trigger_On_Interval = { Enable = false, MinTime = 1.0, MaxTime = 10.0 }
    Action = "send /login pass"
```

Telegram Bridge

Description:
This bot allows you to send and receive messages and commands via a Telegram Bot DM or to receive messages in a Telegram channel.
注意
You can't send messages and commands from a group channel, you can only send them in the bot DM, but you can get the messages from the client in a group channel.
Setup:
1. First you need to create a Telegram bot and obtain an API key, to do so, go to Telegram and find @botfather
2. Click on Start button and read the bot reply, then type /newbot, the Botfather will guide you through the bot creation.
3. Once you create the bot, copy the API key that you have gotten, and put it into the Token field of ChatBot.TelegramBridge section (this section).
4. Then launch the client and go to Telegram, find your newly created bot by searching for it with its username, and open a DM with it.
5. Click on Start button and type and send the following command .chatid to obtain the chat id.
6. Copy the chat id number (eg. 2627844670) and paste it in the ChannelId field and add it to the Authorized_Chat_Ids field (in this section) (an id in "Authorized_Chat_Ids" field is a number/long, not a string!), then save the file. Now you can use the bot using it's DM.
警告
Do not share your API key with anyone else as it will give them the control over your bot. Save it securely.
警告
If you do not add the id of your chat DM with the bot to the "Authorized_Chat_Ids" field, ayone who finds your bot via search will be able to execute commands and send messages!
警告
An id pasted in to the "Authorized_Chat_Ids" should be a number/long, not a string!
設定:
Section: ChatBot.TelegramBridge
All settings
Enabled
- Description:
  This setting specifies if the Telegram Bridge Chat Bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Token
- Description:
  你的Telegram機器人的令牌。
- 類型: string
- Default: empty
ChannelId
- Description:
  你想要使用機器人與 MCC 互動的頻道ID。
- 類型: string
- Default: empty
Authorized_Chat_Ids
- Description:
  A list of Chat IDs that are allowed to send messages and execute commands. To get an id of your chat DM with the bot use .chatid bot command in Telegram.
- 類型: array of strings
- Default: empty
Message_Send_Timeout
- Description:
  如果信息無法被傳送至Telegram時，要等候多少秒才取消傳送。（最小 1秒）
- 類型: integer
- Default: 3
Message Formats
Words wrapped with { and } are going to be replaced during the code execution, do not change them! For example, {message} is going to be replace with an actual message, {username} will be replaced with an username, {timestamp} with the current time. For Telegram message formatting, check the following.
PrivateMessageFormat
- Description:
  A format that is used to display a private chat message on the minecraft server, in a Telegram channel.
- 類型: string
- Default: *(Private Message)* {username}: {message}
PublicMessageFormat
- Description:
  A format that is used to display a public chat message on the minecraft server, in a Telegram channel.
- 類型: string
- Default: {username}: {message}
TeleportRequestMessageFormat
- Description:
  A format that is used to display a teleport request on the minecraft server, in a Telegram channel.
- 類型: string
- Default: A new Teleport Request from **{username}**!

Items Collector

Description:
Collect items on the ground using this Chat Bot.
設定:
Section: ChatBot.ItemsCollector
All settings
Enabled
- Description:
  This setting specifies if the Items Collector chat bot is enabled.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Collect_All_Item_Types
- Description:
  Specifies if the bot will collect all items, regardless of their type. If you want to use the whitelisted item types, disable this by setting it to false.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: false
Items_Whitelist
- Description:
  In this list you can specify which items the bot will collect. To enable this, set the Collect_All_Item_Types to false.
Note
This does not prevent the bot from accidentally picking up other items, it only goes to positions where it finds the whitelisted items
- Available values: Item Type List
- Type: array of strings with item names
- Default: [ "Diamond", "NetheriteIngot" ]
Delay_Between_Tasks
- Description:
  機器人掃描項目之間的延遲（建議：300-500）
- 類型: integer
- Default: 300
Collection_Radius
- Description:
  The radius of blocks in which bot will look for items to collect.
- Type: double
- Default: 30.0
Always_Return_To_Start
- Description:
  Specifies if the bot will return to it's starting position after there are no items to collect.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true
Prioritize_Clusters
- Description:
  Specifies if the bot will go after clustered items instead for the closest ones.
- 選擇的值: true 和 false.
- 類型: boolean
- 默認值: true