Configuration

Account

• Description:

  This setting is where you provide your account login information.

  For Microsoft accounts, set Login to your Microsoft email. You do not need to provide a password because MCC uses the OAuth 2.0 device code flow for authentication (you sign in through your browser, with full 2FA support).

  For offline accounts, set Login to your desired in-game name and Password to -.

  For Yggdrasil accounts, set Login and Password to the credentials for your authlib server.

• Format:

  Account = { Login = "<email>" }

• Type: inline table

• Examples:

  Microsoft account (password not needed):

  Account = { Login = "player@example.com" }

  Offline account:

  Account = { Login = "Steve", Password = "-" }

Server

• Description:

  This is the setting where you provide the address of the game server, "Host" can be filled in with domain name or IP address. (The "Port" field can be deleted, it will be resolved automatically)

  Host can also fill in the nickname of the server in the "Server List" below.

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

• Type: inline table

• Example:

  Server = { Host = "mysupercoolserver.com" }

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

  Server = { Host = "ServerAlias1" }

AccountType

• Description:

  This setting defines the account type: mojang, microsoft, or yggdrasil.

  Tip

  Use microsoft for normal Microsoft accounts. yggdrasil is for custom authlib/Yggdrasil servers.

• Type: string

• Default: microsoft

• Example:

  AccountType = "microsoft"

Method

• Description:

  This setting is where you define the way you will sign in with your Microsoft account, available options are mcc and browser. The mcc method uses the OAuth 2.0 device code flow: MCC will display a code and a URL, and you complete the sign-in (including 2FA) in your browser. The browser method opens a sign-in page in your browser and you paste the resulting code back into MCC.

• Type: string

• Default: mcc

• Example:

  Method = "mcc"

AuthServer

• Description:

  This subsection is used when AccountType is set to yggdrasil. It points MCC at the authlib/Yggdrasil server used for login, session checks, and profile key requests.

  MCC now writes this as a dedicated TOML subsection instead of an inline table:

  [Main.General.AuthServer]

  Host accepts either a plain host name or a host:port pair. If you include the port there, MCC updates Port to match.

  AuthlibInjectorAPIPath defaults to /api/yggdrasil. Change it if your authlib-injector server uses a different prefix, such as /authlib-injector.

  UseHttps defaults to true. Set it to false if your local or development auth server only exposes plain HTTP.

• Type: section

• Default:

  [Main.General.AuthServer]
  Port = 443
  AuthlibInjectorAPIPath = "/api/yggdrasil"
  UseHttps = true
  Host = ""

• Example:

  [Main.General.AuthServer]
  Host = "auth.example.com"
  Port = 443
  AuthlibInjectorAPIPath = "/api/yggdrasil"
  UseHttps = true

  [Main.General.AuthServer]
  Host = "127.0.0.1"
  Port = 25585
  AuthlibInjectorAPIPath = "/authlib-injector"
  UseHttps = false

AuthUser

• Description:

  This setting allows for Yggdrasil authlib multi-user selection. It selects which profile MCC should use when the authlib/Yggdrasil server returns multiple available profiles. Leave it empty to pick the profile interactively.

• Type: string

• Default: ""

• Example:

  AuthUser = "SomePlayer"

Language

• Description:

  This setting is where you define which language you want to use.

  When connecting to 1.6+ servers, you will need a translation file to display properly some chat messages.These files describe how some messages should be printed depending on your preferred language.

  The client will automatically load en_GB.lang from your Minecraft folder if Minecraft is installed on your computer, or download it from Mojang's servers. You may choose another language in the configuration file.

  To find your language code, check this list.

• Type: string

• Default: en_us

• Example:

  Language = "en_us"

EnableSentry

• Description:

  Set this to false to opt out of Sentry error reporting.

• Type: boolean

• Default: true

LoadMccTranslation

• Description:

  Set this to false to keep MCC in English even when translated strings are available.

• Type: boolean

• Default: true

ConsoleTitle

• Description:

  This setting is where you can change the title of the program window if you want to. You can use the variables in it.

• Type: string

• Default: "%username%@%serverip% - Minecraft Console Client"

