BlockLyrics — 将游戏画面变成音乐剪辑

你一定见过那些歌词随音乐在屏幕上移动的 TikTok 视频。以前，要制作这种效果，得先录好素材，再进行后期剪辑。

BlockLyrics 让你在游玩 Minecraft 时就能实现这种效果。

在浏览器中用 Spotify 播放歌曲，进入你的世界，让歌词融入游戏画面。不需要视频编辑器，不用手动放置文字，也不必为每首歌提前做准备。

效果是什么样的？

BlockLyrics 会在屏幕中央附近显示动画歌词，灵感来自音乐剪辑。

每行歌词会分成两部分：前半部分显示在左侧，后半部分显示在右侧。歌词播放时，文字会逐渐显现，同时伴有颜色变化、轻柔的移动和随机位置变化。

最终呈现的是动态歌词叠层，能自然融入游戏画面，无论你是在探索、建造，还是录制片段都很合适。

视觉效果

逐词显示，而不是一次性显示整行歌词。
双部分布局，前半部分在左侧，后半部分在右侧。
每行歌词的位置、角度和大小随机变化。
采用流畅醒目的字体，并支持西里尔字母。
轻柔摆动与颜色过渡。
文字简洁清晰，不带背景框或投影。
歌词行结束时会渐隐动画。
根据移动效果处理消失中的文字：移动时，渐隐的文字碎片会短暂停留在摄像机前方的虚拟位置，营造出从文字间穿过的感觉。

歌词通过客户端 HUD 显示，不会附着在方块上。

工作原理

BlockLyrics 会读取浏览器提供的 Windows 媒体会话中的当前歌曲和播放进度。

随后，它会在YouTube Music中搜索匹配的歌曲，并获取可用的带时间戳歌词。歌词会根据你正在 Spotify 上收听的音乐播放进度同步显示。

你不需要在 YouTube 上播放歌曲。

无需在模组中单独登录账号，无需配置 API 密钥，也无需安装浏览器扩展。不需要 Python，也不需要单独的服务器。

快速开始

在Google Chrome 或 Microsoft Edge中打开 Spotify。
开始播放歌曲。
启动已安装 BlockLyrics 的 Minecraft。
进入一个世界。
等待歌词加载。

你可以随时使用以下命令查看检测到的歌曲和加载状态：

/blocklyrics

运行要求

此版本适用于：

Minecraft 26.2
Fabric Loader 0.19.5 或更高版本
Fabric API
Java 25
Windows
能够访问YouTube Music的互联网连接

BlockLyrics 是一个客户端模组，无需安装在服务器上。

浏览器是否受支持，取决于它是否会向 Windows 提供歌曲标题、艺人和播放进度。建议先使用 Chrome 或 Edge。

如果 Yandex Music 的浏览器播放器能提供所需的媒体信息，也可能可以使用。

安装

为 Minecraft 26.2安装 Fabric。
安装对应版本的Fabric API。
将 BlockLyrics 的 .jar 文件放入 Minecraft 实例的 mods 文件夹。
更新前请移除旧版 BlockLyrics .jar 文件。
启动游戏，并在浏览器中播放音乐。

命令

命令	作用
`/blocklyrics`	显示当前歌曲和歌词加载状态。
`/blocklyrics show`	启用歌词渲染。
`/blocklyrics toggle`	开启或关闭歌词渲染。
`/blocklyrics retry`	清除歌词缓存并重新搜索。
`/blocklyrics debug`	显示播放时间和渲染诊断信息。
`/blocklyrics demo on`	开始 20 秒的视觉演示。
`/blocklyrics demo off`	结束演示。
`/blocklyrics offset <seconds>`	将歌词时间调整 −30 至 +30 秒。
`/blocklyrics font smooth`	使用内置的平滑字体。
`/blocklyrics font vanilla`	使用 Minecraft 默认字体。

调整同步

如果歌词总是显示得太晚，可以尝试：

/blocklyrics offset 1

如果歌词总是显示得太早，可以尝试：

/blocklyrics offset -1

正值会让歌词提前显示。负值会让歌词延后显示。

歌词与时间

歌词取决于 YouTube Music 上的可用内容。并非每首歌曲都有同步歌词，即使其他地方有纯文本歌词也一样。

BlockLyrics 会根据标题和艺人来选择录音版本。曲目时长会影响匹配结果的排序，但时长不同不会阻止歌词加载。

不同录音版本的歌词时间也可能不同。现场版、混音版、缩短版以及带有额外前奏的曲目可能需要调整偏移量，也可能无法在整首歌中保持同步。

每行歌词的时间来自歌词源。每行中单个词语的显示时间为估算值。这是一种视觉动画，并非精确的逐词音频识别。

故障排除

检测到了歌曲，但没有显示歌词

查看/blocklyrics以确认加载状态，然后使用：

/blocklyrics retry

请确认已通过以下命令启用渲染：

/blocklyrics show

模组检测不到我的歌曲

请确认浏览器正在播放音乐。尝试使用 Chrome 或 Edge，并暂停其他可能正在争用 Windows 媒体会话的音乐播放器。

我遇到了网络错误

模组需要通过 Windows 或 Java 访问music.youtube.com。如果 VPN 仅在浏览器中生效，Minecraft 可能无法通过它连接网络。

我想在没有音乐的情况下测试视觉效果

使用：

/blocklyrics demo on

演示会在 20 秒后自动结束。

隐私

BlockLyrics 通过 Windows 媒体会话读取歌曲元数据和播放时间。

它不会读取你的浏览历史、密码或账户 Cookie。歌曲元数据会发送至 YouTube Music，以查找匹配的歌词。模组不会下载或上传歌曲音频。

鸣谢

Manrope ExtraBold字体依据 SIL 开源字体许可证提供。
YouTube Music 集成功能的开发参考了ytmusicapi 项目。

BlockLyrics 是一个独立项目，与 Mojang、Microsoft、Spotify 或 YouTube 均无关联。

播放音乐，进入你的世界，让歌词伴你同行。

Spotify Edit (blocklirycs)

介绍