SQDCLib

3.0.0 视频过场 过场现在可以整段换成一段视频。JSON 里写 video_id，客户端全屏播放，自动保持原始宽高比、自带上下黑边、隐藏 HUD、暂停背景音乐和天气音效，播完自动关闭并把结果告诉服务端。

格式只支持 MP4 / H.264。解码器是纯 Java 的 JCodec，已经打进 mod 里，玩家不需要额外安装任何东西。代价是不支持 WebM / VP9——纯 Java 没有可用的 VP9 解码器，硬要支持得带上几百 MB 的原生库。

视频文件放 assets/<命名空间>/videos/<名字>.mp4。

视频的声音 JCodec 只解视频轨，MP4 里的音轨会被忽略。声音要单独给：audio 字段填一个 sounds.json 里注册的音效 ID，它和视频同时开始播放。

这样反而更好控制——音量跟随玩家的音乐/音效设置，不用自己做混音。

失败不会卡住人 文件缺失、解码报错、或者三秒内没解出第一帧，都会直接关掉界面并按失败上报。玩家不会卡在黑屏里，日志里会带着完整路径说明原因。

其他 视频解码在后台线程，主线程每 tick 只做一次纹理上传，过场期间不会掉帧。播放按时间戳追赶，解码慢了就跳帧，不会越播越慢。