聊天升级

聊天升级

为Minecraft聊天添加内联图片、音频和视频渲染。支持预览、表情符号以及可选的服务器端直接上传。

社交

Chat Upgrade 是一款基于 Fabric 的模组,为 Minecraft 聊天提供丰富的媒体渲染能力。

主要功能

  • 内联媒体预览:识别 [[ChatUpgrade,url=…]] 载荷,并将链接替换为占位符。直接在聊天消息区域内渲染图片、音频播放器和视频播放器。
  • 内联表情:使用 [:token] 语法(例如 [:bilibili_tv_gif-2]),并通过 owo.json 中的映射显示方形表情图片。
  • 灵活的上传模式:
    • 自动模式(默认):如果服务器支持媒体上传,文件会直接上传到服务器。否则使用第三方托管(Litterbox,约 1 小时有效期)。
    • 服务端模式 / 第三方模式:通过命令或配置强制指定路由。
  • 可选的服务端存储:在服务端安装后,客户端会将媒体直接上传到服务器。其他客户端通过服务端数据包获取字节内容并渲染。
  • 丰富的命令系统:从文件夹、选择器或剪贴板上传;调整音量、限制、手动显示开关以及插件管理(FFmpeg、APNG)。
  • 高清渲染:使用超采样和适当的纹理缩放,使预览在任何 GUI 缩放比例或窗口大小下都保持清晰。
  • ChatImage 兼容模式:可以使用 [[CICode,…]] 格式发送图片,以兼容 ChatImage。

命令(客户端侧,/chatupgrade …)

  • send、sendaudio、sendvideo – 将 URL 作为媒体载荷发送。
  • upload folder|pick|paste – 从本地路径/文件选择器/剪贴板上传并发送图片。
  • uploadaudio、uploadvideo – 对音频或视频文件执行相同操作。
  • config … – 更改上传模式、手动显示、音量、大小限制、平滑滚动等。
  • plugin status|load|download – 管理 FFmpeg 和 APNG 插件(首次使用时自动下载)。

配置

文件:config/chat-upgrade/chat-upgrade.json
选项包括:ciCompatibility、manualImageReveal、audioVolumePercent、maxReceiveBytes、uploadMode 等。可在游戏内重新加载。

注意事项

  • FFmpeg 和 APNG 插件未随模组捆绑 – 首次使用时会自动下载到 config/chat-upgrade/libs/。
  • 服务端直传模式不支持 CICode 兼容格式。
  • 支持的格式:图片(png、apng、jpg、gif、webp、bmp、tif、ico 等)、音频(ogg、wav、mp3、flac、m4a、aac、opus、webm)、视频(mp4、webm、mov、mkv、m4v、avi)。