🔖需要帮助🔖

• 新增翻译
• 新增网页机器翻译器

欢迎在 Github 上提交 PR。

📋 概览

Chat Tools 是一个高度可自定义的 Minecraft 客户端模组，支持多种功能，并允许通过命令等方式让这些功能相互协作。

📖 术语表与技术细节

• 会话标识符 _(Chat Tools 专用术语)_ 是一个字符串，在单人模式下对应当前存档名称，在多人模式下对应服务器地址。相关正则表达式使用 matches() 方法进行匹配。
• 模式 _(通用术语)_ 指正则表达式模式。Chat Tools 对正则表达式使用 MULTILINE 模式，并通过 find() 方法进行匹配。
• Chat Tools 通过宏替换来维护多个版本。同一版本的 Chat Tools 在不同 Minecraft 版本之间可能会存在细微差异。
• 处理玩家消息时，Chat Tools 会移除颜色代码（§.）。
• 启用高级提示框（F3+H）后，你可以将鼠标悬停在配置页面上的配置项上，以查看其键、默认值和其他详细信息。

🛠️ 命令

• /chattools on – 启用模组。
• /chattools off – 禁用模组。
• /chattools opengui – 打开配置页面。
• /chattools download – 下载附加组件。
• /chattools regex_checker <pattern> [<test_content>] – 不带测试内容时：检查模式是否为有效的正则表达式。带测试内容时：验证模式，并测试其是否与内容匹配。
• /chattools send_to_client text <text_JSON_component> – 向客户端聊天栏发送指定文本。
• /chattools send_to_client actionbar <text_JSON_component> – 在客户端快捷栏上显示指定文本。
• /chattools config openfile – 打开配置文件（编辑后需要重启游戏才能应用更改）。
• /chattools config get <key> – 获取当前会话中特定配置键的值。
• /chattools config set <key> <value> [<save>] – 设置特定配置键的值。如果将 save 设置为 true，更改也会保存到文件中。
• /chattools config toggle <key> [<save>] – 切换布尔类型配置键的状态。如果将 save 设置为 true，更改也会保存到文件中。

✨ 功能介绍

如需详细说明和示例，请参阅 >>常见问题<<。

常规设置

以下是 Chat Tools 的核心设置：

• 显示时间戳 \

为每条消息添加时间戳。\

• 恢复消息 \

恢复之前会话中的消息。

• 隐藏昵称 \

在你的视角中隐藏真实昵称。\

• 翻译器

在聊天栏中按下 Shift + Tab 开始翻译。

• 启用聊天历史导航器

使用 Ctrl + F 开始在聊天中导航！

• 最大历史记录长度\

设置存储的聊天消息最大数量。\

通知器设置

各种聊天提醒功能：

• Toast 通知\

• 声音\

支持自定义音效。

• 快捷栏\

在快捷栏中显示提醒。

• 高亮\

支持自定义高亮前缀。\

• 允许列表\

匹配此列表的消息将被允许。

• 禁止列表\

匹配此列表的消息将被阻止（优先级高于允许列表）。

格式化器设置

使用指定的模式自定义消息。为不同的服务器应用不同的规则。查看气泡规则。

• 模式\

根据指定的样式自动格式化消息。\
例如：\
&e{text} 会在支持颜色前缀“&”的服务器上将你的消息显示为金色。\
&e{text} ~(ovo)~ 会添加个性化后缀。\
My coordinates are: {pos} 会将 {pos} 替换为你当前的坐标。

• 匹配时自动禁用……\

在某些情况下，你不希望自己的文本被格式化。\
包括但不限于：\
在箱子商店出售物品时的物品数量或 all；\
以特殊字符开头的命令。\
默认的 RegEx 模式 ^\d+$|^[.#%$/].*|\ball\b 可以覆盖大多数情况。\
你可以根据需要进行修改或添加。

聊天按键绑定

使用快捷键执行常用命令：

• 触发上一条命令快捷键\

按下设置的快捷键以重复上一条命令。\
例如：\
游玩跑酷地图时，执行 F3+C 并将其激活一段时间，之后每次按下快捷键，都可以快速回到记录的点位。

• 命令按键绑定\

为常用命令分配快捷键。\

气泡设置

• 启用聊天气泡\

在你的头顶显示聊天气泡。\

• 气泡规则\

为不同的服务器应用不同的气泡规则。\

自动回复设置

警告：在服务器上使用此功能前，请先征得其他玩家和管理员的同意！

• 启用自动回复\

自动回复他人的消息。

• 自动回复规则\

为不同的服务器应用不同的自动回复规则。

聊天过滤器设置

• 启用聊天过滤器\

根据特定规则过滤聊天消息。

• 过滤规则\

如果列表中的任意模式与收到的消息匹配，该消息将被过滤。