MiauNoteBlock
一款完全在浏览器中运行的跨平台我的世界音符盒(NBS)音乐编辑器。
编曲、编辑、试听、导出,全程无需安装,功能丰富,让自动化辅助你快速编曲!
English · 简体中文
📖 目录
🐱 MiauNoteBlock 是什么?
MiauNoteBlock 是一款完全运行在浏览器端的 Minecraft Note Block Studio(NBS) 编辑器。它的目标是让音符盒编曲在任何设备上都能用——电脑、笔记本、平板、手机,打开浏览器就能创作,无需安装、无需插件、也无需把文件上传到服务器。
它读写 Minecraft 音符盒社区通用的标准 .nbs 格式,支持 MIDI 导入导出,通过八度转换算法把任意音乐搬进音符盒音域且尽量不损失听感,还能在本地把作品渲染成 MP3 / WAV。
隐私优先: 所有文件都在你的浏览器里处理,不上传、不永久存储。
它最初以 NoteBlockWeb 的名字发布,现在正式更名为 MiauNoteBlock。
✨ 功能特性
|
🎼 编辑
- Canvas 实现的完整钢琴卷帘编辑器
- 标准
.nbs 导入 / 导出
- 画笔、橡皮、选择、演奏等多种工具
- 框选多选、复制粘贴、撤销重做
- 音符查找 / 替换(Ctrl+F)
- 音轨管理、音量与音色控制
- 音符点击次数 / 方块名叠加显示
|
🎧 音频与 MIDI
- MIDI 导入 / 导出,完全离线
- 八度转换算法:在尽量不损失听感的前提下把音乐塞进音符盒音域
- GM 音色拟合:把 MIDI 的 General MIDI 音色映射到 NBS 音色,并按乐器自动配置高 / 低替代音色
- 延音轨道自动识别:风琴、弦乐、Pad 等持续型音色自动启用延音
- 支持 SoundFont(SF3 / SF2),基于 SpessaSynth,失败时回退内置合成器
- 在浏览器内直接渲染导出 MP3 / WAV
|
|
🐈 更多
- 自定义音色:导入自己的采样,本地保存(元数据存
localStorage,音频存 IndexedDB)
- 歌曲压缩:基于感知模型的音符精简,从「仅去重」到强力压缩,并实时预估体积
- QWERTY 演奏模式:把网格当成乐器来弹
- 创作辅助工具,让编排更顺手
- 完全离线构建(
file://),音频内嵌可直接双击打开
|
🌍 平台
- 任何现代浏览器都能跑,免安装就是我们的特点,当然我们也正在逐步推测安装版本的,来摆脱浏览器的多余UI。
- 触控优化:画笔 / 橡皮连续涂抹、双指平移、横屏抽屉
- 10 种界面语言(AI 翻译)
- 仿 WinUI 3 / Fluent Design 的自适应主题,含 Mica / Acrylic 半透明材质
- 原生桌面 / 移动客户端已在计划中
|
⬇ 在线体验
编辑器已公开部署,任何人都可以免费使用:
B站Toy版本:https://www.bilibili.com/toy/webnbs
无需下载、无需安装,作品始终留在你自己的设备上。
离线 / 自托管构建(双击 index.html,可在 file:// 下使用):
npm install # 仅构建脚本需要,一次即可
npm run build # src/ -> blbl-toy/,音频以 base64 内嵌
然后打开 blbl-toy/index.html。
为了摆脱浏览器窗口的限制,我们正在计划制作原生桌面 / 移动客户端。
🌍 支持的界面语言
| 语言 |
Locale |
| English (United States) |
en-US |
| 简体中文 |
zh-CN |
| Español |
es-ES |
| Português (Brasil) |
pt-BR |
| Русский |
ru-RU |
| Deutsch |
de-DE |
| Français |
fr-FR |
| 日本語 |
ja-JP |
| 한국어 |
ko-KR |
| Bahasa Indonesia |
id-ID |
翻译由 AI 生成,可能并不完全准确。
🛠 技术栈
- 前端: 原生 JavaScript(无框架)、分层 Canvas 渲染、Web Audio API 播放、Web MIDI 实时输入。
- 音频: 使用 SpessaSynth(
WorkletSynthesizer)播放 SoundFont,另有内置回退合成器,以及一套离线渲染管线用于导出 MP3/WAV。
- 后端: 一个轻量的 FastAPI 服务,只负责托管静态文件、提供极小的
/api/config 接口并注入 SEO 元数据。所有 NBS/MIDI 的解析、转换与播放都在客户端完成。
🚀 快速开始
本地运行(开发服务器)
# 1. 安装 Python 依赖
pip install fastapi uvicorn pyyaml
# 2. 启动服务(读取 config.yaml,默认端口 8000)
python app.py
然后访问 http://127.0.0.1:8000(如果你改端口了,需要注意访问的端口是否正确)。
构建离线包
npm run build # 或:node build_local.js
# Windows 便捷脚本:
build_local.bat
构建产物在 blbl-toy/,其中的 20 个 OGG 音色样本会以 base64 内嵌,可直接从磁盘双击打开使用。
正如文件夹名称,这个脚本的目的就是构建离线包,便于我上传B站的Toy。
本项目已经上传了Bilibili Toy:https://www.bilibili.com/toy/webnbs
配置
首次启动会自动生成 config.yaml,用于配置监听地址与端口、隐私声明、应用内显示的更新日志、SoundFont 下载地址以及 SEO 元数据。
📁 项目结构
MiauNoteBlock/
├── app.py # FastAPI 静态托管 + SEO 注入
├── config.yaml # 服务器 / 隐私 / 版本 / 音色库 / SEO 配置
├── build_local.js # 离线(file://)构建脚本
├── build_local.bat # Windows 构建脚本
├── src/
│ ├── index.html # 单页应用外壳
│ └── static/
│ ├── css/ # WinUI / Fluent 风格主题
│ ├── js/ # 编辑器、钢琴卷帘、NBS/MIDI 客户端、音频引擎、i18n
│ ├── sounds/ # 20 个 OGG 音符盒音色样本
│ └── sprites/ # 乐器图标
├── docs/ # 设计文档
└── test/ # Node / Python 回归测试
👥 参与贡献
欢迎任何规模的贡献——报 Bug、修翻译、加功能、提设计建议都行。
- 发现 BUG 或有新想法? 请到 Issues 提交。
- 翻译: 10 种语言的词典都在
src/static/js/i18n.js,补充或修正文案是很好的入门贡献。
本地开发需要 Node.js(用于构建与测试)和 Python 3(用于开发服务器)。
💬 交流与反馈
欢迎加入 QQ 交流群,分享乐曲、获取技术支持,和其他 NBS 创作者交流:
QQ 交流群:2156069838
反馈邮箱:3451392772@qq.com
📜 开源协议
本项目采用 GNU General Public License v3.0 开源协议。
- 允许个人学习、本地自由修改;
- 任何公开分发(免费 / 商用)的衍生程序,必须保持开源、标注原作者,并遵循 GPLv3 协议;
- 禁止未经单独授权闭源打包进行商业售卖。,我不希望我的免费的软件被用于收益。
我们只是想让更多人能在不同设备上编辑 NBS,同时也加入了很多实用的新颖功能。
完整协议内容见 LICENSE。
🤖 关于 AI 生成的代码
本项目约 70% 的代码由 AI 编写。
虽然它不能保证代码质量完美,但事实证明 AI 确实令人印象深刻。由于个人习惯,有些代码缺乏完美的注释,并充斥着 AI 生成的无关备注。阅读代码时,你可以让 AI 提供协助。
我们不排斥你使用AI编写后提交PR,但是不要不经过review和测试就提交PR,这很烦。
如果 MiauNoteBlock 对你的我的世界音符盒创作有帮助,请点一个 ⭐ Star,这真的很重要!
用 ❤ 和大量的提示词工程制作,还有时间哦。