配置

Minecraft 指令型玩家端 都可以自由組合 命令行參數 和 配置文件

默認情況下，所有機器人參數都存儲在名為MinecraftClient.ini 的資料夾中，這是您第一次開啟該程式創建的文件，但您也可以通過在啟動 MCC 時將其路徑作為第一個參數來指定您自己的配置文件，查看 用法 中的例子.

注意

我們最近將文件格式從 INI 更改為 TOML，必須更新文件。 如果您發現錯誤，可以來我們的 Discord 或存儲庫中報告問題。

備註

• 我們建議您親自詳讀參數設定的文件，裡面每個參數旁都有功能描述，在文件中會忽略一些不常使用的參數，請見諒😌。
• 一些 插件/自動化想法 的相關設定將在插件部分介紹，而不是在這✍

參數配置文件

格式

參數配置文件將使用 TOML的格式, 所有的參數設定都有個別的值來對應，且分為多個部分。

變數是指方括號之間的內容（例如：[This is a section]），每次出現都標誌著一個新變數的開始。

在 設定/選項 定義為 參數名稱與唯一對應的值，其中用單個等號分開。 = (範例: some-setting=some value).

以 # 開頭的行是註釋，無關程式運作，純粹在描述事情而已。

要熟悉所有數據類型和設定模式，請閱讀官方 TOML 文件。

這些是範例

[SectionNameHere]
Setting_Name = "this is some name"
Setting_Something = 15

[OtherSection]
# This is a comment explaining what this setting/option does
Other_Setting = true  # This also is a comment

[ThirdSection]
Section_Enabled = true
colors = [ "red", "yellow", "green" ]

[ThirdSection.Subsection]
Coordinate = { x = 145, y = 64, y = 2045 }

主要部分

一般設定

• 主要變數: Main.General

Account

• 描述:

  在此設置中，您需要提供您的遊戲內名稱（對於離線帳戶）或 Microsoft 帳戶的電子郵件（Mojang 帳戶不再可用）和您的密碼（如果使用離線帳戶，請使用 - 密碼）。

• 格式:

  Account = { Login = "<email>", Password = "<password>" }

• 類型: inline table

• 例如：

  Account = { Login = "some.random.player@gmail.com", Password = "myEpicPassword123" }

Server

• 描述：

  這是你提供遊戲服務器地址的位置，“Host”可以填寫域名或IP地址。 （“Port”可不填寫，程式會自動解析🧐）

  Host也可以從下方的"伺服器列表"填寫伺服器代號。

• 格式: Server = { Host = "<ip>", Port = <port> }

• 類型: inline table

• 例如：

  Server = { Host = "mysupercoolserver.com" }
  

  Server = { Host = "192.168.1.27", Port = 12345 }
  

  Server = { Host = "ServerAlias1" }
  

AccountType

