## CraftMusic<\/p>\n
CraftMusic is a client-side local music player for Minecraft (NeoForge). It plays audio files from your computer inside the game and shows synchronized lyrics. <\/p>\n
### What it does
\n– Plays local audio files placed in the game folder `CraftMusic\/`.
\n– Supports ogg, mp3, flac, wav. Fully supports Chinese file names\/paths on Windows.
\n– Provides an in-game UI for browsing and controlling playback, plus optional floating (on-screen) lyrics.<\/p>\n
### Key features ### Supported Languages ### How to use ### Configuration (config\/craftmusic-client.json) ### Requirements ### Limitations ### Credits ### Troubleshooting A simple Minecraft built-in music player mod<\/p>\n","protected":false},"featured_media":48020,"template":"","meta":{"_minecraft_slug":"craftmusic","_minecraft_project_id":"gMk1R9tH","_minecraft_author":"tqk114514","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":303,"_minecraft_follows":7,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"craftmusic.zip","_minecraft_size_bytes":3418841,"_minecraft_version_count":10,"_minecraft_updated_at":"2026-05-15T18:01:28.286006Z","_minecraft_date_created":"2025-08-16T20:53:13.990283Z","_minecraft_date_modified":"2025-11-21T08:56:24.632666Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/craftmusic","_minecraft_icon_attachment_id":48020,"_minecraft_imported_at":"2026-06-02T11:42:48+00:00","_minecraft_import_hash":"ecf9d9e81a1e0c0c4d6330e00e5ae327","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[158,123,92],"mod_loader":[160],"minecraft_version":[37,73,74,38,78],"class_list":["post-48019","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-neoforge","mod_category-technology","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n– Playback: play\/pause\/resume, previous\/next, seek by dragging, volume control, and modes: Sequential \/ Repeat All \/ Shuffle \/ Repeat One.
\n– UI: QuickPlay screen with track list (double-click to play), seekbar, time text, volume bar, mode switch, refresh, open folder, settings.
\n– Lyrics: auto-detects same-name `.lrc` files (UTF-8\/GBK); centered panel with current line highlight and gentle scaling; shows \u201cNo lyrics \/ Instrumental\u201d when absent.
\n– Floating lyrics: toggle on\/off; render scope Global or In-World only; position Top-Left\/Top-Right\/Bottom-Left\/Bottom-Right (left edges left-aligned, right edges right-aligned).
\n– Keybinding: default M opens the UI. Also a title-screen button.
\n– Commands: `\/craftmusic play
\n– Persistence: settings saved to `config\/craftmusic-client.json`.<\/p>\n
\nCraftMusic now supports **12 languages** for a truly global experience:
\n– **English** (en_us) \ud83c\uddec\ud83c\udde7
\n– **Simplified Chinese** (zh_cn) \ud83c\udde8\ud83c\uddf3
\n– **Traditional Chinese – Hong Kong** (zh_hk) \ud83c\udded\ud83c\uddf0
\n– **Traditional Chinese – Taiwan** (zh_tw) \ud83c\uddf9\ud83c\uddfc
\n– **Classical Chinese** (lzh) – Literary style
\n– **Korean** (ko_kr) \ud83c\uddf0\ud83c\uddf7
\n– **Japanese** (ja_jp) \ud83c\uddef\ud83c\uddf5
\n– **Spanish** (es_es) \ud83c\uddea\ud83c\uddf8
\n– **French** (fr_fr) \ud83c\uddeb\ud83c\uddf7
\n– **German** (de_de) \ud83c\udde9\ud83c\uddea
\n– **Russian** (ru_ru) \ud83c\uddf7\ud83c\uddfa
\n– **LOLCAT** (lol_us) – I can has mewsic!<\/p>\n
\n1) Place your audio files into `
\n2) Launch the game. Press M or click the title-screen button \u201cCraftMusic\u201d to open the player.
\n3) Double-click a song to play. Use bottom controls to seek, switch tracks, adjust volume, and change mode.
\n4) Lyrics: put a same-named `.lrc` next to the audio file. If found, lyrics sync automatically.
\n5) Floating lyrics: open Settings to control on\/off, render scope (Global \/ In-World), and position.<\/p>\n
\n– `volume`: float 0.0\u20131.0
\n– `mode`: `SEQUENTIAL` | `REPEAT_ALL` | `SHUFFLE` | `REPEAT_ONE`
\n– `lyricEffects`: boolean, enables lyric scrolling\/scale effects
\n– `floatingLyrics`: boolean, floating lyrics on\/off
\n– `floatingLyricsRender`: `GLOBAL` (all screens) | `WORLD` (only in-game)
\n– `floatingLyricsPosition`: `TOP_LEFT` | `TOP_RIGHT` | `BOTTOM_LEFT` | `BOTTOM_RIGHT`<\/p>\n
\n– Client-side, NeoForge-based Minecraft.
\n– Windows only. The native audio backend (miniaudio) is distributed as a Windows DLL.<\/p>\n
\n– Windows platform only.<\/p>\n
\n– Audio backend: miniaudio.<\/p>\n
\n– \u201cAudio output not ready\u201d: ensure the native DLL is properly loaded (Windows) and restart the game.
\n– Chinese filenames not playing: the mod uses wide-character APIs on Windows; ensure the file exists and is readable.<\/p>\n","protected":false},"excerpt":{"rendered":"