English Description

Chat Upgrade is a Fabric mod that enhances Minecraft chat with rich media rendering.

Key Features

Inline media preview: Recognizes [[ChatUpgrade,url=…]] payloads and replaces links with placeholders. Renders images, audio players, and video players directly inside the chat message area.
Inline emojis: Uses [:token] syntax (e.g. [:bilibili_tv_gif-2]) and a mapping from owo.json to display square emoji images.
Flexible upload modes:
- Auto mode (default): If the server supports media uploads, files go directly to the server. Otherwise, uses third‑party hosting (Litterbox, ~1h expiry).
- Server mode / Third‑party mode: Forced routing via commands or config.
Optional server‑side storage: When installed on the server, clients upload media directly to the server. Other clients fetch the bytes via server packets and render them.
Rich command system: Upload from folder, picker, or clipboard; adjust volumes, limits, manual reveal toggles, and plugin management (FFmpeg, APNG).
High‑definition rendering: Uses supersampling and proper texture scaling to keep previews sharp at any GUI scale or window size.
ChatImage compatibility mode: Can send images using the [[CICode,…]] format for compatibility with ChatImage.

Commands (Client‑side, /chatupgrade …)

send, sendaudio, sendvideo – Send a URL as a media payload.
upload folder|pick|paste – Upload and send image from local path/file picker/clipboard.
uploadaudio, uploadvideo – Same for audio or video files.
config … – Change upload mode, manual reveal, volumes, size limits, smooth scroll, etc.
plugin status|load|download – Manage FFmpeg and APNG plugins (auto‑downloaded on first use).

Configuration

File: config/chat-upgrade/chat-upgrade.json
Options include: ciCompatibility, manualImageReveal, audioVolumePercent, maxReceiveBytes, uploadMode, and more. Reloadable in‑game.

Notes

FFmpeg and APNG plugins are not bundled – they are downloaded automatically on first use to config/chat-upgrade/libs/.
Server‑side direct upload mode does not support the CICode compatibility format.
Supported formats: images (png, apng, jpg, gif, webp, bmp, tif, ico, etc.), audio (ogg, wav, mp3, flac, m4a, aac, opus, webm), video (mp4, webm, mov, mkv, m4v, avi).

中文说明

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）。