Skip to content

About

A new generation NoteBlockStudio with unprecedented features and support for mobile devices.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

MiauNoteBlock

MiauNoteBlock

一款完全在浏览器中运行的跨平台我的世界音符盒(NBS)音乐编辑器。

编曲、编辑、试听、导出,全程无需安装,功能丰富,让自动化辅助你快速编曲!

Stars License Website Languages PRs Welcome Made with AI

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 半透明材质
  • 原生桌面 / 移动客户端已在计划中

⬇ 在线体验

编辑器已公开部署,任何人都可以免费使用:

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 生成,可能并不完全准确。


🛠 技术栈

HTML5 CSS3 JavaScript Canvas Web Audio Web MIDI FastAPI Python Node.js

  • 前端: 原生 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、修翻译、加功能、提设计建议都行。

  1. 发现 BUG 或有新想法? 请到 Issues 提交。
  2. 翻译: 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。


🤖 关于 AI 生成的代码

本项目约 70% 的代码由 AI 编写。

虽然它不能保证代码质量完美,但事实证明 AI 确实令人印象深刻。由于个人习惯,有些代码缺乏完美的注释,并充斥着 AI 生成的无关备注。阅读代码时,你可以让 AI 提供协助。

我们不排斥你使用AI编写后提交PR,但是不要不经过review和测试就提交PR,这很烦。


如果 MiauNoteBlock 对你的我的世界音符盒创作有帮助,请点一个 ⭐ Star,这真的很重要!

给项目点 Star

用 ❤ 和大量的提示词工程制作,还有时间哦。

About

A new generation NoteBlockStudio with unprecedented features and support for mobile devices.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Contributors

Languages