聊天工具箱

🔖需要帮助🔖

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

欢迎在 Github 上提交 Pull Request。

---

📋 概述

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，更改也会保存到文件中。

✨ 功能介绍

详细的描述和示例请参见 > > FAQ < <。

常规设置

这是 Chat Tools 的核心设置：

• 显示时间戳
  为每条消息添加时间戳。
  
• 恢复消息
  恢复之前会话中的消息。
• 隐藏昵称
  从你的视角隐藏真实昵称。
  
• 翻译
  在聊天栏中按 Shift + Tab 开始翻译。
• 启用聊天历史导航
  在聊天中使用 Ctrl + F 进行导航！
  
• 最大历史记录长度
  设置存储聊天消息的最大数量。
  

通知设置

各种聊天提醒功能：

• 弹出通知
  
• 音效
  支持自定义音效。
• 动作栏
  在动作栏显示提醒。
• 高亮
  支持自定义高亮前缀。
  
• 允许列表
  匹配此列表的消息被允许显示。
• 禁止列表
  匹配此列表的消息被屏蔽（优先级高于允许列表）。

格式化设置

使用指定的模式自定义你的消息。在不同服务器上应用不同规则。参见气泡规则。

• 模式
  根据指定样式自动格式化消息。
  例如：
  &e{text} 在支持颜色前缀 '&' 的服务器上使你的消息变为金色。
  &e{text} ~(ovo)~ 添加个性化后缀。
  My coordinates are: {pos} 将 {pos} 替换为你当前的坐标。
• 匹配时自动禁用...
  在某些情况下，你 不希望 文本被格式化。
  这包括（但不限于）：
  向木牌商店出售物品时的物品数量或 all；
  以特殊字符开头的命令。
  默认正则模式 ^\d+$|^[.#%$/].*|\ball\b 涵盖大多数情况。
  你可以根据需要进行修改或添加。

聊天快捷键

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

• 触发最后命令快捷键
  按下设置的快捷键重复上一条命令。
  例如：
  在玩跑酷地图时，按 F3+C 并激活此功能，之后每次按快捷键即可快速回到记录的点位。
• 命令快捷键绑定
  将快捷键分配给常用命令。
  

气泡设置

• 启用聊天气泡
  在你头顶显示聊天气泡。
  
• 气泡规则
  在不同服务器上应用不同的气泡规则。
  

回复设置

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

• 启用回复
  自动回复他人的消息。
• 回复规则
  在不同服务器上应用不同的回复规则。

聊天过滤设置

• 启用聊天过滤
  根据特定规则过滤聊天消息。
• 过滤规则
  如果此列表中的任何模式匹配到接收的消息，该消息将被过滤。