Mcedia Core

Mcedia Core 是一个客户端媒体播放模组，为 Minecraft 提供本地运行的媒体播放基础能力，重点放在游戏内视频画面渲染、音频播放、弹幕显示以及播放性能控制。 它面向需要在客户端内加载和播放媒体内容的使用场景，提供稳定的播放宿主、屏幕渲染能力，以及围绕解码与上传开销的运行时调度。 ## 主要特性 - 在客户端内播放媒体内容，并将画面渲染到游戏世界中的屏幕表面 - 支持空间音频播放，可结合左右声道实现更有方向感的声音表现 - 支持弹幕显示，可按需开启或关闭 - 提供全局视频音量控制，并集成到原版声音设置界面 - 支持播放过程中的基础控制，包括暂停、恢复、倍速与跳转 - 提供分辨率上限、活跃解码器数量、节流解码器数量等性能相关配置 - 对不可见或距离较远的播放实例进行节流或挂起，降低不必要的解码与纹理上传开销 - 在检测到 `Sound Physics Remastered` 时启用兼容，使视频声音可参与物理声效处理 ## 性能与行为 Mcedia Core 不只是简单地“播放视频”，还会根据可见性与距离动态管理解码器状态： - 优先保证当前可见、正在播放的内容 - 对次要内容启用低开销模式 - 对长时间不需要更新的内容暂停解码 - 在屏幕不可见时跳过纹理上传，减少客户端负担 这使它在存在多个播放实例时，仍能尽量维持可用的性能表现。 ## 配置项 模组当前提供的可调项主要包括： - 最大视频分辨率上限 - 全局音量倍率 - 活跃解码器数量上限 - 节流解码器数量上限 - 低开销上传帧率 - 弹幕显示开关 这些设置会保存在客户端配置文件中，并在游戏启动时自动加载。 --- Mcedia Core is a client-side media playback mod for Minecraft. It provides the core runtime needed to play media inside the game, with a focus on in-world video rendering, audio playback, danmaku display, and playback performance management. It is designed for client-side media playback scenarios that need a stable playback host, screen rendering support, and practical runtime controls around decoding and texture upload cost. ## Features - Plays media on the client and renders video onto in-world screen surfaces - Supports spatial audio playback, including left/right channel separation for better directional sound - Supports danmaku display, with the ability to enable or disable it as needed - Adds a global video volume control and integrates it into the vanilla sound settings screen - Provides basic playback controls such as pause, resume, playback speed adjustment, and seeking - Includes performance-related settings such as maximum video resolution, active decoder limit, and throttled decoder limit - Dynamically throttles or suspends less important playback instances to reduce unnecessary decoding and texture upload overhead - Enables compatibility with `Sound Physics Remastered` when present, allowing video audio to participate in sound physics processing ## Performance Behavior Mcedia Core does more than just play video. It actively manages decoder state based on visibility and distance: - Prioritizes visible and actively playing content - Uses a lower-overhead mode for less important instances - Suspends decoding for content that no longer needs active updates - Skips texture uploads when a screen is not visible This helps keep client performance under control, especially when multiple playback instances exist at the same time. ## Configuration The mod currently exposes configuration for: - Maximum video resolution - Global volume factor - Active decoder limit - Throttled decoder limit - Low-overhead upload FPS - Danmaku visibility These settings are stored in the client configuration file and loaded automatically when the game starts.