MCMidi

模组

· 作者 Karasu

MCMidi 是一款适用于 Minecraft Fabric 的模组,允许你在游戏中以高品质音效播放 MIDI 文件,并支持实时可视化。

0 本站下载 0 关注 更新于 8 个月前

需要前置:Cloth Config API、Fabric API、KarasunikiLib

最新 v2.1.2 · 1.21.7 · Fabric

一键开服(送7天)

MCMidi

MCMidi 是一个 Minecraft Fabric 模组,允许你在游戏中以高品质音效播放 MIDI 文件,并支持实时可视化。

功能

  • MIDI 播放:在 Minecraft 客户端中直接播放 .midi 或 .mid 文件。

  • 自定义 SoundFont:支持 .sf2 SoundFont 文件,以自定义乐器音色。

  • 实时可视化:专用的“Midi 控制中心”,包含多个可视化选项卡:

    • 详情:实时 MIDI 消息日志、BPM 和播放位置。
    • 节点:活动 MIDI 节点的可视化表示。(未实现。)
    • 钢琴:显示活动音符的虚拟钢琴卷帘。(未实现。)
  • 波形可视化:动态波形显示。(尚未实现。)

  • 游戏内配置:与 Mod Menu 和 Cloth Config 集成,可无缝调整设置。

  • 客户端命令:通过控制台命令快速控制播放。

命令用法

使用以下客户端命令管理 MIDI 播放:

  • /midi play <filename>:从本地库中播放一个 MIDI 文件。
  • /midi stop:停止当前的 MIDI 播放。

使用方法

  1. 准备文件:
    • 将 .midi 或 .mid 文件放入 Minecraft 实例文件夹中的 midi/musics/ 目录。
    • (可选)将 .sf2 SoundFont 文件放入 midi/soundfonts/ 目录。
  2. 启动 Minecraft:按 ,(默认按键绑定)打开 Midi Control Center。
  3. 配置设置:从主菜单打开模组菜单,找到 MCMidi,点击齿轮图标以调整音量或选择自定义 SoundFont。

已实现的架构

MCMidi 的设计注重模块化与可维护性:

  • 依赖注入:使用抽象的 IConfigManager 来处理配置,避免全局静态状态。
  • 抽象标签页系统:利用 KarasunikiLib 的 ITabBar 和 ITabContent 接口,提供灵活且可扩展的用户界面。
  • 解耦的 MIDI 引擎:采用 IMidiEngine 接口,使模组未来能够支持不同的 MIDI 驱动程序或外部设备。

依赖项

此模组需要以下库:

  • Fabric API
  • KarasunikiLib
  • Cloth Config API
  • Mod Menu(可选,建议用于配置界面)

贡献

欢迎贡献!如果您有建议、错误报告,或希望提交拉取请求,请遵循以下步骤:

  1. 克隆此仓库,并从 master 分支创建你的分支。
  2. 提交你的更改,并确保提交信息清晰明了。
  3. 确保代码能够成功构建并通过所有现有检查。
  4. 提交拉取请求(Pull Request),并附上对更改内容的描述。

对于重大更改,请先创建一个 Issue 以讨论你希望做出的修改。

许可证

本项目采用 MIT 许可证授权。详情请参阅 LICENSE。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源