• Example:

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

InternalCmdChar

• Description:

  This setting is where you can change the prefix character of internal MCC commands.

  Available options:

  • none
  • slash
  • backslash

• Type: string

• Default: slash

• Example:

  InternalCmdChar = "slash"

MessageCooldown

• Description:

  This setting is where you can change the minimum delay in seconds between messages to avoid being kicked for spam.

• Type: float

• Default: 1.0

MaxChatMessageLength

• Description:

  Overrides the maximum chat message length. By default, MCC caps messages at 100 characters on Minecraft 1.10 and below, and 256 characters on 1.11 and above. Set to 0 to keep the default.

  Some servers (like Hypixel on 1.8) accept messages longer than the vanilla protocol default for that version. This setting lets you match whatever limit the server actually allows.

  Warning

  Setting this to a value the server doesn't support may get you kicked. Only change it if you know the server accepts longer messages than the version default.

• Type: integer

• Default: 0

• Range: 0 - 32767

BotOwners

• Description:

  This setting is where you can set the owners of the bots/client which can be used by some plugins. The names are separated as strings within an array, separated by commas.

• Format:

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

• Type: array of strings

• Default: [ "Player1", "Player2", ]

• Example:

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

  Warning

  Admins can impersonate players on versions older than 1.19

MinecraftVersion

• Description:

  This setting is where you can set the version you are playing on.

• Format: MinecraftVersion = "<version>"

• Type: string

• Version format: 1.X.X

• Type: string

• Default: auto

• Example:

  MinecraftVersion = "1.18.2"

  Tip

  Current code support is 1.4.6 through 26.1.

EnableForge

• Description:

  This setting is where you can define if you're playing on a forge server.

• Type: string

• Available options:

  • auto
  • no
  • force

• Default: no

  Tip

  Force-enabling only works for MC 1.13 +

BrandInfo

• Description:

  This setting is where you can change how MCC identifies itself to the server. It can be whatever you like, example: vanilla, mcc, empty.

• Type: string

• Default: mcc

  Tip

  For playing on Hypixel you need to use vanilla

ChatbotLogFile

• Description:

  This setting is where you can set the path to the file which will contain the logs, leave empty for no log file.

• Type: string

• Default: Empty

• Example:

  ChatbotLogFile = "my-log.txt"

PrivateMsgsCmdName

• Description:

  The name of the command which is used for remote control of the bot.

• Type: string

• Default: tell

ShowSystemMessages

• Description:

  This setting is where you can define if you want to see the system messages (example command block outputs) if you're an OP.

• Type: boolean

• Default: true

ShowXPBarMessages

• Description:

  This setting is where you can define if you want to see the Boss XP Bar messages.

• Type: boolean

• Default: true

  Note: Can create a spam if there is a bunch of withers

ShowChatLinks

• Description:

  This setting is where you can define if you want to decode links embedded in chat messages and show them in console.

• Type: boolean

• Default: true

ShowInventoryLayout

• Description:

  This setting is where you can define if you want to have the MCC show you the inventory in a form of an ASCII art when using the /inventory internal command.

  How it looks like:

  

• Type: boolean

• Default: true

TerrainAndMovements

• Description:

  This setting is where you can set if you want to enable terrain movement, so you can use command like /move and some bots.

  Warning

  This feature is currently not supported in 1.4.6 - 1.6.

• Type: boolean

• Default: false

InventoryHandling

• Description:

  This setting is where you can set if you want to enable inventory handling using the /inventory command.

  Warning

  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.

• Type: boolean

• Default: false

EntityHandling

• Description:

  This setting is where you can set if you want to enable interactions with entities such as players, mobs, minecarts, etc..

  Warning

  This feature is currently not supported in 1.4.6 - 1.7.

• Type: boolean

• Default: false

  Tip

  Sometimes the latest versions might not support this straight away, since Mojang often makes changes to this.

SessionCache

• Description:

  This setting is where you can define is you want your session info to be stored on the disk or in memory, or not to be stored (this will make you login every time which will add some time to the process).

  You can disable this by using none.

  The disk option will save your login authorization token on the disk, but this can be a bit of a security risk if someone else has access to your folder where you have MCC installed.

  The memory will last until you close down the program.

