HyCast Studio

HyCast Studio

操作者直接将YouTube视频和网络摄像头画面广播到玩家的游戏内HUD中。

杂项

HyCast Studio — Hytale 内的 YouTube 与网络摄像头直播

操作员可将 YouTube 视频和网络摄像头画面直接广播到玩家游戏内的 HUD 中。
无需浏览器,无需切换窗口。纯粹的 Hytale 体验,但带视频。

⚠ 需要外部软件 — 此插件无法开箱即用。使用前必须在服务器机器上安装 yt-dlpffmpeg。请参阅下方的 系统要求(仅限服务器主机)


这是什么?

HyCast Studio 是一个服务器插件,可将真实视频逐帧渲染到原生 Hytale HUD 覆盖层中。操作员控制所有视频播放,并将 YouTube 视频、YouTube Shorts 或网络摄像头画面广播给服务器上的所有玩家。

玩家可以接入正在进行的广播,或关闭自己的 HUD — 仅此而已。

这是一个技术案例研究,并非精心打磨的生产级模组。 视频播放无音频 — 仅缺少音频这一点就使其在实际应用中不实用。它展示了 Hytale UI 系统可能实现的能力,而非可用于真实服务器的成品。


功能

  • 操作员控制的广播 — 操作员启动并管理所有视频播放;玩家观看
  • 网络摄像头直播 — 在游戏中显示网络摄像头画面
  • 服务器广播 — 操作员同时向所有玩家进行直播
  • 广播规划器 — 操作员可使用 YouTube 片段、网络摄像头和静态噪声构建多场景播放列表;通过 GUI 在游戏内重新排序、保存和加载;在上线前可自行预览
  • 视频缓存 — 视频预下载到磁盘,以便快速启动播放并跳过重复下载同一片段
  • YouTube Shorts — 竖屏模式画布自动调整为 9:16 内容
  • 滚动文本 — 广播一条跑马灯消息,滚动显示在每个玩家的 HUD 上
  • 序列播放 — 连续播放多个场景,最后一个场景结束时 HUD 干净关闭
  • Linux + Windows — 两者均支持;Flatpak 用户可获得自动主机委派

系统要求(仅限服务器主机)

在运行 Hytale 服务器的机器上安装 yt-dlpffmpeg

Linux

# Ubuntu / Debian
sudo apt install ffmpeg yt-dlp

两个二进制文件必须位于 /usr/bin/yt-dlp/usr/bin/ffmpeg

通过 Flatpak 运行 Hytale?授予主机和网络摄像头访问权限一次:

flatpak override --user com.hypixel.HytaleLauncher --talk-name=org.freedesktop.Flatpak
flatpak override --user com.hypixel.HytaleLauncher --device=all

Windows

yt-dlp.exeffmpeg.exe 添加到系统 PATH 环境变量中。


命令

所有命令均使用 /hycast 或别名 /hcs

玩家命令

命令 描述
/hycast join 接入正在进行的服务器广播
/hycast stop 关闭你的 HUD

操作员 — 快速入门

从这里开始: /hycast planner 打开广播规划器 GUI。构建场景序列,以名称保存,然后以个人预览或直播广播的形式启动 — 全部无需离开游戏。下面的原始命令用于快速的一次性播放;对于任何有计划的内容,请使用规划器。

命令 描述
/hycast planner 打开广播规划器 GUI

操作员 — 个人预览 (HUD 仅你可见)

在上线前使用这些命令测试源。只有你自己的 HUD 会受影响。

命令 描述
/hycast play <url> 在自己的 HUD 中预览 YouTube 视频
/hycast webcam [index] 在自己的 HUD 中预览网络摄像头画面
/hycast static [seconds] 在自己的 HUD 中显示静态噪声
/hycast text <message> [seconds] 在自己的 HUD 中显示滚动文字跑马灯
/hycast webcams 列出可用的网络摄像头设备

操作员 — 直接广播 (为所有玩家打开 HUD)

注意: 每个 broadcast 命令以及通过规划器以广播模式执行的任何计划,都会立即为服务器上的所有玩家打开视频 HUD(或为那些执行了 /hycast join 的玩家打开)。请先使用个人预览验证你的内容。

命令 描述
/hycast broadcast play <url> 向所有订阅者广播 YouTube 视频
/hycast broadcast webcam [index] 向所有订阅者广播网络摄像头画面
/hycast broadcast static [seconds] 向所有订阅者广播静态噪声
/hycast broadcast text <message> [seconds] 向所有订阅者广播滚动文字跑马灯
/hycast broadcast stop [--close] 停止广播(可选择关闭订阅者的 HUD)
/hycast broadcast next 跳过至序列中的下一个场景
/hycast broadcast joinall 强制所有玩家加入广播

URL 格式

仅接受官方的 YouTube URL:

  • https://www.youtube.com/watch?v=...
  • https://www.youtube.com/shorts/...
  • https://youtu.be/...

备注

  • 无音频 — 视频静音播放。如需语音和环境音,请在直播的同时使用 Hytale 内置的近距离语音聊天
  • 视频以低分辨率、10 FPS 渲染 — 针对游戏内使用优化,非影院级画质
  • 缓存的视频存储在服务器的 /tmp/hycast_*.mp4 中,并在会话间重用
  • 网络摄像头捕获要求服务器机器可访问该摄像头
  • 网络摄像头场景不会自行结束 — 使用 /hycast broadcast next(或规划器的手动推进)移动到序列中的下一个场景;对于 seconds = 0 的静态/文本场景同样适用