KeyCraft MIDI 1.4.0 —— 建可编辑钢琴键盘并用 MIDI/乐谱驱动动画（Windows x64，Blender 4.2+）

做钢琴演奏动画，一颗颗给琴键打关键帧很痛苦。KeyCraft MIDI 在 Blender 里建可编辑键盘模型并接上 MIDI：用真实 MIDI 键盘实时弹、或导入 MIDI 文件/乐谱驱动，多个键盘可联动，琴键随音符自动动起来。

· 在 Blender 里创建可编辑的钢琴、合成器、Jankó 键盘与多层管风琴键盘
· 可给已有琴键网格装配动画骨架（rig）
· 用真实 MIDI 键盘实时驱动键盘动画
· 导入 MIDI 文件、MusicXML 乐谱驱动多个键盘联动
· 可选配 Audiveris 从 PDF/图片识别乐谱（需另行安装）
· 仅做几何动画，不生成声音；无需额外 Python 包或账号
· 注意：本扩展仅支持 Windows x64（live MIDI 用 Windows 内置 MIDI 输入）

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：安装启用后，在 3D 视口的 N 面板打开 KeyCraft 标签，创建或绑定键盘模型；连接 MIDI 键盘实时弹奏，或导入 MIDI/乐谱，让键盘随之动画；最后正常渲染演奏动画。

音乐可视化与演奏动画；教学演示（琴键随音符高亮）；虚拟乐器展示；把 MIDI 演奏做成三维动画。

问：要钱吗？答：免费开源，GPL-3.0-or-later。问：需要哪个 Blender 版本？答：4.2 及以上（5.1.2 测过）。问：支持哪些系统？答：仅 Windows x64。问：会发声吗？答：不发声，只做几何动画。问：能导入乐谱吗？答：能导 MIDI/MusicXML，PDF/图片识别需另装 Audiveris。

核心功能

· 在 Blender 里创建可编辑的钢琴、合成器、Jankó 键盘与多层管风琴键盘
· 可给已有琴键网格装配动画骨架（rig）
· 用真实 MIDI 键盘实时驱动键盘动画
· 导入 MIDI 文件、MusicXML 乐谱驱动多个键盘联动
· 可选配 Audiveris 从 PDF/图片识别乐谱（需另行安装）
· 仅做几何动画，不生成声音；无需额外 Python 包或账号
· 注意：本扩展仅支持 Windows x64（live MIDI 用 Windows 内置 MIDI 输入）

安装与用法

在 Blender「编辑 → 偏好设置 → 扩展 → 从磁盘安装」选中本包 zip（不要解压）并启用。用法：安装启用后，在 3D 视口的 N 面板打开 KeyCraft 标签，创建或绑定键盘模型；连接 MIDI 键盘实时弹奏，或导入 MIDI/乐谱，让键盘随之动画；最后正常渲染演奏动画。

适用场景

音乐可视化与演奏动画；教学演示（琴键随音符高亮）；虚拟乐器展示；把 MIDI 演奏做成三维动画。

常见问题

问：要钱吗？答：免费开源，GPL-3.0-or-later。问：需要哪个 Blender 版本？答：4.2 及以上（5.1.2 测过）。问：支持哪些系统？答：仅 Windows x64。问：会发声吗？答：不发声，只做几何动画。问：能导入乐谱吗？答：能导 MIDI/MusicXML，PDF/图片识别需另装 Audiveris。

深度解读

钢琴演奏动画是音乐可视化里很吸引人、也很费工的题材：要让每个琴键在对的音符上抬起落下，手动打关键帧几乎不可行，尤其是多声部、快速跑动时。KeyCraft MIDI 的解法是把「琴键动画」和「MIDI 数据」直接挂起来：你可以在 Blender 里建可编辑的钢琴、合成器、Jankó 式（等音）键盘与多层管风琴键盘，或给已有的琴键网格装上一套 rig，然后用真实 MIDI 键盘实时演奏来驱动动画、或者导入 MIDI 文件、MusicXML 乐谱让多个键盘一起联动。它甚至支持（可选、需另装 Audiveris）从 PDF/图片做乐谱识别，把纸质乐谱也变成可驱动的数据。它明确声明「只做几何动画、不生成声音」，这说明它对定位很诚实——你是拿它做画面，而不是音频。需要清醒的边界：本扩展仅支持 Windows x64（实时 MIDI 依赖 Windows 内置 MIDI 输入），macOS/Linux 用户用不了；PDF/图片乐谱识别依赖外部的 Audiveris，且识别质量受乐谱清晰度限制；乐理复杂、装饰音与踏板等细节在动画里未必还原；Jankó 等特殊键盘要有相应模型配合。但对做音乐可视化、演奏动画与教学演示、尤其在 Windows 上的创作者，KeyCraft MIDI 把「琴键随音乐跳动」从逐帧苦活变成了导入数据、接上键盘就能出画面的流程。

包内文件说明

本包为 KeyCraft MIDI 1.4.0（作者 Steveryino），解压后共 17 个文件、合计 287,873 字节。根目录含 blender_manifest.toml（id=keycraft_midi、version 1.4.0、blender_version_min 4.2.0）与 __init__.py 注册入口；顶层条目：CHANGELOG.md、COPYING、LICENSE.txt、README.md、__init__.py、binding.py、blender_manifest.toml、geometry.py、janko.py、midi_backend.py、organ.py、performance_ui.py、routing.py、runtime.py、score_animation.py、score_io.py、score_ocr.py。

原产品页：https://extensions.blender.org/add-ons/keycraft-midi/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。