• 描述：

  這是設定選擇帳號登入的類型 : mojang or microsoft

  小提示

  未來將無法使用Mojang模式進行登入( 因為微軟公司把Mojang的帳號轉移至Microsoft）

• 類型: string

• 默認值: microsoft

• 例如：

  AccountType = "microsoft"
  

Method

• 描述：

  您可以在這裡選擇MIcrosoft帳號的登入方式 是要"mcc視窗中"還是在"網頁中"。 mcc 或 browser.

• 類型: string

• 默認值: mcc

• 例如：

  Method = "mcc"
  

進階設定

• 主要變數: Main.Advanced

Language

• 描述：

  在這您可以選擇您想使用的本地語言📖。

  當您連接到 1.6+ 服務器時，會需要一個合適的語言來正確翻譯一些聊天內容。這些文件是來引導您，如何根據狀況來選擇合適的翻譯文件🔖

  如果您的電腦有安裝了 Minecraft，程式將沿用您 Minecraft 的語言習慣 en_GB.language，或者從 Mojang 的伺服器下載它🤖。 您可以在設置文件中，選擇您想使用的語言~

  尋找您習慣的語言, 請點開 這邊.

• 類型: string

• 默認值: en_gb

• 例如：

  Language = "en_gb"
  

ConsoleTitle

• 描述：

  如果你有需要，可以在這更改主控台的視窗名稱。 您可以改寫其中的變數。

• 類型: string

• 默認值: "%username%@%serverip% - Minecraft Console Client"

• 例如：

  ConsoleTitle = "%username%@%serverip% - Minecraft Console Client"
  

InternalCmdChar

• 描述：

  您可以在這更改內部 MCC 命令的開頭字符。

  可用的選項

  • none
  • slash
  • backslash

• 類型: string

• 默認值: slash

• 例如：

  InternalCmdChar = "slash"
  

MessageCooldown

• 描述：

  在這您可更改發送訊息之間的，延遲時間，以避免濫發訊息被伺服器踢出。

• 類型: float

• 默認值: 1.0

BotOwners

• 描述：

  這個設定讓你可以設定"機器人/客戶端"所有者名稱的地方，它可以配合一些插件使用。 名稱在數列中以字符串形式分隔，並以逗號分隔。

• 格式:

  BotOwners = [ "<nick>", "<nick>", ... ]
  

• 類型: array of strings

• 默認值: [ "Player1", "Player2", ]

• 例如：

  BotOwners = [ "milutinke", "bradbyte", "BruceChen", ]
  

  注意

  管理員可以在 1.19 之前的版本上冒充玩家

MinecraftVersion

• 描述：

  您可以在這選擇您想要享受的遊戲版本。

• 格式: MinecraftVersion = "<version>"

• 類型: string

• 版本格式: 1.X.X

• 類型: string

• 默認值: auto

• 例如：

  MinecraftVersion = "1.18.2"
  

  小提示

  MCC 支援的版本範圍 1.4.6 - 1.19.2

EnableForge

• 描述：

  您可以在這選擇您是否可以進入，沒有正版驗證的伺服器。

• 類型: string

• 可用的選項

  • auto
  • no
  • force

• 默認值: auto

  小提示

  強制啟用的選項適用版本為 MC 1.13 +

BrandInfo

• 描述：

  您可以在這更改，MCC向伺服器說你是用什麼方式登入🤖。 隨心所欲用什麼身份都行, 例如: vanilla, mcc, empty. 如果伺服器禁止機器人，您最好的選擇是vanilla 也就是原版登入身份組。

• 類型: string

• 默認值: mcc

  小提示

  如果您想用MCC遊玩Hypixel 您需要將mcc改成vanilla

ChatbotLogFile

• 描述：

  您可以在這設定log文件的保存路徑，留空代表沒有log文件。

• 類型: string

• 默認值: Empty

• 例如：

  ChatbotLogFile = "my-log.txt"
  

PrivateMsgsCmdName

• 描述：

  您可以在這更改遠程控制機器人的命令開頭，例如原本/tell 來執行指令，如果將tell改成whisper，那麼以後就是用/whisper 當開頭來執行指令。

• 類型: string

• 默認值: tell

ShowSystemMessages

• 描述：

  如果您是 OP，您可以在此設定中選擇是否要查看系統消息（例如用命令方塊輸出）。

• 類型: boolean

• 默認值: true

ShowXPBarMessages

• 描述：

  您可以在這選擇是否想要看見BOSS血條的訊息。

• 類型: boolean

• 默認值: true

  提示: 前提是BOSS不會要你的命，好讓你可以觀察牠👺，不然你會死的很慘。

ShowChatLinks

• 描述:

  您在這可以選擇是否要解碼聊天室中出現的連結，並且在控制台中顯示連結⛓️。

• 類型: boolean

• 默認值: true

ShowInventoryLayout

• 描述:

  您在這可以選擇是否要在MCC主控台，以ASCII的字符藝術來顯示您遊戲內各種容器的樣式，指令是使用/inventory 來選擇你要查看的容器🧐。 (例如: /inventory 0 則會查看自身的背包。)

  它看起來就是這麼酷:

  

• 類型: boolean

• 默認值: true

TerrainAndMovements

• 描述:

  您在這可以選擇是否要啟用"地形處理"的功能，以便你可以只透過指令 /move 來完成與方塊的互動👻。

  注意

  這項功能目前沒有支援這些版本 1.4.6 - 1.6.

• 類型: boolean

• 默認值: false

小提示

有時在最新遊戲版本無法立即使用這項功能🙏，因為Mojang時常對此進行更改

InventoryHandling

• 描述：

  您在這可選擇是否啟用，使用指令 /inventory 來處理您的箱內寶物（可操作背包、箱子等容器）。

  注意

  This feature is currently not supported in 1.4.6 - 1.9. But we are working on getting it supported in 1.8 and 1.9.

• 類型: boolean

• 默認值: false

EntityHandling

• 描述:

  您在這可以選擇是否要啟用"與實體互動"的功能， 實體則是：玩家、怪物、礦車、村民等等...。

  注意

  This feature is currently not supported in 1.4.6 - 1.7.

• 類型: boolean

• 默認值: false

  小提示

  有時在最新遊戲版本無法立即使用這項功能🙏，因為Mojang時常對此進行更改

SessionCache

• 描述:

  您在這可以選擇您帳號登入資訊的三種儲存方式，1.disk暫存在硬碟中，2.memory暫存在記憶體中，3.none不儲存（這可能拖慢您登入的過程）。

  使用none選項來關閉功能。

  使用disk選項，會將您的登入授權序號保存在硬碟中，如果沒保護你的 MCC資料夾，這可能會帶來一些安全風險。

  使用 memory 選項，資料會在你關閉程式後刪除。

• 類型: string

• 默認值: disk

ProfileKeyCache

• 描述:

  作用與SessionCache 相同，而這邊負責管理聊天身份與驗證彼此身份的密鑰。

• 類型: string

• 默認值: disk

ResolveSrvRecords

• 描述:

  您在這可填寫 no, fast (超時時間為五秒鐘), 或是 yes.

  加入某些伺服器需要開啟此項。

• 類型: string

• 默認值: fast

PlayerHeadAsIcon

• 描述:

  您在這可以選擇是否啟用，使用玩家面板頭像作為視窗圖示，這僅在部分舊版控制檯中有效。

• 類型: boolean

• 默認值: true

  小提示

  只可以運作在 Windows XP-8 或 Windows 10 和一些老版本中

ExitOnFailure

• 描述:

  您在這可以選擇是否啟用，發生錯誤時要不要直接退出遊戲，用於在非互動式指令碼中使用MCC。

• 類型: boolean

• 默認值: false

CacheScript

• 描述:

  您在這可以選擇是否啟用，快取已編譯的指令碼，以便在低端裝置上更快的載入。

• 類型: boolean

• 默認值: true

Timestamps

• 描述:

  您在這可選擇是否啟用，在聊天資訊頭部新增時間戳。

• 類型: boolean

• 默認值: false

AutoRespawn

• 描述:

  您在這可選擇是否啟用，自動重生。

• 類型: boolean

• 默認值: false

  小提示

  （開啟前請確保你的出生點是安全的）

MinecraftRealms

• 描述:

  您在這可選擇是否啟用，對加入我的世界領域(Realms)伺服器的支援🤝。

• 類型: boolean

• 默認值: false

MoveHeadWhileWalking

• 描述:

  您在這可選擇是否啟用，要在行走時的頭部運動，以避免觸發反作弊系統。

• 類型: boolean

• 默認值: true

TcpTimeout

• 描述:

  您可以在這調整，以秒為單位的超時標準。 這適合當您知道這有什麼作用時，再來更改。

• 類型: integer

• 默認值: 30

EnableEmoji

• 描述:

  您可在這選擇是否啟用emoji表情，用於 chunk 的指令顯示。

• 類型: boolean

• 默認值: true

MovementSpeed

• 描述:

  您可在這調整，人物在遊戲裡的移動速度。

• 類型: integer

• 默認值: 2

注意

A movement speed higher than 2 may be considered cheating by some plugins.

IgnoreInvalidPlayerName

• Description:

  Minecraft player name can only consist of English letters, numbers, and underscore symbols. Other name will be considered as invalid and ignored by default.

• Type: boolean

• Default: true

帳號列表

• 主要變數: Main.Advanced.AccountList

• 說明 :

  此部分可讓您新增多個帳號，以便您可以在運行中輕鬆地在它們之間切換。

• 使用範例：

  /connect <serverip> Player1

• 類型: array of inline tables

• 格式:

  <account nick> = { Login = "<email>", Password = "<password>" }
  

• 範例:

  Player1 = { Login = "playerone@email.com", Password = "thepassword" }
  

伺服器清單

• 主要變數: Main.Advanced.ServerList

• 說明:

  此部分可讓您新增多個服務器別名，以便在服務器之間快速輕鬆地切換。 別名不能包含點或空格，名稱“localhost”不能用作別名。

• 使用範例：

  /connect Server2

• 類型: array of inline tables

• 格式:

  <server alias> = { Host = "<ip>", Port = <port> }
  

• 範例:

  ServerAlias1 = { Host = "mc.awesomeserver.com" }
  ServerAlias2 = { Host = "192.168.1.27", Port = 12345 }
  

簽名檔

• 主要變數: Signature

• 說明:

  僅影響 Minecraft 1.19+。

  此部分含有 Mojang 引入的新聊天報告（簽名和驗證）功能相關的設定。

LoginWithSecureProfile

• 說明:

  微軟帳戶專屬。 如果禁用，將無法簽署聊天和加入設定文件為 enforce-secure-profile=true 的服務器

• 類型: boolean

• 默認值: true

SignChat

• 說明:

  是否簽署從 MCC 發送的聊天訊息。

• 類型: boolean

• 默認值: true

SignMessageInCommand

• 說明:

  是否對 MCC 發送出的命令裡，包含的消息進行簽名。

  像是/msg和/me中的消息。

• 類型: boolean

• 默認值: true

MarkLegallySignedMsg

• 說明:

  使用綠色塊，來標記具有合法簽名的聊天訊息。

• 類型: boolean

• 默認值: false

MarkModifiedMsg

• 說明:

  是否使用黃色色塊標識被伺服器更改過的聊天。

• 類型: boolean

• 默認值: true

MarkIllegallySignedMsg

• 說明:

  使用紅色塊，來標記具沒有有合法簽名的聊天訊息。

• 類型: boolean

• 默認值: true

MarkSystemMessage

• 說明:

  使用灰色塊，標記系統消息（因為始終都沒有簽名）。

• 類型: boolean

• 默認值: false

ShowModifiedChat

• 說明:

  設置為 true 將顯示被服務器修改的訊息，false 則顯示經過簽名的原始訊息。

• 類型: boolean

• 默認值: true

ShowIllegalSignedChat

• 說明:

  是否在沒有合法簽名的命令中，顯示聊天和消息。

• 類型: boolean

• 默認值: true

紀錄

• 主要變數: Logging

DebugMessages

• 說明:

  此設置，可讓您默認是否要在客戶端運行時查看Debug消息，這在出現錯誤同時想要報告問題時非常有用，或者如果您正在開發腳本/機器人並且想要Debug它 .

• 類型: boolean

• 默認值: false

ChatMessages

• 說明:

  此設定可讓您是否要更改查看聊天消息。

• 類型: boolean

• 默認值: true

InfoMessages

• 說明:

  此設置可讓您定義是否要查看信息消息。

  大多數消息來自 MCC。

• 類型: boolean

• 默認值: true

WarningMessages

• 說明:

  此設置可讓您定義是否要查看警告消息。

• 類型: boolean

• 默認值: true

ErrorMessages

• 說明:

  此設置可讓您定義是否要查看錯誤消息。

• 類型: boolean

• 默認值: true

ChatFilterRegex

• 說明:

  此設置可讓您定義是否要過濾使用 Regex 表達式記錄的聊天消息。

  更多關於 Regex 在這.

• 類型: string

• 默認值: .*

  小提示

  默認不過濾任何東西

DebugFilterRegex

• 說明:

  此設置可讓您定義是否要過濾使用 Regex 表達式記錄來Debug消息。

  更多關於 Regex 在這.

• 類型: string

• 默認值: .*

  小提示

  默認不過濾任何東西

FilterMode

• Description:

  Can be disable, blacklist or whitelist

  "disable" will disable the filter, blacklist hides the messages, while the whitelist shows the messages that match the Regex expression that you've defined.

• 類型: string

• Default: disable

LogToFile

• Description:

  This setting allows you to define if your want to log messages to a file.

• 類型: boolean

• 默認值: false

LogFile

• Description:

  This setting allows you to define a path to a file where you want to log messages if you have enabled logging to a file with LogToFile = true.

• 類型: string

• Default: console-log.txt

  小提示

  %username% and %serverip% will be substituted with your username and the IP address of the server you are connected to. So you can use something like: console-log-%username%-%serverip%.txt

PrependTimestamp

• Description:

  This setting allows you to define if your want prepend timestamps to messages that are written to the log file.

• 類型: boolean

• 默認值: false

SaveColorCodes

• Description:

  This setting allows you to define if your want keep the server color codes in the logged messages.

  Example of a color coded message: §bsome message

• 類型: boolean

• 默認值: false

App Vars section

• Section header: AppVar

• Description:

  This section allows you to define your own custom settings/variables which you can use in scripts, bots or other setting fields.

  To define a variable/setting, simply make a new line with the following format under the [AppVar.VarStirng] section:

  小提示

  %username%, %serverip%, %datetime% are reserved variables

• 主要變數: Logging

• 範例:

  your_var = "your_value"
  "your var 2" = "your value 2"
  

Proxy section

• Section header: Proxy

• Description:

  Connect to a server via a proxy instead of connecting directly.

Enabled_Login

• Description:

  If Mojang session services or Microsoft login services are blocked on your network or your ip is blacklisted or rate limited by Microsoft, set the value to true.

• 類型: boolean

• 默認值: false

Enabled_Ingame

• Description:

  是否通過代理連線Minecraft遊戲伺服器。

  If connecting to a port 25565 (Minecraft) is blocked on your network, set the value to true to login and connect using the proxy.

• 類型: boolean

• 默認值: false

  注意

  Make sure your server rules allow Proxies or VPNs before setting the setting to true, or you may face consequences!

Server

• Description:

  The proxy server IP and port.

  代理伺服器必須允許HTTPS登入。

• 格式:

  Server = { Host = "<ip>", Port = <port> }
  

• Default: { Host = "0.0.0.0", Port = 8080 }

Proxy_Type

• Description:

  The type of your proxy.

  可用的選項

  • HTTPT
  • SOCKS4
  • SOCKS4a
  • SOCKS5

• 類型: string

• Default: HTTPT

Username

• Description:

  The proxy account username.

  Only needed for password protected proxies.

• Default: ``

Password

• Description:

  The proxy account password.

  Only needed for password protected proxies.

• Default: ``

MCSettings section

• Section header: MCSettings

• Description:

  Client settings related to language, render distance, difficulty, chat and skins.

Enabled

• Description:

  This setting allows you to specify if you want to use settings from this section.

• 類型: boolean

• 默認值: true

Locale

• Description:

  Use any language implemented in Minecraft

• 類型: string

• Default: en_US

RenderDistance

• Description:

  Render distance in chunks: 0 - 255

• 類型: integer

• Default: 8

Difficulty

• Description:

  可用的選項

  • peaceful
  • easy
  • normal
  • difficult

• 類型: string

• Default: normal

ChatMode

• Description:

  This setting allows you to effectively mute yourself.

  可用的選項

  • enabled (You can chat)
  • commands (You can only do commands)
  • disabled

• 類型: string

• Default: enabled

ChatColors

• Description:

  This setting allows you to disable chat colors.

• 類型: boolean

• 默認值: true

MainHand

• Description:

  This setting allows you to specify your main hand.

• Available values: right and left

• 類型: string

• Default: left

MCSettings Skin section

• Section header: MCSettings.Skin

• Description:

  Skin options.

Cape

• Description:

  This setting allows you to specify if you want to have your skin cape shown.

• 類型: boolean

• 默認值: true

Hat

• Description:

  This setting allows you to specify if you want to have your skin hat shown.

• 類型: boolean

• 默認值: true

Jacket

• Description:

  This setting allows you to specify if you want to have your skin jacket shown.

• 類型: boolean

• 默認值: false

Sleeve_Left

• Description:

  This setting allows you to specify if you want to have your left sleeve shown.

• 類型: boolean

• 默認值: false

Sleeve_Right

• Description:

  This setting allows you to specify if you want to have your right sleeve shown.

• 類型: boolean

• 默認值: false

Pants_Left

• Description:

  This setting allows you to specify if you want to have your left part of the pants shown.

• 類型: boolean

• 默認值: false

Pants_Right

• Description:

  This setting allows you to specify if you want to have your right part of the pants shown.

• 類型: boolean

• 默認值: false

Chat Format section

• Section header: ChatFormat

• Description:

  The MCC does it best to detect chat messages, but some server have unusual chat formats.

  When this happens, you'll need to configure the chat format yourself using settings from this section.

  The MCC uses Regular Expressions (Regex) to detect the chat formatting, in case that you're not familiar with Regex you can use the following resources to learn it and test it out:

  • 速成課程 :

    • Regex video tutorial by Web Dev Simplified
    • Regex on paper by Crack Concepts

  • In-depth tutorials:

    • Quite a long and detailed tutorial by Svetlin Nakov
    • Microsoft Documentation on Regex

  • Testing Regex expressions online:

    • https://regex101.com/
    • https://regexr.com/

Builtins

• Description:

  This setting allows you to define if your want use the default chat formats.

  Set to false to avoid conflicts with custom formats.

• 類型: boolean

• 默認值: true

UserDefined

• Description:

  This setting allows you to define if your want to use the custom chat formats defined bellow using Regex.

  Set to true to use the custom formats defined in Public, Private and TeleportRequest.

• 類型: boolean

• 默認值: false

Public

• Description:

  This setting allows you to specify a custom chat message format using Regex (Regular expressions).

  更多關於 Regex 在這.

  Only works when Builtins is set to false.

• 類型: string

• Default: Public = "^<([a-zA-Z0-9_]+)> (.+)$"

Private

• Description:

  This setting allows you to specify a custom chat message format for private messages using Regex (Regular expressions).

  更多關於 Regex 在這.

  Only works when Builtins is set to false.

• 類型: string

• Default: Private = "^([a-zA-Z0-9_]+) whispers to you: (.+)$"

TeleportRequest

• Description:

  This setting allows you to specify a custom chat message format for a Teleport request using Regex (Regular expressions).

  更多關於 Regex 在這.

  Only works when Builtins is set to false.

• 類型: string

• Default: TeleportRequest = '^([a-zA-Z0-9_]+) has requested (?:to|that you) teleport to (?:you|them)\.$'