VideoPlayer --- 可以在服务器内播放你想要的的视频！ 1.0.0

[MD] ### ⚠️ 注意事项 - 视频分辨率过高可能会导致服务器卡顿。 - 确保已安装 FFmpeg 依赖 并且添加到系统Path内。 *** **[!] 插件简介** VideoPlayer 是一款专为基岩版服务器设计的创新性插件，它允许您在游戏世界中直接播放视频文件。通过将视频实时转码为动态的字符画，它为玩家带来了前所未有的沉浸式视觉体验。无论是播放服务器宣传片、背景动画，还是仅仅为了娱乐，VideoPlayer 都能以其独特的魅力吸引每一位玩家的目光。 **[!] 功能特性** * **实时视频转码**：将标准的 MP4 视频文件实时转换为由字符组成的动态画面。 * **性能优化**： * **可调分辨率与帧率**：通过配置文件轻松调整输出画面的分辨率和帧率，在视觉效果和服务器性能之间找到最佳平衡。 * **智能增量更新**：只在画面内容发生变化时才重新渲染，极大地减少了不必要的计算和网络开销。 * **多线程处理**：利用 Worker Threads 并行处理视频帧，避免阻塞服务器主线程，确保游戏体验流畅。 * **视觉效果增强**： * **伽马校正与亮度提升**：内置的图像处理算法可以增强画面的色彩和亮度，使字符画更加生动、清晰。 * **动态色彩**：字符的颜色会根据视频画面的平均色调动态变化，营造出更加丰富的视觉层次感。 * **易于使用**： * **简单的指令**：通过 `/playvideo` 和 `/stopvideo` 两个简单的指令即可完全控制视频的播放与停止。 * **即插即用**：无需复杂的配置，只需将插件和视频文件放置在指定位置即可开始使用。 **[!] 如何安装** 1. **前置要求**：确保您的服务器已安装 `LeviLamina` 和 `LegacyScriptEngine (Node.js)` 以及依赖。 2. **下载插件**：下载 `VideoPlayer.zip` 文件。 3. **解压文件**：将压缩包解压到服务器的 `plugins` 目录下。您应该会得到一个 `VideoPlayer` 文件夹，其中包含 `manifest.json` 和 `VideoPlayer.js`。 4. **放置视频**：将您希望播放的视频文件（必须命名为 `video.mp4`）放置在 `plugins/VideoPlayer/` 文件夹内，与 `VideoPlayer.js` 文件处于同一目录。 5. **重启服务器**：重启您的服务器以加载插件。 **[!] 指令一览** | 指令 | 描述 | 权限 | | :--- | :--- | :--- | | `/playvideo` | 在玩家面前开始播放视频。 | 任何玩家 | | `/stopvideo` | 停止当前正在播放的视频。 | 任何玩家 | **[!] 配置文件 (config.js)** 您可以通过修改 `VideoPlayer.js` 文件顶部的 `CONFIG` 对象来调整插件的行为。以下是各项配置的详细说明： | 配置项 | 类型 | 默认值 | 描述 | | :--- | :--- | :--- | :--- | | `videoPath` | 字符串 | `path.join(__dirname, "video.mp4")` | 视频文件的路径。默认指向插件目录下的 `video.mp4`。 | | `width` | 数字 | `202` | 字符画的宽度（字符数）。 | | `height` | 数字 | `113` | 字符画的高度（字符数）。 | | `fps` | 数字 | `60` | 视频播放的目标帧率。 | | `scale` | 数字 | `0.1` | 字符画在游戏中的显示大小。 | | `workerCount` | 数字 | `Math.min(os.cpus().length, 24)` | 用于处理视频帧的线程数量。默认为 CPU 核心数和 24 之间的较小值。 | | `bufferFrames` | 数字 | `60` | 预加载到内存中的视频帧数，用于缓冲。 | | `gamma` | 数字 | `1.55` | 伽马校正值，用于调整画面亮度。 | | `brightness` | 数字 | `1.1` | 整体亮度增益。 | **[!] 常见问题 (FAQ)** * **Q: 为什么我看不到视频？** * **A:** 请检查：1. `video.mp4` 文件是否已放置在正确的 `plugins/VideoPlayer/` 目录下。 2. 您的服务器是否已正确安装并启用了 `LiteLoaderBDS` 和 `LegacyScriptEngine`。 3. 检查服务器控制台是否有任何与 `ffmpeg` 或 `ffplay` 相关的错误信息。 * **Q: 播放视频时服务器很卡怎么办？** * **A:** 尝试在 `VideoPlayer.js` 的 `CONFIG` 中降低 `width`、`height` 和 `fps` 的值，以减少服务器的计算压力。 * **Q: 我可以播放其他格式的视频吗？** * **A:** 插件目前硬编码为播放 `video.mp4`。如果您需要播放其他格式，需要修改 `VideoPlayer.js` 文件中的 `videoPath` 和 `ffmpeg` 相关命令。 *** > **喜欢这个插件吗？给个好评吧！** [/MD]
如果您在使用中遇到任何问题，欢迎在下方评论区或通过 QQ群1045392458 反馈。

演示视频：