合成音乐

合成音乐

一个简单的Minecraft内置音乐播放器模组

技术

CraftMusic

CraftMusic 是 Minecraft(NeoForge)的客户端本地音乐播放器。它可以在游戏内播放电脑中的音频文件,并显示同步歌词。

功能简介

  • 播放放置在游戏文件夹 CraftMusic/ 中的本地音频文件。
  • 支持 ogg、mp3、flac、wav 格式。在 Windows 上完全支持中文文件名/路径。
  • 提供游戏内 UI,用于浏览和控制播放,并可选显示浮动(屏幕)歌词。

主要特性

  • 播放:播放/暂停/继续、上一首/下一首、拖动进度、音量控制,以及模式:顺序播放 / 列表循环 / 随机播放 / 单曲循环。
  • UI:QuickPlay 界面包含曲目列表(双击播放)、进度条、时间文本、音量条、模式切换、刷新、打开文件夹、设置。
  • 歌词:自动检测同名 .lrc 文件(UTF-8/GBK);居中面板高亮当前行并带有柔和缩放效果;无歌词时显示“No lyrics / Instrumental”。
  • 浮动歌词:可开关;渲染范围为全局或仅游戏内;位置为左上/右上/左下/右下(左边缘左对齐,右边缘右对齐)。
  • 按键绑定:默认按 M 打开 UI。标题界面也有按钮。
  • 命令:/craftmusic play <path>、/craftmusic stop、/craftmusic ui、/craftmusic tone。
  • 持久化:设置保存到 config/craftmusic-client.json。

支持的语言

CraftMusic 现在支持 12 种语言,带来真正的全球化体验:

  • 英语(en_us)🇬🇧
  • 简体中文(zh_cn)🇨🇳
  • 繁体中文 - 香港(zh_hk)🇭🇰
  • 繁体中文 - 台湾(zh_tw)🇹🇼
  • 文言文(lzh)- 文学风格
  • 韩语(ko_kr)🇰🇷
  • 日语(ja_jp)🇯🇵
  • 西班牙语(es_es)🇪🇸
  • 法语(fr_fr)🇫🇷
  • 德语(de_de)🇩🇪
  • 俄语(ru_ru)🇷🇺
  • LOLCAT(lol_us)- I can has mewsic!

使用方法

  1. 将音频文件放入 <Minecraft Game Directory>/CraftMusic/。
  2. 启动游戏。按 M 或点击标题界面上的“CraftMusic”按钮打开播放器。
  3. 双击歌曲播放。使用底部控件调整进度、切换曲目、调节音量、更改模式。
  4. 歌词:在音频文件旁放置同名 .lrc 文件。找到后会自动同步歌词。
  5. 浮动歌词:打开设置以控制开关、渲染范围(全局 / 仅游戏内)和位置。

配置(config/craftmusic-client.json)

  • volume:浮点数 0.0–1.0
  • mode:SEQUENTIAL | REPEAT_ALL | SHUFFLE | REPEAT_ONE
  • lyricEffects:布尔值,启用歌词滚动/缩放效果
  • floatingLyrics:布尔值,浮动歌词开关
  • floatingLyricsRender:GLOBAL(所有界面) | WORLD(仅游戏内)
  • floatingLyricsPosition:TOP_LEFT | TOP_RIGHT | BOTTOM_LEFT | BOTTOM_RIGHT

要求

  • 客户端侧、基于 NeoForge 的 Minecraft。
  • 仅限 Windows。原生音频后端(miniaudio)以 Windows DLL 形式分发。

限制

  • 仅支持 Windows 平台。

致谢

故障排除

  • “Audio output not ready”:确保原生 DLL 已正确加载(Windows)并重启游戏。
  • 中文文件名无法播放:该模组在 Windows 上使用宽字符 API;请确保文件存在且可读。