MediaPlayer

📺 视频播放插件完整教程

[QUOTE]
基于 Docker 的 Minecraft 服务器专用媒体播放器
[/QUOTE]
[HR][/HR]

一、安装与环境准备

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

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

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

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

[TD][LEFT]编辑 server.properties，加入：[/LEFT][/TD]
[/TR]
[TR]
[TD][LEFT]2️⃣[/LEFT][/TD]

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

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

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

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

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

[TD][LEFT]确保防火墙 + 路由器已开放对应端口[/LEFT][/TD]
[/TR]
[/TABLE]
[HR][/HR]

二、快速上手：三步完成首次播放

[QUOTE]
推荐顺序：创建屏幕 → 加载视频 → 开始播放

[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]

三、指令手册（按使用场景分类）

1. 屏幕管理

[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]

2. 视频管理

[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]

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]

4. 属性调节

[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]

四、常见场景示例

✅ 播放本地视频

• 将 demo.mp4 放入 plugins/MediaPlayer/videos/
• /videos reload
• /screen create cinema
• /video load demo.mp4
• 右键屏幕左上角 → 选择 demo.mp4 → Play

✅ 播放 Twitch 直播

• 浏览器 F12 → Network → 复制 .m3u8 直播流地址
• /video live <m3u8 链接>
• /screen create twitch
• 右键屏幕 → 选择直播 → Play

[QUOTE]
⚠️ 不支持音频；建议降低分辨率减少卡顿
[/QUOTE]

✅ 显示图片

表格
复制
[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]

五、配置文件速查

[HR][/HR]

六、故障排查

表格
复制
[TABLE]
[TR]
[TH][LEFT]问题[/LEFT][/TH]

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

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

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

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