聊天画布

聊天画布

客户端视觉聊天HUD编辑器，支持自定义布局、文本样式、玩家颜色、提及、通知以及持久化命令剪贴板。

Chat Canvas

Chat Canvas 是一款用于 Minecraft Java 版客户端的聊天 HUD 自定义模组。它提供了一个可视化编辑器，让你可以直接在游戏内移动、调整大小、设置样式并预览聊天界面。

无需手动编辑配置文件，你可以将聊天框拖拽到所需位置，从任意边缘或角落调整其大小，并立即预览你的消息、输入框、背景、玩家名称和通知的显示效果。

Chat Canvas 还包含每位玩家的名称颜色、提及通知、玩家快捷操作以及持久化的命令剪贴板。

两种编辑器主题

Chat Canvas 包含两种可选择的视觉主题：

Chat Canvas 主题

现代化界面，包含：

  • 半透明浮动画板
  • 自定义控件
  • 现代强调色
  • 平滑的画板移动
  • 简洁、现代的外观

Minecraft 风格主题

旨在匹配 Minecraft 视觉语言的主题：

  • Minecraft 风格按钮
  • 方形边框和面板
  • 原版风格滑块和文本字段
  • 熟悉的灰色界面配色

两种主题使用完全相同的编辑器布局、功能、设置和编辑会话。切换主题只会改变编辑器的外观。

你可以随时切换主题，不会丢失未保存的更改、撤销历史或当前页面。

可视化聊天编辑器

编辑器会在当前游戏世界上方显示实时预览。

你可以：

  • 将聊天 HUD 拖拽到任意位置
  • 从四条边和四个角调整大小
  • 预览打开和关闭状态的聊天界面
  • 使用边缘和中心对齐参考线
  • 调整精确的 X 和 Y 坐标
  • 调整宽度和高度
  • 撤销和重做更改
  • 取消更改而不修改已保存的配置
  • 保存并立即将更改应用到真实的聊天 HUD

当设置面板会与聊天预览重叠时，它会自动移到对面一侧。

文字自定义

Chat Canvas 提供了丰富的文字控制选项：

  • 文字大小
  • 行间距
  • 字符间距
  • 文字不透明度
  • 文字阴影
  • 左对齐
  • 居中对齐
  • 右对齐

文字换行、可点击链接、悬停事件、玩家名称点击区域以及聊天交互坐标都会随着视觉文字布局的调整而同步调整。

字符间距也适用于聊天输入框，包括其光标、选中区域和鼠标定位。

背景自定义

消息背景可以独立于文字进行配置。

可用的消息背景模式：

  • 跟随文字
  • 全宽
  • 隐藏

其他选项包括：

  • 消息背景颜色
  • 消息背景不透明度
  • 水平内边距
  • 垂直内边距
  • 输入框背景颜色
  • 输入框不透明度
  • 输入框边框
  • 输入框边框颜色
  • 输入框边框不透明度

背景高度保持独立于行间距，避免在消息间距较大时出现大块黑色区域。

每位玩家的名称颜色

Chat Canvas 可以根据玩家的 UUID 为每位玩家分配一个稳定的颜色。

功能包括：

  • 基于 UUID 的自动配色
  • 跨会话保持颜色稳定
  • 手动颜色覆盖
  • 可自定义的颜色调色板
  • 在线玩家搜索
  • 恢复自动颜色
  • 保留服务器提供的颜色

只有玩家名称会被重新着色。消息内容、前缀、格式、点击事件、悬停事件、签名和指示符都会保持不变。

提及

在打开的聊天界面中双击玩家名称即可插入：

@玩家名

提及会插入到当前光标位置，或替换选中的文本。

Chat Canvas 永远不会自动发送消息。

提及功能包括：

  • 可配置的双击间隔
  • 提及文本高亮
  • 自定义高亮颜色
  • 可选加粗高亮
  • 可选要求包含 @ 符号
  • 不区分大小写的玩家名称匹配

提及通知

当其他玩家提及你的名字时，Chat Canvas 可以通过多种方式通知你。

可用的通知方式：

  • 可配置的声音
  • 可调节的音量
  • 可调节的音调
  • Toast 通知
  • 可配置的消息预览长度
  • 全屏颜色闪烁
  • 可配置的闪烁颜色
  • 可配置的闪烁不透明度
  • 可配置的闪烁持续时间

每种通知方式都可以独立启用或禁用。

重复处理、消息重新换行和聊天刷新不会对同一条消息触发重复通知。

玩家快捷操作

在聊天历史中右键点击玩家名称，打开快捷操作菜单。

可用的操作：

  • 提及玩家
  • 私信玩家
  • 复制玩家名称

私信模板可以根据不同的服务器进行自定义，例如：

/msg {player}

/tell {player}

/w {player}

这些操作只会修改聊天输入框。它们永远不会自动发送消息。

持久化命令剪贴板

Chat Canvas 包含一个全局命令剪贴板，用于保存常用命令。

命令剪贴板不绑定到特定的世界或服务器。保存的命令在离开世界、更换服务器或重启游戏后仍然可用。