• Type: string

• Default: disk

ProfileKeyCache

• Description:

  Same as SessionCache but for your profile keys which are used for chat signing and validation.

• Type: string

• Default: disk

ResolveSrvRecords

• Description:

  Use no, fast (5s timeout), or yes.

  Required for joining some servers.

• Type: string

• Default: fast

PlayerHeadAsIcon

• Description:

  This setting allows you to set the icon of the program to be the head of your in-game skin.

• Type: boolean

• Default: true

  Tip

  Only works on Windows XP-8 or Windows 10 with old console

ExitOnFailure

• Description:

  This setting allows you to define if your want to disable pauses on error, for using MCC in non-interactive scripts

• Type: boolean

• Default: false

CacheScript

• Description:

  This setting allows you to define if your want to have MCC cache compiled scripts for faster load on low-end devices.

• Type: boolean

• Default: true

Timestamps

• Description:

  This setting allows you to define if your want to have MCC prepend timestamps to chat messages.

• Type: boolean

• Default: false

AutoRespawn

• Description:

  This setting allows you to define if your want to auto respawn if you die.

• Type: boolean

• Default: false

  Tip

  Make sure the spawn point is safe

MinecraftRealms

• Description:

  This setting allows you to define if your want to enable support for joining Minecraft Realms.

• Type: boolean

• Default: false

MoveHeadWhileWalking

• Description:

  This setting allows you to define if your want to enable head movement while walking to avoid anti-cheat triggers

• Type: boolean

• Default: true

TcpTimeout

• Description:

  This setting allows you to define a custom timeout period in seconds. Use only if you know what you're doing.

• Type: integer

• Default: 30

EnableEmoji

• Description:

  This setting allows you to disable emojis in the chunk command.

• Type: boolean

• Default: true

MovementSpeed

• Description:

  This setting allows you to change the movement speed of the bot.

• Type: integer

• Default: 2

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

LoginWithSecureProfile

• Description:

  Microsoft accounts only. If disabled, will not be able to sign chat and join servers configured with enforce-secure-profile=true

• Type: boolean

• Default: true

SignChat

• Description:

  Whether to sign the chat sent from the MCC.

• Type: boolean

• Default: true

SignMessageInCommand

• Description:

  Whether to sign the messages contained in the commands sent by the MCC.

  For example, the message in /msg and /me

• Type: boolean

• Default: true

MarkLegallySignedMsg

• Description:

  Use green color block to mark chat with legitimate signatures.

• Type: boolean

• Default: true

MarkModifiedMsg

• Description:

  Use yellow color block to mark chat that have been modified by the server.

• Type: boolean

• Default: true

MarkIllegallySignedMsg

• Description:

  Use red color block to mark chat without legitimate signature.

• Type: boolean

• Default: true

MarkSystemMessage

• Description:

  Use gray color block to mark system message (always without signature).

• Type: boolean

• Default: true

ShowModifiedChat

• Description:

  Set to true to display messages modified by the server, false to display the original signed messages.

• Type: boolean

• Default: true

ShowIllegalSignedChat

• Description:

  Whether to display chat and messages in commands without legal signature.

• Type: boolean

• Default: true

DebugMessages

• Description:

  This setting allows you to define if your want to see debug messages while the client is running, this is useful when there is a bug and you want to report a problem, or if you're developing a script/bot and you want to debug it.

• Type: boolean

• Default: false

ChatMessages

• Description:

  This setting allows you to define if your want to see chat messages.

• Type: boolean

• Default: true

InfoMessages

• Description:

  This setting allows you to define if your want to see info messages.

  Most of the messages from MCC.

• Type: boolean

• Default: true

WarningMessages

• Description:

  This setting allows you to define if your want to see warning messages.

• Type: boolean

• Default: true

ErrorMessages

• Description:

  This setting allows you to define if your want to see error messages.

• Type: boolean

• Default: true

ChatFilterRegex

• Description:

  This setting allows you to define if your want to filter chat messages being logged using a Regex expression.

  More on Regex here.

