配置

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帐户登录的方式,可用选项包括mccbrowser.

  • 类型字符串

  • 默认: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

    注意:当有大量凋灵时将会导致刷屏。

  • 描述:

    此设置用于自定义是否解析聊天消息中的链接并在控制台中显示它们。

  • 类型:boolean

  • 默认值:true

ShowInventoryLayout

  • 描述:

    此设置用于定义是否在使用/inventory内部命令时允许MCC使用字符画形式显示背包。

    预览:

    这里的 ASCII 艺术

  • 类型: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, blacklistwhitelist

    "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

聊天格式部分

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 )\.$'