McediaTVPlugin 是 Mcedia TV 的配套服务端插件。 它提供 McediaTV 所需的服务端频道同步系统、播放器管理流程以及游戏内控制界面。

McediaTVPlugin 不会将播放状态分别保存在每一个播放器实体上，而是将播放状态统一组织到 频道（channel） 中。 插件负责维护每个频道的媒体地址、播放状态、播放进度、播放速度和同步运行态，并向已订阅频道的客户端发布频道快照与同步更新。

这意味着同一个频道下的多个客户端可以围绕同一条播放时间线运行，而多个播放器也可以围绕同一个共享频道进行展示，而不是各自维护完全独立的播放状态。

核心功能

基于频道的同步播放

• 以 channel 为核心组织播放状态
• 在服务端维护频道的权威运行态
• 向已订阅客户端发布频道快照与同步更新
• 让同一频道下的多个客户端共享同一播放状态基准

多客户端共享同一频道

• 一个频道可以同时被多个客户端观看
• 当频道状态发生变化时，已订阅客户端会收到新的同步数据
• 客户端在重连、恢复观看或重新建立订阅后，可以重新对齐到当前频道状态

播放器管理

• 支持创建和管理 MTV 播放器
• 播放器可以与频道关联，用于共享展示内容
• 多个播放器可以围绕同一个频道工作
• 频道内容与播放器实体分离管理，便于统一控制播放状态

播放控制与播放列表

• 支持媒体地址切换
• 支持播放、暂停、继续和同步控制
• 支持播放列表
• 支持多种播放顺序模式，包括顺序播放、随机播放和循环播放

基于 GUI 的操作流程

• 提供 /mtv 入口
• 主要操作通过游戏内 GUI 完成
• 可在游戏内管理播放器、频道以及相关展示设置

铁门遥控器

• 可将铁门重命名为 遥控器 并作为快捷控制道具使用
• 手持该物品时，可快速操作最近的 MTV 播放器
• 适合在不打开完整 GUI 的情况下进行就近控制
• 用于简化日常操作与现场控制流程

公共频道

• 支持公共频道的创建、搜索和管理
• 可在服务器内将频道内容作为共享内容使用
• 不同玩家可根据服务端权限配置拥有不同的管理与控制能力

McediaTV 的必要组成部分

McediaTVPlugin 是 McediaTV 的必要组成部分。 如果没有这个服务端插件，McediaTV 就无法使用。

这是因为频道同步系统和控制 GUI 都依赖服务端维护频道状态并向客户端发布同步数据。

插件主要负责：

• 维护频道状态
• 管理频道订阅、取消订阅与心跳保活
• 向客户端发送频道快照、同步更新与移除通知
• 管理公共频道
• 在有观众时持续发布同步数据
• 为播放器展示系统提供统一控制入口

依赖

McediaTV

本插件需要与 McediaTV 客户端模组配合使用。

McediaCore

本插件依赖 McediaCore。 McediaCore 提供 McediaTV 体系所需的底层媒体播放相关能力。

独立媒体解析 Mod

对于非直链媒体或平台链接的解析能力，本插件依赖 独立的解析 Mod。 McediaTVPlugin 本身不负责实现所有媒体来源的解析逻辑。

安装和使用前，请确认以下组件已经正确准备：

• McediaTV
• McediaCore
• McediaTVPlugin
• 对应的独立媒体解析 Mod

如果缺少上述必要组件，系统将无法完整工作，或无法正确解析和播放媒体内容。

注意事项

当前版本的频道数据持久化仅支持基于文件系统的实现。 频道状态会以文件形式保存和加载。 现阶段不包含数据库或其他持久化后端实现。

FAQ

Q: 可以不安装 McediaTV，只安装这个插件吗？

不可以。 McediaTVPlugin 是 McediaTV 的配套服务端插件，需要与客户端模组一起使用。

Q: 可以不安装这个插件，只使用 McediaTV 吗？

不可以。 如果没有 McediaTVPlugin，McediaTV 将无法按预期方式使用。

Q: 这个插件会通过服务器中转完整媒体流吗？

不会。 本插件主要负责维护频道状态、处理订阅关系并发送同步数据，不作为完整媒体内容分发服务器使用。

实际播放时的网络行为仍取决于媒体来源、客户端环境以及解析 Mod 的实现方式。

Q: 这个插件自己负责解析媒体地址吗？

不负责。 对于非直链媒体或平台链接的解析能力，依赖独立的解析 Mod。

Q: 能直接播放 YouTube、Bilibili 之类的平台链接吗？

这取决于你安装的解析 Mod。 只有当对应解析 Mod 支持该平台或该类链接时，这些链接才可能被正确解析并播放。

Q: 如何管理播放器和频道？

通过插件提供的 /mtv 入口和游戏内 GUI 进行管理。 此外，也可以将铁门重命名为 遥控器，作为快捷控制道具，用于快速操作最近的播放器。

Q: 多个播放器可以使用同一个频道吗？

可以。 播放器可以与频道关联，多个播放器可以围绕同一个共享频道展示相同内容。

Q: 是否支持公共频道？

支持。 插件包含公共频道的创建、搜索和管理能力。实际可见范围和控制权限取决于服务端权限配置。

---

McediaTVPlugin is the companion server plugin for Mcedia TV. It provides the server-side channel synchronization system, player management workflow, and in-game control interface required by McediaTV.

Instead of storing playback state independently on every individual display player, McediaTVPlugin organizes playback state around channels. The plugin maintains each channel's media URL, playback status, playback position, playback speed, and synchronization runtime state, then publishes channel snapshots and sync updates to subscribed clients.

As a result, multiple clients on the same channel can stay aligned to the same playback timeline, while multiple display players can also present content from the same shared channel instead of maintaining completely separate playback states.

