PixelBeat

PixelBeat is a client-side Fabric music mod for Minecraft 1.20.

It scans a local music directory, plays your tracks as in-game background music, reads matching .lrc lyric files, and renders a lightweight pixel-style HUD in the top-left corner of the screen.

Highlights

• Plays local music files from pixelbeat_music/ or a custom configured directory
• Supports subdirectories when scanning music files
• Reads same-name .lrc lyric files from the same folder as each track
• Shows a compact pixel-style HUD with track title, lyric line, progress bar, time labels, and playback controls
• Supports previous / pause / next / reload / play-mode switching
• Lets you click the progress bar to seek
• Lets you drag the HUD and saves the HUD position back to config
• The HUD is auto-hidden when no music files are available
• Supports lyric expansion by double-clicking the lyric line
• Expanded lyric panel supports mouse wheel scrolling and double-click seek
• Supports LIST_LOOP, SINGLE_LOOP, and SHUFFLE play-modes
• Follows Minecraft RECORDS volume
• Provides file-based configuration for music directory, HUD layout, and theme colors

Music And Lyrics

• Supported file extensions currently scanned by the mod: mp3, ogg, wav, flac, aiff, au
• For best compatibility, wav and ogg are recommended
• Lyrics should be stored as a same-name .lrc file next to the music file

Example:

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

Configuration

After first launch, the mod creates:

.minecraft/config/pixelbeat.json

You can customize:

• Music directory
• Rescan interval
• Default play mode
• HUD position
• HUD row offsets and widths
• Button layout
• Time / status / lyric visibility
• Dragging behavior
• Expanded lyric panel size
• HUD and lyric panel theme colors
• HUD background color and transparency
• Expanded lyric panel background color and transparency