配置
Minecraft控制台客户端可以通过控制台和配置文件进行配置。
默认情况下,所有配置都存储在名为Minecraft Client.ini的配置文件中,该文件是您第一次运行程序时创建的,但您也可以通过在启动MCC时提供路径作为第一个参数来指定自己的配置文件,你可从这 (Usage) 找到例子
警告
我们最近将配置格式从INI更改为TOML,文档必须更新。 如果您发现错误,请在我们的Discord或仓库中报告错误。
注意事项
- 某些设置将从文档中省略,因为它们没有经常被使用,我们不希望将文档归入黑名单。 我们建议您通过配置文件手动阅读,在配置文件中,每个设置旁边都有描述。
- 一些与插件/机器人相关的设置将在插件部分介绍,而不是在这里
配置文件
格式
配置文件使用 TOML 格式,所有选项都是按键值对,分隔成部分。
部分是在方括号之间定义的(例如: [这是一个部分]
) 每次出现这种情况都标志着一个新章节的开始。
设置/选项被定义为键值对, 设置的名称和值用等效标志 =
(例如: some-setting=some value
).
以 #
开头的行是注释。 它们对程序的配置没有影响,其目的纯粹是描述性的。
若要熟悉所有数据类型和设置风格,请阅读 官方TOM文档。
完整示例:
[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 }
主要部分
常规部分
- 类型:
整数
Account
描述:
在此设置中,您需要提供游戏内名称(离线模式)或Microsoft帐户的电子邮件(Mojang帐户已经不再工作)和密码(如果使用离线帐户,请使用
-
作为密码)。格式:
Account = { Login = "<email>", Password = "<password>" }
类型:
列表
示例:
Account = { Login = "some.random.player@gmail.com", Password = "myEpicPassword123" }
Server
描述:
这是您提供游戏服务器地址的设置,“Host”可以填写域名或IP地址。 (“Post”字段可以删除,mcc将自动解析)
Host还可以在下面的“服务器列表”中填写你所编辑的服务器的昵称。
格式
服务器 = { 主机 = "<ip>", 端口 = <port> }
类型:
列表
示例:
Server = { Host = "mysupercoolserver.com" }
Server = { Host = "192.168.1.27", Port = 12345 }
Server = { Host = "ServerAlias1" }
AccountType
描述:
此设置用于定义帐户类型:
mojang
或者microsoft
提示
Mojang帐户将已经停止登录了
类型:
字符串
默认:
microsoft
示例:
AccountType = "microsoft"
Method
描述:
此设置用于定义使用Microsoft帐户登录的方式,可用选项包括
mcc
和browser
.类型:
字符串
默认:
mcc
示例:
Method = "mcc"
高级部分
- 节标题:
Main.Advanced
Language
描述:
此设置决定了您使用的语言
当连接到1.6+服务器时,您需要一个翻译文件才能正确显示一些聊天消息。这些文件描述了根据您偏好的语言如何显示某些消息。
如果您的计算机上安装了Minecraft,客户端将从您的Minecraft文件夹自动加载
en_GB.lang
,否则从Mojang的服务器上下载。 您可以在配置文件中选择其他语言。点击 此处 查看您的语言代码。
类型:
字符串
默认:
en_gb
示例:
Language = "en_gb"
ConsoleTitle
描述:
此设置用于改变程序窗口标题。 您可以在其中使用变量。
类型:
字符串
默认:
"%username%@%serverip% - Minecraft 命令行客户端"
示例:
ConsoleTitle = "%username%@%serverip% - Minecraft Console Client"
InternalCmdChar
描述:
此设置用于更改内部MCC命令的前缀字符。
可用选项:
none
slash
backslash
类型:
字符串
默认:
slash
示例:
InternalCmdChar = "slash"
MessageCooldown
描述:
此设置用于更改两条相邻消息间的最小延迟,以避免因大量发送消息被踢出。
类型:
浮点数
默认:
1.0
BotOwners
描述:
此设置用于设置机器人/客户端的所有者,可以用于一些插件。 各名称作为字符串在数组中用逗号分隔开。
格式:
BotOwners = [ "<nick>", "<nick>", ... ]
类型:
字符串数组
默认
[ "Player1", "Player2", ]
示例:
BotOwners = [ "milutinke", "bradbyte", "BruceChen", ]
警告
管理员可以在低于1.19的版本假冒玩家(/nick)
MinecraftVersion
描述:
可以设置MCC的MC版本
格式:
MinecraftVersion = "<version>"
类型:
string
版本格式:
1.X.X
类型:
string
默认:
auto
示例:
MinecraftVersion = "1.18.2"
提示
MCC只支持 1.4.6 - 1.19.2
EnableForge
描述:
此设置用于配置是否正在forge端上游玩。
类型:
string
选项:
auto
no
force
默认:
auto
提示
Force选项只适用于 MC 1.13 +
BrandInfo
描述:
此设置用于修改MCC连接到服务器时如何标识客户端类型。 它可以是您喜欢的任何值,例如:
vanilla
(原版)mcc
(MCC客户端),empty
(空)。类型:
string
默认:
mcc
提示
**要在 Hypixel 上游玩,您需要使用 ‘vanilla’ **
ChatbotLogFile
描述:
这个设置是关于日志文件路径, 留空则无日志文件.
类型:
string
**默认:**无
示例:
ChatbotLogFile = "my-log.txt"
PrivateMsgsCmdName
描述:
用于远程控制机器人的私聊指令.
类型:
string
默认:
tell
ShowSystemMessages
描述:
此设置用于定义当您是管理员时是否显示系统消息(例如命令方块输出)。
类型:
boolean
默认值:
true
ShowXPBarMessages
描述:
此设置用于定义是否显示Boss XP Bar 消息。
类型:
boolean
默认值:
true
注意:当有大量凋灵时将会导致刷屏。
ShowChatLinks
描述:
此设置用于自定义是否解析聊天消息中的链接并在控制台中显示它们。
类型:
boolean
默认值:
true
ShowInventoryLayout
描述:
此设置用于定义是否在使用
/inventory
内部命令时允许MCC使用字符画形式显示背包。预览:
类型:
boolean
默认值:
true
TerrainAndMovements
描述:
此设置用于定义是否启用地形移动,启用后可以使用
/move
等命令和一些机器人。警告
此功能目前在
1.4.6 - 1.6
中不支持。类型:
boolean
默认:
false
。
提示
有时最新版本可能不会立即支持这个,因为Mojang经常对此做出更改。
InventoryHandling
描述:
此设置用于定义是否使用
/inventory
命令启用背包处理。警告
此特性目前在
1.4.6 - 1.9
中不受支持。 但我们正在努力适配 1.8 和 1.9。类型:
boolean
默认:
false
EntityHandling
描述:
此设置用于定义是否启用与诸如玩家、 生物、 矿车等实体的交互功能。
警告
此特性目前在
1.4.6 - 1.7
中不受支持。类型:
boolean
默认:
false
。提示
有时最新版本可能不会立即支持这个,因为Mojang经常对此做出更改。
SessionCache
描述:
此设置用于定义您的会话信息储存在磁盘或是内存中。抑或是不进行保存(这将使你需要每次登录且给进程增加些时间)。
你可以使用
none
来禁用此选项。disk
选项将在磁盘上保存您的登录授权令牌, 但如果其他人可以访问您已安装MCC的文件夹,这可能会导致安全风险。memory
将持续到您关闭程序为止。类型:
字符串
默认:
disk
ProfileKeyCache
描述:
与
SessionCache
相同,但您的个人资料密钥用于聊天签名和验证。类型:
字符串
默认:
disk
ResolveSrvRecords
描述:
使用
no
,fast
(5秒超时), 或yes
。加入某些服务器时需要。
类型:
字符串
默认:
fast
PlayerHeadAsIcon
描述:
此设置允许您将程序图标设置为您游戏内皮肤的头部。
类型:
boolean
默认值:
true
提示
只能使用旧的控制台在 Windows XP-8 或 Windows 10 上运行
ExitOnFailure
描述:
此设置允许您定义是否要在错误时禁用暂停,以便在非交互脚本中使用 MCC
类型:
boolean
默认:
false
。
CacheScript
描述:
此设置允许您定义您是否想要让MCC缓存编译脚本在低端设备上加载更快。
类型:
boolean
默认值:
true
Timestamps
描述:
此设置允许您定义您是否想要让MCC在聊天信息前添加时间戳。
类型:
boolean
默认:
false
。
AutoRespawn
描述:
此设置允许您定义死亡后是否要自动重生。
类型:
boolean
默认:
false
。提示
请确保出生点安全
MinecraftRealms
描述:
此设置允许您定义是否要启用对加入Minecraft Realms的支持。
类型:
boolean
默认:
false
。
MoveHeadWhileWalking
描述:
此设置允许您定义您是否想要在步行时启用头部移动以避免反作弊。
类型:
boolean
默认值:
true
TcpTimeout
描述:
此设置允许您定义自定义超时时间,以秒为单位。 确保你知道你在做什么时使用。
类型:
整型
默认值:
30
EnableEmoji
描述:
此设置允许您在
chunk
命令禁用表情符号。类型:
boolean
默认值:
true
MovementSpeed
描述:
此设置允许您更改机器人的移动速度。
类型:
整型
默认:
2
警告
大于 2 的移动速度可能会被某些插件视为作弊。
IgnoreInvalidPlayerName
描述:
Minecraft玩家名称只能由英文字母、数字和下划线符号组成。 默认情况下,其他名称将被视为无效并被忽略。
类型:
boolean
默认值:
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
描述:
仅Microsoft 帐户。 如果禁用,将无法用
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
描述:
此设置允许您定义是否在客户端运行时看到调试消息。当出现错误并且你想报告一个问题、或者你正在开发一个脚本/机器人且你想要调试它时,此功能将会很有用。
类型:
boolean
默认:
false
。
ChatMessages
描述:
此设置允许您定义是否要看到聊天消息。
类型:
boolean
默认值:
true
InfoMessages
描述:
此设置允许您定义是否要查看信息消息。
它们大部分来自MCC。
类型:
boolean
默认值:
true
WarningMessages
描述:
此设置允许您定义是否要看到警告消息。
类型:
boolean
默认值:
true
ErrorMessages
描述:
此设置允许您定义是否要看到报错消息。
类型:
boolean
默认值:
true
ChatFilterRegex
描述:
此设置允许您定义是否要使用正则表达式过滤记录到日志的聊天消息。
有关正则表达式的更多内容请在 此处 查看。
类型:
字符串
默认:
.*
提示
默认不过滤任何内容
DebugFilterRegex
描述:
此设置允许您定义是否要使用正则表达式过滤记录到日志的调试消息。
有关正则表达式的更多内容请在 此处 查看。
类型:
字符串
默认:
.*
提示
默认不过滤任何内容
FilterMode
描述:
可用值:
disable
,blacklist
或whitelist
"disable" 将禁用过滤器,
blacklist
隐藏匹配您正则表达式的消息,而whitelist
只展示它们。类型:
字符串
默认值:
disable
LogToFile
描述:
此设置允许您定义是否要将消息记录到文件中。
类型:
boolean
默认:
false
。
LogFile
描述:
此设置用于定义消息文件的路径,修改上一项设置为
LogToFile = true
以启用记录。类型:
字符串
默认值:
console-log.txt
提示
%username% 和 %serverip% 将被您所连接的服务器的用户名和IP地址替换。 所以您可以使用像这样的值:“console-log-%username%-%serverip%.txt”
PrependTimestamp
描述:
此设置允许您定义是否想要在写入日志文件的消息前添加时间戳。
类型:
boolean
默认:
false
。
SaveColorCodes
描述:
此设置允许您定义是否要在记录的消息中保留服务器颜色代码。
颜色代码消息示例:
§bsome 消息
类型:
boolean
默认:
false
。
应用变量部分
节标题:
AppVar
描述:
此部分允许您定义自己的自定义设置/变量,您可以在脚本、机器人或其他设置字段中使用。
要定义一个变量/设置,只需在
[AppVar.VarStirng]
部分下使用以下格式创建一个新行:提示
“%username%”, “%serverip%”, “%datetime%”是保留变量
节标题:
Logging
示例:
your_var = "your_value" "your var 2" = "your value 2"
代理部分
节标题:
Proxy
描述:
通过代理连接到服务器,而不是直接连接。
Enabled_Login
描述:
如果Mojang会话服务或微软登录服务在您的网络上被阻止或您的IP被黑名单或被微软限制, 将值设置为
true
。类型:
boolean
默认:
false
。
Enabled_Ingame
描述:
是否通过代理连接Minecraft游戏服务器。
如果连接到端口25565 (Minecraft) 在您的网络上被阻止,将值设置为
true
来登录并使用代理连接.类型:
boolean
默认:
false
。警告
请确保您的服务器规则允许代理服务器或 VPN,然后设置为 “true”,否则后果自负!
Server
描述:
代理服务器 IP 和端口。
代理服务器必须允许HTTPS登录。
格式:
Server = { Host = "<ip>", Port = <port> }
默认值:
{ Host = "0.0.0.0", Port = 8080 }
Proxy_Type
描述:
您的代理服务器类型。
可用选项:
HTTPT
SOCKS4
SOCKS4a
SOCKS5
类型:
字符串
默认值:
HTTPT
Username
描述:
代理帐户用户名。
仅密码保护代理服务器所需。
默认值: ``
Password
描述:
代理帐户密码。
仅密码保护代理服务器所需。
默认值: ``
MC设置部分
节标题
MCSettings
描述:
客户端设置与语言、显示距离、难度、聊天和皮肤有关。
Enabled
描述:
此设置允许您指定是否要使用此部分的设置。
类型:
boolean
默认值:
true
Locale
描述:
请使用Minecraft的语言代码填写,详见[Main.Advanced.Language]
类型:
字符串
默认:
en_US
RenderDistance
描述:
区块渲染距离:
0 - 255
类型:
整型
默认值:
8
Difficulty
描述:
可用选项:
peaceful
easy
normal
difficult
类型:
字符串
默认值:
normal
ChatMode
描述:
这个设置允许您有效地静音自己。
可用选项:
enabled
(您可以发送聊天信息)commands
(您只能使用命令)disabled
类型:
字符串
默认值:
enable
ChatColors
描述:
此设置允许您禁用聊天颜色。
类型:
boolean
默认值:
true
MainHand
描述:
这个设置允许您指定您的主手。
有效值:
右
和左
。类型:
字符串
默认:
left
MC设置皮肤部分
节标题
MC皮肤设置
描述:
皮肤选项。
Cape
描述:
这个设置允许您指定是否要显示披风
类型:
boolean
默认值:
true
Hat
描述:
这个设置允许您指定是否要显示帽子。
类型:
boolean
默认值:
true
Jacket
描述:
这个设置允许您指定是否要显示外套。
类型:
boolean
默认:
false
。
Sleeve_Left
描述:
这个设置允许您指定是否要显示左袖。
类型:
boolean
默认:
false
。
Sleeve_Right
描述:
这个设置允许您指定是否要显示右袖。
类型:
boolean
默认:
false
。
Pants_Left
描述:
这个设置允许您指定是否要显示左裤腿。
类型:
boolean
默认:
false
。
Pants_Right
描述:
这个设置允许您指定是否要显示右裤腿。
类型:
boolean
默认:
false
。
聊天格式部分
节标题:
ChatFormat
描述:
MCC可以最好地检测聊天信息,但有些服务器有不寻常的聊天格式。
发生这种情况时,您需要使用此部分的设置来配置您自己的聊天格式。
MCC使用正则表达式 (Regex) 检测聊天格式, 如果你不熟悉正则表达式,你可以使用以下资源来学习并测试它:
Builtins
描述:
此设置允许您定义是否要使用默认聊天格式。
设置为
false
以避免与自定义格式发生冲突。类型:
boolean
默认值:
true
UserDefined
描述:
此设置允许您定义是否要使用自定义的频道格式使用 Regex。
设置为
true
以使用在公共
和私人
和传送请求
中定义的自定义格式。类型:
boolean
默认:
false
。
Public
描述:
此设置允许您指定使用 Regex (正则表达式) 的 传送 请求自定义聊天信息格式。
有关正则表达式的更多内容请在 此处 查看。
仅当
Builtins
被设置为false
时才能正常工作。类型:
字符串
默认:
Public = "^<([a-zA-Z0-9_]+)> (.+)$"
Private
描述:
此设置允许您使用Regex(正则表达式)为私人消息指定自定义聊天消息格式。
有关正则表达式的更多内容请在 此处 查看。
仅当
Builtins
被设置为false
时才能正常工作。类型:
字符串
默认值:
Private = "^([a-zA-Z0-9_]+) whispers to you: (.+)$"
TeleportRequest
描述:
此设置允许您指定使用 Regex(正则表达式)的传送请求自定义聊天信息格式。
更多关于正则表达式的信息请在 这里 查看
仅当
Builtins
被设置为false
时才能正常工作。类型:
字符串
默认值:
TelportRequest = '^([a-zA-Z0-9_]+) 已请求 (?:to|that you) 传送到 (?:you|them )\.$'