MiauNoteBlock 是一款完全运行在浏览器端的 Minecraft Note Block Studio(NBS) 编辑器。它的目标是让音符盒编曲在任何设备上都能用——电脑、笔记本、平板、手机,打开浏览器就能创作,无需安装、无需插件、也无需把文件上传到服务器。
它读写 Minecraft 音符盒社区通用的标准 .nbs 格式,支持 MIDI 导入导出,通过八度转换算法把任意音乐搬进音符盒音域且尽量不损失听感,还能在本地把作品渲染成 MP3 / WAV。
隐私优先: 所有文件都在你的浏览器里处理,不上传、不永久存储。
它最初以 NoteBlockWeb 的名字发布,现在正式更名为 MiauNoteBlock。
|
🎼 编辑
|
🎧 音频与 MIDI
|
|
🐈 更多
|
🌍 平台
|
编辑器已公开部署,任何人都可以免费使用:
https://webnbs.com ៷>ᴗ<៷
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
反馈邮箱:[email protected]
本项目采用 GNU General Public License v3.0 开源协议。
- 允许个人学习、本地自由修改;
- 任何公开分发(免费 / 商用)的衍生程序,必须保持开源、标注原作者,并遵循 GPLv3 协议;
- 禁止未经单独授权闭源打包进行商业售卖。,我不希望我的免费的软件被用于收益。
我们只是想让更多人能在不同设备上编辑 NBS,同时也加入了很多实用的新颖功能。
完整协议内容见 LICENSE。
本项目约 70% 的代码由 AI 编写。
虽然它不能保证代码质量完美,但事实证明 AI 确实令人印象深刻。由于个人习惯,有些代码缺乏完美的注释,并充斥着 AI 生成的无关备注。阅读代码时,你可以让 AI 提供协助。
我们不排斥你使用AI编写后提交PR,但是不要不经过review和测试就提交PR,这很烦。