• Type: string

• Default: .*

  Tip

  Not filtering anything by default

DebugFilterRegex

• Description:

  This setting allows you to define if your want to filter debug messages being logged using a Regex expression.

  More on Regex here.

• Type: string

• Default: .*

  Tip

  Not filtering anything by default

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.

• Type: string

• Default: disable

LogToFile

• Description:

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

• Type: boolean

• Default: 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.

• Type: string

• Default: console-log.txt

  Tip

  %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.

• Type: boolean

• Default: 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

• Type: boolean

• Default: false

ConsoleColorMode

• Description:

  Use disable, legacy_4bit, vt100_4bit, vt100_8bit, or vt100_24bit.

  If the terminal shows garbled escape sequences like ←[0m, try legacy_4bit or disable color output.

• Type: string

• Default: vt100_24bit

Display_Input

• Description:

  Set this to false if you do not want MCC to echo the current input line while typing.

• Type: boolean

• Default: true

History_Input_Records

• Description:

  Maximum number of remembered console input lines.

• Type: integer

• Default: 32

Enable

• Description:

  Set this to false to disable command completion suggestions.

• Type: boolean

• Default: true

Enable_Color

• Description:

  Enables colored suggestions when the terminal color mode supports it.

• Type: boolean

• Default: true

Use_Basic_Arrow

• Description:

  Use this if the suggestion arrows are not displayed correctly in your terminal.

• Type: boolean

• Default: false

Max_Suggestion_Width

• Description:

  Maximum width of the suggestion popup.

• Type: integer

• Default: 30

Max_Displayed_Suggestions

• Description:

  Maximum number of suggestions shown at once.

• Type: integer

• Default: 6

Color fields

• Description:

  The suggestion text, tooltip, and arrow colors are stored as hex color strings such as #f8fafc.

  MCC validates these values on startup and falls back to built-in defaults if a color string is invalid.

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.

• Type: boolean

• Default: false

Enabled_Update

• Description:

  Use the proxy when MCC checks for updates.

• Type: boolean

• Default: false

Enabled_Ingame

• Description:

  Whether to connect to the game server through a proxy.

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

• Type: boolean

• Default: false

  Warning

  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.

  Proxy server must allow HTTPS for login, and non-443 ports for playing.

• Format:

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

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

Proxy_Type

• Description:

  The type of your proxy.

  Available options:

  • HTTP
  • SOCKS4
  • SOCKS4a
  • SOCKS5

• Type: string

• Default: HTTP

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:

Enabled

• Description:

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

• Type: boolean

• Default: true

Locale

• Description:

  Use any language implemented in Minecraft

• Type: string

• Default: en_US

RenderDistance

• Description:

  Render distance in chunks: 0 - 255

• Type: integer

• Default: 8

Difficulty

• Description:

  Available options:

  • peaceful
  • easy
  • normal
  • difficult

• Type: string

• Default: peaceful

ChatMode

• Description:

  This setting allows you to effectively mute yourself.

  Available options:

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

• Type: string

• Default: enabled

ChatColors

• Description:

  This setting allows you to disable chat colors.

• Type: boolean

• Default: true

MainHand

• Description:

  This setting allows you to specify your main hand.

• Available values: right and left

• Type: string

• Default: left

Cape

• Description:

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

• Type: boolean

• Default: true

Hat

• Description:

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

• Type: boolean

• Default: true

Jacket

• Description:

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

• Type: boolean

• Default: false

Sleeve_Left

• Description:

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

• Type: boolean

• Default: false

Sleeve_Right

• Description:

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

• Type: boolean

• Default: false

Pants_Left

• Description:

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

• Type: boolean

• Default: false

Pants_Right

• Description:

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

• Type: boolean

• Default: false

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.

• Type: boolean

• Default: 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.

• Type: boolean

• Default: false

Public

• Description:

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

  More on Regex here.

  Only works when Builtins is set to false.

• Type: 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).

  More on Regex here.

  Only works when Builtins is set to false.

• Type: 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).

  More on Regex here.

  Only works when Builtins is set to false.

• Type: string

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