MediaPlayer

[HEADING=2]📺 视频播放插件完整教程[/HEADING]
[QUOTE]
基于 Docker 的 Minecraft 服务器专用媒体播放器
[/QUOTE]
[HR][/HR]
[HEADING=2]一、安装与环境准备[/HEADING]
[TABLE]
[TR]
[TH][LEFT]步骤[/LEFT][/TH]

[TH][LEFT]操作[/LEFT][/TH]

[TH][LEFT]说明[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]1️⃣[/LEFT][/TD]

[TD][LEFT][B]性能优化[/B][/LEFT][/TD]

[TD][LEFT]编辑 server.properties，加入：[CODE]network-compression-threshold=-1[/CODE][/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]2️⃣[/LEFT][/TD]

[TD][LEFT][B]前置条件[/B][/LEFT][/TD]

[TD][LEFT]服务器必须运行在 [B]Docker[/B] 容器中[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]3️⃣[/LEFT][/TD]

[TD][LEFT][B]配置文件[/B][/LEFT][/TD]

[TD][LEFT]• 下载中文版配置（云盘链接）[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]4️⃣[/LEFT][/TD]

[TD][LEFT][B]网络放行[/B][/LEFT][/TD]

[TD][LEFT]确保防火墙 + 路由器已开放对应端口[/LEFT][/TD]
[/TR]
[/TABLE]
[HR][/HR]
[HEADING=2]二、快速上手：三步完成首次播放[/HEADING]
[QUOTE]
推荐顺序：[B]创建屏幕 → 加载视频 → 开始播放[/B]

[TABLE]
[TR]
[TH][LEFT]步骤[/LEFT][/TH]

[TH][LEFT]指令[/LEFT][/TH]

[TH][LEFT]说明[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]① 创建屏幕[/LEFT][/TD]

[TD][LEFT]/screen create <名称>[/LEFT][/TD]

[TD][LEFT]生成一块可渲染视频的屏幕[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]② 准备视频[/LEFT][/TD]

[TD][LEFT]/video download <URL> 或 把本地文件放入 plugins/MediaPlayer/videos/[/LEFT][/TD]

[TD][LEFT]获取或上传视频[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]③ 加载 & 播放[/LEFT][/TD]

[TD][LEFT]见下方「详细指令」[/LEFT][/TD]

[TD][/TD]
[/TR]
[/TABLE]
[/QUOTE]
[HR][/HR]
[HEADING=2]三、指令手册（按使用场景分类）[/HEADING]
[HEADING=3]1. 屏幕管理[/HEADING]
[HEADING=3][/HEADING]
[HEADING=3][TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]

[TH][LEFT]别名[/LEFT][/TH]

