介绍
# Mine at Disco
一款适用于 Minecraft Java 26.3 的 Fabric 模组,可以播放你自己的音乐,并让游戏跟着节拍同步。
播放歌曲时:
– 每拍都有四个括号飞入并落在准星周围;第 1 拍前呈金色,下一次完整击打准备就绪时变成红色,臂展也会更长。下方的四个小点会显示当前小节进度。
– 快捷栏和状态栏会随着歌曲中实际出现的鼓点,从左到右依次弹跳;鼓点停下时,它们也会歇下来。
– 移动时,视角会在第 1 拍和第 3 拍稍微变宽,就像速度突然爆发一样。站立不动时效果会停下,并受“视野效果”滑块控制。
– 生物和玩家会像毛绒玩偶一样同步跳舞:每两拍跳一次,在第 1 拍和第 3 拍落地;落地时会压扁一下,整个小节里还会左右摇摆胯部。
– 每个小节开始时,树叶都会飘落。
– 挖掘动作会落在每个八分音符上,方块碎屑也会四散飞溅;节拍上声音更响、效果更大。方块会在下一个八分音符上碎裂成一圈碎屑,第 1 拍和第 3 拍还会迸出彩色火花。裂纹会随着节拍逐渐加深,放置方块后则会在下一个十六分音符扬起灰尘。
– 战斗会跟着歌曲节拍进行:你的攻击会在八分音符上闪光并迸发效果(正好击中节拍时效果更大);近战生物会在弱拍蓄势、强拍攻击,苦力怕则会在节拍上爆炸。格挡攻击会在下一拍发出铿锵声,并伴随与歌曲调性相符的铃声;如果在攻击命中前及时举盾,就能触发带和弦音效的完美弹反。
– 每一拍都会带来速度变化:动画、粒子和裂纹先短暂放慢,再猛然加速进入下一拍,就像速度剪辑一样。碎屑会先悬停在空中,随后再飞出去。
– 你挖的第一个方块会像原版一样快速破坏。按住鼠标连续挖掘时,挖掘连段会锁定节拍并逐渐贴近强拍,因此即使连续挖掘较慢的方块,也能让节奏落在第 1 拍上,同时不会比原版慢太多。在节拍上破坏、放置或击中目标时,准星周围会迸出火花。
– 乐队休息后重新演奏时,你周围会扩散出一道彩虹光环,烟花升空,树木也会飘落树叶。
– 生物受击时会在八分音符上闪光,被击杀时则会在下一拍倒下。
– 进食和喝水会在每个八分音符上咬一口,节拍上动作更重。投掷物和射击会落在八分音符上;雪球、鸡蛋和喷溅药水也会按节奏网格爆开并迸出火花。
– 其他世界音效也会等待歌曲节拍:脚步声和战斗音效落在八分音符上,其余音效则落在下一个十六分音符上。
– 歌曲音量越大,每种效果就越明显;安静段落中则会收敛。额外粒子效果会遵循你的粒子设置。
## 安装
需要 Minecraft Java 26.3、Fabric Loader 0.20.1 或更高版本,以及 Fabric API。将 [发布页面](https://github.com/bitoesposito/mine-at-disco/releases)中的模组 JAR 放入 `mods` 文件夹。
## 使用
进入世界后按 `M`(或运行 `/disco`)打开菜单。游戏不会暂停,屏幕中央也会保持空旷,方便你一边设置一边观察节拍。按 `M` 或 `Esc` 关闭菜单。
左侧是你的曲库。“歌曲”标签页会列出 `System audio`(跟随 Windows 当前播放的声音)和你的歌曲,上方有搜索框。点击歌曲即可播放,点击 `+` 可加入队列,点击火焰弹图标可将歌曲刻录到音乐唱片上。望远镜图标用于搜索 YouTube,箱子图标可打开歌曲文件夹。“播放列表”标签页可以将队列保存为播放列表并播放。
右侧是播放器:显示当前播放内容,并提供可点击或拖动的进度条,让你跳转到歌曲的指定位置;还有播放/暂停、上一首、下一首、循环和停止按钮。下方的“队列”标签页显示接下来要播放的歌曲;“音量”标签页提供 Master、Music、Jukebox 和 Blocks 滑块;“同步”标签页包含节奏设置。
歌曲文件夹位于游戏文件夹内的 `disco` 文件夹中。模组会在首次启动时自动创建该文件夹。歌曲必须是 Ogg Vorbis 格式,因此请先转换其他格式:`ffmpeg -i song.mp3 song.ogg`。你也可以运行 `/disco play ` 和 `/disco stop`。
### 音乐唱片
在你自己游玩的世界中,可以用四块煤炭或木炭围住一个铜锭,合成空白唱片(获得第一个铜锭后会解锁配方)。手持空白唱片或任意音乐唱片,点击歌曲旁的火焰弹图标即可将歌曲刻录到唱片上(创造模式下会获得一张新唱片)。把唱片放入唱片机,歌曲就会从唱片机播放;像原版唱片一样,走远后声音会逐渐减弱,周围的游戏内容也会跟着节拍变化。
如果进入世界时 Music 或 Master 音量为 0%,模组会提示你调高音量,因为歌曲使用 Music 音量播放。
### YouTube
输入关键词搜索,或粘贴 YouTube 视频或播放列表链接。选中的内容会加入队列并逐个下载;歌曲保存完成后会立即播放,或加入队列。搜索 YouTube 需要三个免费的程序:yt-dlp、FFmpeg 和 Deno。如果缺少这些程序,搜索界面会提示你复制下面的命令;在终端中运行后,无需重启游戏即可再次搜索:
“`bash
winget install yt-dlp.yt-dlp Gyan.FFmpeg DenoLand.Deno
“`
你也可以把 `yt-dlp` 和 `ffmpeg` 放进 `disco/tools`。超过 12 分钟的视频会被跳过,因为混音或直播解码后无法全部放入内存。请只下载你有权使用的音乐:YouTube 的条款不允许下载内容。
### 系统音频
`System audio`(或 `/disco live`)是实验性功能,仅支持 Windows,因此模组会在启用前征求你的同意。它会监听 Windows 播放的音频,大约五秒内识别节拍并持续跟踪,同时预测接下来的节拍,让游戏保持同步。节拍可能会漂移或丢失;本地歌曲的跟踪效果最好,因为模组会在歌曲开始前分析整首歌曲。
### 节奏同步
如果歌曲识别出的速度是实际速度的一半或两倍,请在菜单的“同步”标签页点击 `/2` 或 `x2`(也可以运行 `/disco half` 或 `/disco x2`)。
模组会从 OpenAL 读取音频设备的延迟,并让视觉效果与听到的声音保持同步,因此大多数情况下无需校准。如果括号效果仍然早于你听到的节拍出现(蓝牙耳机用户常会遇到这种情况),播放音乐时跟着节奏按 `B`(或在菜单中按 `Space`),也可以使用“同步”标签页中的 `-10` 和 `+10`(按住 Shift 可按 1 毫秒为步长调整)。`/disco offset
### 无障碍
Minecraft 无障碍选项中的“失真效果”滑块可以调整速度变化、HUD 弹跳和舞蹈效果,设为 0% 时会完全关闭这些效果。“隐藏闪电闪烁”会关闭 HUD 火花和乐队返场时的烟花。“高对比度”会让节拍提示的边缘更暗。
在多人服务器上,该模组只会改变视觉效果和音效。挖掘节奏、生物攻击节奏和弹反功能需要在你自己游玩的世界中使用。
## 构建
使用 JDK 25 运行 `./gradlew build`。生成的 JAR 位于 `build/libs`。
无需构建即可运行的自检:
“`bash
java src/main/java/it/vitoesposito/mineatdisco/BeatTracker.java
java src/main/java/it/vitoesposito/mineatdisco/AudioClock.java
java src/main/java/it/vitoesposito/mineatdisco/YouTube.java
“`
## 许可证
MIT,详见 [LICENSE](LICENSE)。
常见问题
Mine at disco 支持哪些 Minecraft 版本?
Mine at disco 支持 Minecraft Java 版 26.3,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。
Mine at disco 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。
评论
登录后评论和评分