MediaPlayer - 媒体播放器：在 Minecraft 中播放视频与直播

MediaPlayer 是一款高度可定制的插件，允许你在 Minecraft（支持 1.7 至 1.21 版本）中播放和使用各种媒体，例如带音频的视频、直播流和图片。

为了获得更好的性能，请在 server.properties 中将 network-compression-threshold 设置为 -1 并重启服务器（但这可能会影响网络连接不佳的玩家）。你可以播放任何分辨率、任何帧率的视频，唯一的限制是玩家的网络连接和服务器带宽（如果想完全不受网络限制，请在本地服务器上使用）。

💡重要须知

• 本插件尚处于早期开发阶段，开发工作已非常耗时。请理解它可能还不完美。如果你遇到任何问题或有建议，欢迎到插件的 GitHub Issues 板块反馈，帮助我们改进。
• 对于非常旧的 Minecraft 版本（如 1.7），将缺少许多功能。

🎮播放视频步骤

准备工作

• 确保视频文件格式兼容。支持的格式包括：mp4, mov, m4v, avi, webm, gif, m3u8, ts, wmv。
• 浏览到你的服务器插件文件夹，进入 MediaPlayer 插件目录，将视频文件拖入 videos 文件夹。

在游戏中操作

• 在游戏中，使用 /videos reload 重新加载视频列表。
• 使用 /videos 打开视频菜单，你的视频会出现在列表中。点击它，然后选择“加载”。

- 加载时间取决于服务器硬件，过程中和完成后你都会收到通知。

- 若不想等待加载，可输入 `/video <video-name> set real-time-rendering true`。

• 加载完成后，再次进入 /videos 菜单，点击你的视频并选择“播放”。
• 播放视频需要一个特定尺寸的屏幕（将鼠标悬停在 /videos 菜单中的视频上可查看所需尺寸）。如果没有屏幕，插件会提示在你面对的方向创建一个，只需点击聊天栏中的消息即可。
• 准备好屏幕后，右键点击屏幕的左上角（屏幕显示应变为视频缩略图）。
• 接受随后弹出的材质包请求。
• 输入 /video start 开始播放。
• 要停止播放，请输入 /video stop。

关于 Docker 服务器

如果你的服务器运行在 Docker 上，在开始前需要：

• 在 alternative-server 配置字段中添加：公网服务器 IP 和一个用于下载音频数据包的独立端口，格式如 192.184.1.5:25565。
• 向公网开放该端口（涉及 ufw、路由器设置等）。

🎮播放 Twitch 直播步骤

• 像正常观看一样，打开直播页面。
• 打开浏览器开发者工具（Google Chrome：Ctrl + Shift + I），切换到“网络”（Network）标签页。
• 在“网络”标签页中，你会看到一系列链接。找到一个 m3u8 链接并复制其 URL。

- 此步骤高度依赖浏览器引擎，教程以 Google Chrome 为例。

• 在服务器控制台中输入：/video live 复制的URL，视频应在几秒内开始加载。
• 加载后，直播流的 UUID 会出现在聊天栏。现在你可以像播放普通视频一样，通过 /videos 菜单播放它，无需额外加载。

直播注意事项

• 直播流不会被预加载，因此高分辨率直播可能难以处理。建议在操作前先调低直播分辨率。
• 目前不支持直播流的音频。
• 目前仅支持基于 m3u8 的直播流（这意味着不支持 YouTube 直播）。

🎮显示图片步骤

• 确保你的图片文件扩展名为 .png 或 .jpeg。
• 如果图片不是来自网络链接，请将其拖入插件文件夹内的 images 文件夹。
• 如果图片来自网络链接，在聊天栏输入 /image render url；如果已拖入文件夹，则输入 /image render 文件名。你将收到一个地图物品。
• 显示图片需要一个屏幕。你可以使用现有屏幕，或通过点击聊天栏中的消息来创建一个。
• 手持地图物品，右键点击屏幕的左上角，即可看到图片。

✨主要功能与命令

插件功能丰富（有超过 35 个命令，且每个文件都是配置文件），以下仅介绍重要部分。

常用命令

• 浏览插件命令：/video, /screen, /image
• 下载在线视频：/video download <url>
• 打开交互式视频菜单：/videos
• 打开屏幕管理菜单：/screens
• 取消所有插件任务：/videos cancel-tasks
• 其他命令大多可顾名思义。

视频设置命令

• 禁用视频预加载（适合服务器硬件较好时）：/video <video-name> set real-time-rendering true
• 更改视频帧率：/video <video-name> set frame-rate <整数>
• 播放时禁用动作栏信息显示：/video <video-name> set show-informations <true|false>
• 启用视频循环播放：/video <video-name> set looping <true|false>
• 启用视频在服务器启动时自动运行：/video <video-name> set run-on-startup <true|false>

配置项

• 在插件配置文件中，修改 plugin.maximum-distance-to-receive（单位：方块）可调整从屏幕接收视频画面的最大距离。

🔧API 与声明

本插件内置了完整的 API 并提供了文档。这意味着，如果你想在 Minecraft 内实现一个功能完整的 JavaFX 网页浏览器，甚至是在 Minecraft 里玩 Minecraft，都是可能的。我将很快制作一个使用 MediaPlayer API 开发插件的教程。

免责声明：你同意本软件完全由你自行承担使用风险，并遵守 Minecraft EULA 及你的服务器托管平台的使用条款。