[TH][LEFT]作用[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/screen create <name>[/LEFT][/TD]

[TD][LEFT]—[/LEFT][/TD]

[TD][LEFT]新建一块屏幕[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/screen delete <name>[/LEFT][/TD]

[TD][LEFT]—[/LEFT][/TD]

[TD][LEFT]删除屏幕[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/screen tp <name>[/LEFT][/TD]

[TD][LEFT]—[/LEFT][/TD]

[TD][LEFT]将自己传送到屏幕前[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/screens[/LEFT][/TD]

[TD][LEFT]—[/LEFT][/TD]

[TD][LEFT]列出所有已保存屏幕[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]
[HEADING=3]2. 视频管理[/HEADING]
[HEADING=3][/HEADING]
[HEADING=3][TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]

[TH][LEFT]别名[/LEFT][/TH]

[TH][LEFT]作用[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/video list[/LEFT][/TD]

[TD][LEFT]/vid list[/LEFT][/TD]

[TD][LEFT]显示本地视频列表[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video download <url>[/LEFT][/TD]

[TD][LEFT]/vid download[/LEFT][/TD]

[TD][LEFT]在线下载视频[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video delete <file>[/LEFT][/TD]

[TD][LEFT]/vid delete[/LEFT][/TD]

[TD][LEFT]永久删除服务器内视频[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/videos reload[/LEFT][/TD]

[TD][LEFT]/vids reload[/LEFT][/TD]

[TD][LEFT]重新扫描视频目录[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/videos cancel-tasks[/LEFT][/TD]

[TD][LEFT]/vids cancel-tasks[/LEFT][/TD]

[TD][LEFT]取消所有下载/转码任务[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]
[HEADING=3]3. 播放控制[/HEADING]
[HEADING=3][/HEADING]
[HEADING=3][TABLE]
[TR]
[TH][LEFT]指令[/LEFT][/TH]

[TH][LEFT]别名[/LEFT][/TH]

[TH][LEFT]作用[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]/video load <file>[/LEFT][/TD]

[TD][LEFT]/vid load[/LEFT][/TD]

[TD][LEFT]把视频加载到内存[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video play <file>[/LEFT][/TD]

[TD][LEFT]/vid play[/LEFT][/TD]

[TD][LEFT]直接加载并播放[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video stop [file][/LEFT][/TD]

[TD][LEFT]/vid stop[/LEFT][/TD]

[TD][LEFT]停止播放[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video pause [file][/LEFT][/TD]

[TD][LEFT]/vid pause[/LEFT][/TD]

[TD][LEFT]暂停[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video resume [file][/LEFT][/TD]

[TD][LEFT]/vid resume[/LEFT][/TD]

[TD][LEFT]继续播放[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]/video info <file>[/LEFT][/TD]

[TD][LEFT]/vid info[/LEFT][/TD]

[TD][LEFT]查看时长、分辨率等[/LEFT][/TD]
[/TR]
[/TABLE][/HEADING]
[HEADING=3]4. 属性调节[/HEADING]
[CODE]/video <file> set <属性> <值>[/CODE]
[TABLE]
[TR]
[TH][LEFT]属性[/LEFT][/TH]

[TH][LEFT]取值[/LEFT][/TH]

[TH][LEFT]示例[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]volume[/LEFT][/TD]

[TD][LEFT]0.0 ~ 1.0[/LEFT][/TD]

[TD][LEFT]/video demo.mp4 set volume 0.5[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]speed[/LEFT][/TD]

[TD][LEFT]0.1 ~ 4.0[/LEFT][/TD]

[TD][LEFT]/video demo.mp4 set speed 1.25[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]looping[/LEFT][/TD]

[TD][LEFT]true / false[/LEFT][/TD]

[TD][LEFT]/video demo.mp4 set looping true[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]frame-rate[/LEFT][/TD]

[TD][LEFT]整数[/LEFT][/TD]

[TD][LEFT]/video demo.mp4 set frame-rate 24[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]real-time-rendering[/LEFT][/TD]

[TD][LEFT]true / false[/LEFT][/TD]

[TD][LEFT]/video demo.mp4 set real-time-rendering false[/LEFT][/TD]
[/TR]
[/TABLE]
[HR][/HR]
[HEADING=2]四、常见场景示例[/HEADING]
[HEADING=3]✅ 播放本地视频[/HEADING]
[LIST=1]
[*]将 demo.mp4 放入 plugins/MediaPlayer/videos/
[*]/videos reload
[*]/screen create cinema
[*]/video load demo.mp4
[*]右键屏幕左上角 → 选择 demo.mp4 → Play
[/LIST]
[HEADING=3]✅ 播放 Twitch 直播[/HEADING]
[LIST=1]
[*]浏览器 F12 → Network → 复制 .m3u8 直播流地址
[*]/video live <m3u8 链接>
[*]/screen create twitch
[*]右键屏幕 → 选择直播 → Play
[/LIST]
[QUOTE]
⚠️ 不支持音频；建议降低分辨率减少卡顿
[/QUOTE]
[HEADING=3]✅ 显示图片[/HEADING]
表格
复制
[TABLE]
[TR]
[TH][LEFT]来源[/LEFT][/TH]

[TH][LEFT]指令[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT]在线[/LEFT][/TD]

[TD][LEFT]/image render <图片URL>[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]本地[/LEFT][/TD]

[TD][LEFT]把 .png/.jpeg 放入 images/ → /image render <文件名>[/LEFT][/TD]
[/TR]
[/TABLE]
[HR][/HR]
[HEADING=2]五、配置文件速查[/HEADING]
[CODE]# plugins/MediaPlayer/config.yml
auto-update: true # 自动更新插件
packet-compression: true # 数据包压缩
maximum-distance-to-receive: 64 # 方块内可见
delete-video-on-loaded: false # 加载后是否删除源文件[/CODE]


[HR][/HR]
[HEADING=2]六、故障排查[/HEADING]
表格
复制
[TABLE]
[TR]
[TH][LEFT]问题[/LEFT][/TH]

[TH][LEFT]解决方案[/LEFT][/TH]
[/TR]
[TR]
[TD][LEFT][B]视频卡顿[/B][/LEFT][/TD]

[TD][LEFT]• 降帧率：/video <file> set frame-rate 24[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT][B]下载卡住[/B][/LEFT][/TD]

[TD][LEFT]/videos cancel-tasks 后重试[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT][B]无法连接[/B][/LEFT][/TD]

[TD][LEFT]确认防火墙、端口映射、公网 IP 设置无误[/LEFT][/TD]
[/TR]
[/TABLE]
[HR][/HR]
[QUOTE]
📌 [B]法律声明[/B]
使用本插件须遵守 Minecraft EULA 及服务器托管条款。本地服务器（localhost）可完全规避网络限制。
[/QUOTE]