像素节拍

PixelBeat是一个音乐模组。它会扫描本地音乐目录,在游戏内作为背景音乐播放你的曲目,读取匹配的歌词文件,并在屏幕左上角渲染一个轻量级的像素风格HUD。

游戏机制

PixelBeat

PixelBeat 是一个适用于 Minecraft 1.20 的客户端 Fabric 音乐模组。

它会扫描本地音乐目录,将你的曲目作为游戏内背景音乐播放,读取同名的 .lrc 歌词文件,并在屏幕左上角渲染一个轻量级的像素风格 HUD。

亮点

  • 播放来自 pixelbeat_music/ 或自定义配置目录的本地音乐文件
  • 扫描音乐文件时支持子目录
  • 从每首曲目所在的同一文件夹读取同名 .lrc 歌词文件
  • 显示紧凑的像素风格 HUD,包含曲目标题、歌词行、进度条、时间标签和播放控制
  • 支持上一首 / 暂停 / 下一首 / 重新加载 / 播放模式切换
  • 支持点击进度条跳转
  • 支持拖拽 HUD,并将 HUD 位置保存回配置
  • 当没有可用的音乐文件时,HUD 会自动隐藏
  • 支持双击歌词行展开歌词
  • 展开的歌词面板支持鼠标滚轮滚动和双击跳转
  • 支持 LIST_LOOP、SINGLE_LOOP 和 SHUFFLE 播放模式
  • 跟随 Minecraft RECORDS 音量
  • 为音乐目录、HUD 布局和主题颜色提供基于文件的配置

音乐与歌词

  • 模组当前扫描的支持的文件扩展名:mp3、ogg、wav、flac、aiff、au
  • 为获得最佳兼容性,推荐使用 wav 和 ogg
  • 歌词应作为同名 .lrc 文件存储在音乐文件旁边

示例:

.minecraft/
  pixelbeat_music/
    song-a.mp3
    song-a.lrc
    subfolder/
      song-b.ogg
      song-b.lrc

配置

首次启动后,模组会创建:

.minecraft/config/pixelbeat.json

你可以自定义:

  • 音乐目录
  • 重新扫描间隔
  • 默认播放模式
  • HUD 位置
  • HUD 行偏移和宽度
  • 按钮布局
  • 时间 / 状态 / 歌词可见性
  • 拖拽行为
  • 展开歌词面板大小
  • HUD 和歌词面板主题颜色
  • HUD 背景颜色和透明度
  • 展开歌词面板背景颜色和透明度