功能包括：

  • 保存当前输入的命令
  • 自定义命令标题
  • 分类
  • 收藏
  • 搜索
  • 最近使用的命令
  • 使用次数统计
  • 编辑命令
  • 删除命令
  • 重新排序命令
  • 清空某个分类
  • 清除非收藏命令
  • 清空所有保存的命令
  • 在光标处插入
  • 替换当前输入
  • Shift+点击可临时反转插入模式
  • 内置常用命令预设

点击命令只会将其放入聊天输入框。它永远不会被自动执行。

命令启动按钮会在命令剪贴板打开时自动隐藏，并在面板关闭后重新出现。

命令安全

命令剪贴板在本地以纯文本 JSON 格式存储已保存的命令。

不要在共用或不可信的计算机上保存密码、访问令牌或私人信息。这包括以下命令：

  • /login
  • /register
  • /password
  • /changepassword

Chat Canvas 会在保存可能包含敏感信息的命令之前显示警告。

Chat Canvas 不会上传你的命令，也不会将其发送给模组作者。

兼容性

Chat Canvas 包含对以下模组的兼容处理：

Chat Heads

Chat Canvas 本身不提供玩家头像。Chat Heads 可以继续在自定义的文本、背景和对齐方式旁渲染头像。

玩家名称的点击区域不包含头像。

More Chat History

Chat Canvas 不会替换或限制聊天历史容量。More Chat History 仍负责增加历史记录上限。

ChatAnimation

Chat Canvas 不会添加单独的消息进入动画。ChatAnimation 可以继续处理消息动画。

Smooth Scrolling

Chat Canvas 不会实现另一种滚动动画。Smooth Scrolling 可以继续处理聊天滚动。

兼容性可能因模组版本、资源包、自定义字体、GUI 缩放比例和整合包配置而有所不同。

需求

  • Minecraft 1.21.1
  • Java 21 或更新版本
  • Fabric Loader 0.19.3 或更新版本
  • Fabric API 0.116.14+1.21.1 或兼容的更新版本
  • owo-lib 0.12.15.4+1.21 或兼容的更新版本

可选：

  • Mod Menu 11.0.4 或兼容版本

安装

  1. 为 Minecraft 1.21.1 安装 Fabric Loader。
  2. 安装 Fabric API。
  3. 安装 owo-lib。
  4. 将 Chat Canvas 的 JAR 文件放入 mods 文件夹。
  5. 启动游戏。
  6. 进入世界，然后按默认的 K 键打开编辑器。

Chat Canvas 是一个客户端模组。服务器无需安装。

该模组不会绕过服务器权限。某个命令或私信命令是否可用取决于服务器。

基本操作

  • 按 K 键打开 Chat Canvas 编辑器
  • 按 T 键打开普通聊天界面
  • 双击玩家名称以提及他们
  • 右键点击玩家名称打开快捷操作
  • 点击 命令 按钮打开命令剪贴板
  • 使用 Ctrl+Z 撤销
  • 使用 Ctrl+Y 重做

数字控件支持：

  • 按住鼠标左键并水平拖拽
  • 使用鼠标滚轮进行微调
  • 按住 Shift 进行精确调整
  • 按住 Ctrl 进行快速调整
  • 右键点击恢复默认值

配置文件

主配置：

.minecraft/config/chat_canvas.json

命令剪贴板：

.minecraft/config/chat_canvas/command_clipboard.json

这些文件是全局客户端数据，不会存储在单个的世界存档中。

手动编辑或删除这些文件前请先进行备份。

删除主配置会恢复 Chat Canvas 的默认设置。删除命令剪贴板文件会移除所有用户保存的命令。

已知限制

  • 目前仅支持 Minecraft 1.21.1 的 Fabric 版本
  • 目前没有可用的 Forge 或 NeoForge 版本
  • Chat Canvas 仅限客户端使用
  • 不包含玩家头像
  • 不包含消息进入动画
  • 不包含聊天滚动动画
  • 某些服务器插件会将玩家聊天转换为系统消息
  • 在高度自定义的服务器聊天格式中，玩家身份可能无法被检测到
  • 当发送者无法被可靠识别时，玩家颜色和快捷操作可能无法生效
  • 自定义字体可能会改变文字宽度、换行和点击区域
  • 私信命令因服务器而异
  • 服务器权限仍然适用于每个命令
  • 保存的命令在本地以纯文本形式存储

问题反馈

反馈问题时，请包含：

  • Chat Canvas 版本
  • Minecraft 版本
  • Fabric Loader 版本
  • Fabric API 版本
  • owo-lib 版本
  • Mod Menu 版本
  • 其他聊天相关模组
  • GUI 缩放比例
  • 聊天缩放比例
  • 资源包或自定义字体
  • latest.log
  • 截图或视频
  • 清晰的重现步骤
  • 该问题是否在仅安装 Chat Canvas 及其必要依赖时也会出现

请在 GitHub 问题追踪器 上报告问题。

作者与链接

Chat Canvas 由 ShouYun / 寿云 开发和维护。

许可证

Chat Canvas 根据 MIT 许可证授权。

你可以根据许可证条款使用、修改和分发该项目。