Core Features

Channel-based synchronized playback

• Organizes playback state around channels
• Maintains authoritative channel runtime state on the server
• Publishes channel snapshots and synchronization updates to subscribed clients
• Allows multiple clients on the same channel to share the same playback state baseline

Shared playback across multiple clients

• A single channel can be viewed by multiple clients at the same time
• When channel state changes, subscribed clients receive updated synchronization data
• Clients can realign to the current channel state after reconnecting, resuming viewing, or re-establishing subscriptions

Display player management

• Supports creating and managing MTV display players
• Display players can be linked to channels for shared playback
• Multiple display players can work around the same channel
• Channel content and player entities are managed separately for centralized playback control

Playback control and playlists

• Supports switching media URLs
• Supports play, pause, resume, and synchronization control
• Supports playlists
• Supports multiple playback order modes, including sequential, shuffle, and loop playback

GUI-based workflow

• Provides the /mtv entry point
• Main operations are handled through in-game GUI interfaces
• Players, channels, and related display settings can be managed in-game

Iron Door Remote Control

• An iron door item can be renamed to 遥控器 and used as a quick control tool
• While holding it, players can quickly control the nearest MTV display player
• Useful for nearby control without opening the full GUI
• Designed to simplify day-to-day operation and on-site control

Public channels

• Supports creating, searching, and managing public channels
• Public channels can be used as shared channel content inside a server
• Management and control permissions depend on the server's permission configuration

Required for McediaTV

McediaTVPlugin is required for McediaTV. Without the server plugin, McediaTV cannot be used.

This is because both the synchronization system and the control GUI depend on the server maintaining channel state and publishing synchronization data to clients.

The plugin is responsible for:

• Maintaining channel state
• Managing channel subscribe, unsubscribe, and heartbeat keepalive
• Sending channel snapshots, sync updates, and removal notifications to clients
• Managing public channels
• Continuously publishing synchronization data while viewers are present
• Providing a unified control entry point for the display player system

Dependencies

McediaTV

This plugin is intended to work together with the McediaTV client mod.

McediaCore

This plugin depends on McediaCore, which provides the underlying media playback-related capabilities required by the McediaTV ecosystem.

Independent media resolver mod

Resolution for non-direct media URLs or platform links depends on an independent resolver mod. McediaTVPlugin itself does not implement parsing logic for all media sources.

Before installation and use, make sure the following components are prepared correctly:

• McediaTV
• McediaCore
• McediaTVPlugin
• The corresponding independent media resolver mod

If any of these required components are missing, the system will not work completely, or media may fail to resolve and play correctly.

Warning

Channel data persistence in the current version is file-system-based only. Channel state is saved to and loaded from files. Database-backed or other persistence backends are not included at this stage.

FAQ

Q: Can I use this without McediaTV?

No. McediaTVPlugin is the companion server plugin for McediaTV and is intended to work together with the client mod.

Q: Can I use McediaTV without this plugin?

No. Without McediaTVPlugin, McediaTV cannot be used as intended.

Q: Does this plugin relay full media streams through the server?

No. The plugin mainly maintains channel state, handles subscriptions, and sends synchronization data. It is not intended to act as a full media distribution server.

Actual network behavior still depends on the media source, client environment, and resolver mod implementation.

Q: Does this plugin itself resolve media URLs?

No. Media URL resolution for non-direct links or platform links depends on an independent resolver mod.

Q: Can it directly play YouTube, Bilibili, or similar platform links?

That depends on the resolver mod you install. Those links can only be resolved and played if the corresponding resolver mod supports that platform or link type.

Q: How do I manage players and channels?

Management is done through the /mtv entry point and the in-game GUI workflow provided by the plugin. An iron door item can also be renamed to 遥控器 and used as a quick control tool for the nearest player.

Q: Can multiple display players use the same channel?

Yes. Players can be linked to channels, and multiple players can present the same content through one shared channel.

Q: Does it support public channels?

Yes. The plugin includes public channel creation, search, and management capabilities. Visibility and control permissions depend on the server's permission configuration.

Summary

McediaTVPlugin is the server-side foundation of the McediaTV channel synchronization system. It maintains channel runtime state, coordinates synchronized playback across clients, provides player and channel management, and offers both GUI-based control and the iron-door remote workflow for operating display players in Minecraft.

如果你要，我还可以继续给你两版：

1. 更短的 Modrinth 风格英文 Description
2. 对应的中文版插件 Description

✻ Worked for 38s

❯ 给我中文版

当然，下面是 McediaTVPlugin 的中文版描述，适合直接放到 Modrinth：

McediaTVPlugin 是什么？

No. Without McediaTVPlugin, McediaTV cannot be used as intended.

Q: Does this plugin relay full media streams through the server?

No. The plugin mainly maintains channel state, handles subscriptions, and sends synchronization data. It is not intended to act as a full media distribution server.

Actual network behavior still depends on the media source, client environment, and resolver mod implementation.

Q: Does this plugin itself resolve media URLs?

No. Media URL resolution for non-direct links or platform links depends on an independent resolver mod.

Q: Can it directly play YouTube, Bilibili, or similar platform links?

That depends on the resolver mod you install. Those links can only be resolved and played if the corresponding resolver mod supports that platform or link type.

Q: How do I manage players and channels?

Management is done through the /mtv entry point and the in-game GUI workflow provided by the plugin. An iron door item can also be renamed to 遥控器 and used as a quick control tool for the nearest player.

Q: Can multiple display players use the same channel?

Yes. Players can be linked to channels, and multiple players can present the same content through one shared channel.

Q: Does it support public channels?

Yes. The plugin includes public channel creation, search, and management capabilities. Visibility and control permissions depend on the server's permission configuration.