Yapılandırma
Minecraft Console Client can be both configured by the command line parameters and the configuration file.
By the default all of the configurations are stored in the configuration file named MinecraftClient.ini
which is created the first time you run the program, but you also can specify your own configuration file by providing a path to it as a first parameter when starting the MCC, check out Usage for examples.
Uyarı
Recently we have changed the configuration format from INI to TOML, the documentation had to be updated. If you spot a mistake, please report it on our Discord or in the repository as an issue.
Notlar
- Bazı ayarlar, sık kullanılmadıkları için belgelerden çıkarılacaktır, belgeler dağınık olmasını istemiyoruz, her ayarın yanında bir açıklamanın bulunduğu ayar dosyasını manuel olarak okumanızı tavsiye ederiz.
- Some plugin/bot related settings will be covered in the plugins section, not here
Yapılandırma Dosyası
Format
The configuration file uses the TOML format, all of the options are key-value pairs separated into sections.
Sections are defined in-between the square brackets (Example: [This is a section]
), each occurrence of this marks a beginning of a new section.
The settings/options are defined as key-value pairs, where the name of the setting and the value are separated by the equals sign =
(Example: some-setting=some value
).
Lines starting with #
are comments, they do not have an effect on the configuration of the program, their purpose is purely a descriptive one.
To get familiar with all the data types and styles of settings please read the official TOML documenation.
Bütün Örnek:
[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 }
Ana Bölüm
Main General section
- Section header:
Main.General
Account
Açıklama:
This setting is where you need to provide your in-game name (for offline accounts) or email for Microsoft accounts (Mojang accounts do not work anymore) and your password (if using an offline account, use
-
for the password).Format:
Account = { Login = "<email>", Password = "<password>" }
Type:
inline table
Örnek kullanım:
Account = { Login = "some.random.player@gmail.com", Password = "myEpicPassword123" }
Server
Açıklama:
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> }
Tip:
inline table
Örnek kullanım:
Server = { Host = "mysupercoolserver.com" }
Server = { Host = "192.168.1.27", Port = 12345 }
Server = { Host = "ServerAlias1" }
AccountType
Açıklama:
This setting is where you define the type of your account:
mojang
ormicrosoft
İpucu
Mojang accounts are going to stop working soon for everyone, they already are not working for some people.
Tip:
string
Varsayılan:
microsoft
Örnek kullanım:
AccountType = "microsoft"
Method
Açıklama:
This setting is where you define the way you will sign in with your Microsoft account, available options are
mcc
andbrowser
.Tip:
string
Varsayılan:
mcc
Örnek kullanım:
Method = "mcc"
Main Advanced section
- Section header:
Main.Advanced
Language
Açıklama:
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 link.
Tip:
string
Varsayılan:
en_gb
Örnek kullanım:
Language = "en_gb"
ConsoleTitle
Açıklama:
This setting is where you can change the title of the program window if you want to. You can use the variables in it.
Tip:
string
Default:
"%username%@%serverip% - Minecraft Console Client"
Örnek kullanım:
ConsoleTitle = "%username%@%serverip% - Minecraft Console Client"
InternalCmdChar
Açıklama:
This setting is where you can change the prefix character of internal MCC commands.
Available options:
none
slash
backslash
Tip:
string
Default:
slash
Örnek kullanım:
InternalCmdChar = "slash"
MessageCooldown
Açıklama:
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
BotOwners
Açıklama:
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", ]
Örnek kullanım:
BotOwners = [ "milutinke", "bradbyte", "BruceChen", ]
Uyarı
Admins can impersonate players on versions older than 1.19
MinecraftVersion
Açıklama:
This setting is where you can set the version you are playing on.
Format:
MinecraftVersion = "<version>"
Tip:
string
Version format:
1.X.X
Tip:
string
Default:
auto
Örnek kullanım:
MinecraftVersion = "1.18.2"
İpucu
MCC supports only 1.4.6 - 1.19.2
EnableForge
Açıklama:
This setting is where you can define if you're playing on a forge server.
Tip:
string
Available options:
auto
no
force
Default:
auto
İpucu
Force-enabling only works for MC 1.13 +
BrandInfo
Açıklama:
This setting is where you can change how MCC identifies itself to the server. It can be whatever you like, example:
vanilla
,mcc
,empty
.Tip:
string
Varsayılan:
mcc
İpucu
For playing on Hypixel you need to use
vanilla
ChatbotLogFile
Açıklama:
This setting is where you can set the path to the file which will contain the logs, leave empty for no log file.
Tip:
string
Default: Empty
Örnek kullanım:
ChatbotLogFile = "my-log.txt"
PrivateMsgsCmdName
Açıklama:
The name of the command which is used for remote control of the bot.
Tip:
string
Default:
tell
ShowSystemMessages
Açıklama:
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
Açıklama:
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
Açıklama:
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
Açıklama:
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
Açıklama:
This setting is where you can set if you want to enable terrain movement, so you can use command like
/move
and some bots.Uyarı
This feature is currently not supported in
1.4.6 - 1.6
.Type:
boolean
Default:
false
İpucu
Sometimes the latest versions might not support this straight away, since Mojang often makes changes to this.
InventoryHandling
Açıklama:
This setting is where you can set if you want to enable inventory handling using the
/inventory
command.Uyarı
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
Açıklama:
This setting is where you can set if you want to enable interactions with entities such as players, mobs, minecarts, etc..
Uyarı
This feature is currently not supported in
1.4.6 - 1.7
.Type:
boolean
Default:
false
İpucu
Sometimes the latest versions might not support this straight away, since Mojang often makes changes to this.
SessionCache
Açıklama:
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.Tip:
string
Default:
disk
ProfileKeyCache
Açıklama:
Same as
SessionCache
but for your profile keys which are used for chat signing and validation.Tip:
string
Default:
disk
ResolveSrvRecords
Açıklama:
Use
no
,fast
(5s timeout), oryes
.Required for joining some servers.
Tip:
string
Default:
fast
PlayerHeadAsIcon
Açıklama:
This setting allows you to set the icon of the program to be the head of your in-game skin.
Type:
boolean
Default:
true
İpucu
Only works on Windows XP-8 or Windows 10 with old console
ExitOnFailure
Açıklama:
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
Açıklama:
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
Açıklama:
This setting allows you to define if your want to have MCC prepend timestamps to chat messages.
Type:
boolean
Default:
false
AutoRespawn
Açıklama:
This setting allows you to define if your want to auto respawn if you die.
Type:
boolean
Default:
false
İpucu
Make sure the spawn point is safe
MinecraftRealms
Açıklama:
This setting allows you to define if your want to enable support for joining Minecraft Realms.
Type:
boolean
Default:
false
MoveHeadWhileWalking
Açıklama:
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
Açıklama:
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
Açıklama:
This setting allows you to disable emojis in the
chunk
command.Type:
boolean
Default:
true
MovementSpeed
Açıklama:
This setting allows you to change the movement speed of the bot.
Type:
integer
Default:
2
Uyarı
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
Account List section
Section header:
Main.Advanced.AccountList
Açıklama:
This section allows you to add multiple accounts so you can switch easily between them on the fly.
Usage examples:
/connect <serverip> Player1
Type:
array of inline tables
Format:
<account nick> = { Login = "<email>", Password = "<password>" }
Examples:
Player1 = { Login = "playerone@email.com", Password = "thepassword" }
Server List section
Section header:
Main.Advanced.ServerList
Açıklama:
This section allows you to add multiple server aliases which enables fast and easy switching between servers. Aliases cannot contain dots or spaces, and the name "localhost" cannot be used as an alias.
Usage examples:
/connect Server2
Type:
array of inline tables
Format:
<server alias> = { Host = "<ip>", Port = <port> }
Examples:
ServerAlias1 = { Host = "mc.awesomeserver.com" } ServerAlias2 = { Host = "192.168.1.27", Port = 12345 }
Signature section
Section header:
Signature
Açıklama:
Affects only Minecraft 1.19+.
This section contains settings related to a new chat reporting (signing and verifying) feature introduced by Mojang.
LoginWithSecureProfile
Açıklama:
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
Açıklama:
Whether to sign the chat sent from the MCC.
Type:
boolean
Default:
true
SignMessageInCommand
Açıklama:
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
Açıklama:
Use green color block to mark chat with legitimate signatures.
Type:
boolean
Default:
false
MarkModifiedMsg
Açıklama:
Sunucu tarafından değiştirilen sohbeti işaretlemek için sarı renk bloğu kullanın.
Type:
boolean
Default:
true
MarkIllegallySignedMsg
Açıklama:
Use red color block to mark chat without legitimate signature.
Type:
boolean
Default:
true
MarkSystemMessage
Açıklama:
Use gray color block to mark system message (always without signature).
Type:
boolean
Default:
false
ShowModifiedChat
Açıklama:
Set to true to display messages modified by the server, false to display the original signed messages.
Type:
boolean
Default:
true
ShowIllegalSignedChat
Açıklama:
Whether to display chat and messages in commands without legal signature.
Type:
boolean
Default:
true
Logging section
- Section header:
Logging
DebugMessages
Açıklama:
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
Açıklama:
This setting allows you to define if your want to see chat messages.
Type:
boolean
Default:
true
InfoMessages
Açıklama:
This setting allows you to define if your want to see info messages.
Most of the messages from MCC.
Type:
boolean
Default:
true
WarningMessages
Açıklama:
This setting allows you to define if your want to see warning messages.
Type:
boolean
Default:
true
ErrorMessages
Açıklama:
This setting allows you to define if your want to see error messages.
Type:
boolean
Default:
true
ChatFilterRegex
Açıklama:
This setting allows you to define if your want to filter chat messages being logged using a Regex expression.
More on Regex here.
Tip:
string
Default:
.*
İpucu
Not filtering anything by default
DebugFilterRegex
Açıklama:
This setting allows you to define if your want to filter debug messages being logged using a Regex expression.
More on Regex here.
Tip:
string
Default:
.*
İpucu
Not filtering anything by default
FilterMode
Açıklama:
Can be
disable
,blacklist
orwhitelist
"disable" will disable the filter,
blacklist
hides the messages, while thewhitelist
shows the messages that match the Regex expression that you've defined.Tip:
string
Default:
disable
LogToFile
Açıklama:
This setting allows you to define if your want to log messages to a file.
Type:
boolean
Default:
false
LogFile
Açıklama:
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
.Tip:
string
Default:
console-log.txt
İpucu
%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
Açıklama:
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
Açıklama:
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
App Vars section
Section header:
AppVar
Açıklama:
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:İpucu
%username%
,%serverip%
,%datetime%
are reserved variablesSection header:
Logging
Examples:
your_var = "your_value" "your var 2" = "your value 2"
Proxy section
Section header:
Proxy
Açıklama:
Connect to a server via a proxy instead of connecting directly.
Enabled_Login
Açıklama:
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_Ingame
Açıklama:
Oyun sunucusuna bir proxy aracılığıyla bağlanıp bağlanmayacağı.
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
Uyarı
Make sure your server rules allow Proxies or VPNs before setting the setting to
true
, or you may face consequences!
Server
Açıklama:
The proxy server IP and port.
Proxy sunucusu, oturum açmak için HTTPSye ve oynatma için 443 olmayan bağlantı noktalarına izin vermelidir.
Format:
Server = { Host = "<ip>", Port = <port> }
Default:
{ Host = "0.0.0.0", Port = 8080 }
Proxy_Type
Açıklama:
The type of your proxy.
Available options:
HTTPT
SOCKS4
SOCKS4a
SOCKS5
Tip:
string
Default:
HTTPT
Username
Açıklama:
The proxy account username.
Only needed for password protected proxies.
Default: ``
Password
Açıklama:
The proxy account password.
Only needed for password protected proxies.
Default: ``
MCSettings section
Section header:
MCSettings
Açıklama:
Client settings related to language, render distance, difficulty, chat and skins.
Enabled
Açıklama:
This setting allows you to specify if you want to use settings from this section.
Type:
boolean
Default:
true
Locale
Açıklama:
Use any language implemented in Minecraft
Tip:
string
Default:
en_US
RenderDistance
Açıklama:
Render distance in chunks:
0 - 255
Type:
integer
Default:
8
Difficulty
Açıklama:
Available options:
peaceful
easy
normal
difficult
Tip:
string
Default:
normal
ChatMode
Açıklama:
This setting allows you to effectively mute yourself.
Available options:
enabled
(You can chat)commands
(You can only do commands)disabled
Tip:
string
Default:
enabled
ChatColors
Açıklama:
This setting allows you to disable chat colors.
Type:
boolean
Default:
true
MainHand
Açıklama:
This setting allows you to specify your main hand.
Available values:
right
andleft
Tip:
string
Default:
left
MCSettings Skin section
Section header:
MCSettings.Skin
Açıklama:
Skin options.
Cape
Açıklama:
This setting allows you to specify if you want to have your skin cape shown.
Type:
boolean
Default:
true
Hat
Açıklama:
This setting allows you to specify if you want to have your skin hat shown.
Type:
boolean
Default:
true
Jacket
Açıklama:
This setting allows you to specify if you want to have your skin jacket shown.
Type:
boolean
Default:
false
Sleeve_Left
Açıklama:
This setting allows you to specify if you want to have your left sleeve shown.
Type:
boolean
Default:
false
Sleeve_Right
Açıklama:
This setting allows you to specify if you want to have your right sleeve shown.
Type:
boolean
Default:
false
Pants_Left
Açıklama:
This setting allows you to specify if you want to have your left part of the pants shown.
Type:
boolean
Default:
false
Pants_Right
Açıklama:
This setting allows you to specify if you want to have your right part of the pants shown.
Type:
boolean
Default:
false
Chat Format section
Section header:
ChatFormat
Açıklama:
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:
Çökme Nedenleri:
In-depth tutorials:
Testing Regex expressions online:
Builtins
Açıklama:
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
Açıklama:
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 inPublic
,Private
andTeleportRequest
.Type:
boolean
Default:
false
Public
Açıklama:
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 tofalse
.Tip:
string
Default:
Public = "^<([a-zA-Z0-9_]+)> (.+)$"
Private
Açıklama:
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 tofalse
.Tip:
string
Default:
Private = "^([a-zA-Z0-9_]+) whispers to you: (.+)$"
TeleportRequest
Açıklama:
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 tofalse
.Tip:
string
Default:
TeleportRequest = '^([a-zA-Z0-9_]+) has requested (?:to|that you) teleport to (?:you|them)\.$'