{"url":"https://levimc.org/mods/github.com/PuceLi/NoteBot/","id":"github.com/PuceLi/NoteBot","name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","owner":"PuceLi","logo":"https://levimc.org/mods/icons/f4013f15a0f81da3-288.webp","repository":"https://github.com/PuceLi/NoteBot","issues":"https://github.com/PuceLi/NoteBot/issues","releases":"https://github.com/PuceLi/NoteBot/releases","stars":4,"downloads":89,"updated":"2026-11-15T04:28:10Z","published":"2026-10-07T12:31:51Z","created":"2026-10-07T08:54:59Z","license":"GPL-3.0","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.60","1.26.51"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"client","version":"1.2.2","install":"lip install github.com/PuceLi/NoteBot#client@1.2.2"},"readmes":[{"file":"README.md","lang":"en","text":"# NoteBot\n\nNoteBot is a client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files.\n\n[![中文](https://img.shields.io/badge/中文-informational?style=for-the-badge)](README_zh.md)\n\n<p align=\"center\">\n  <img src=\"preview.png\" alt=\"NoteBot\" style=\"max-width: 100%; height: auto;\">\n</p>\n\n---\n\n## Installation\n\nMake sure the **LeviLamina** dependency is installed.\n\n### Installing with LIP\n\n`lip install github.com/PuceLi/NoteBot`\n\n### Manual Installation\n\n- Download `NoteBot-client-windows-x64.zip` from [Releases](https://github.com/PuceLi/NoteBot/releases).\n- Install via **LeviLauncher**, or extract the files into `/path/to/your/mods`.\n- Launch the game.\n\n## Usage\n\n### Preparing Songs\n\n1. On the main interface, click **Open Song List** → **Open Song Folder**, then place your `.nbs` files into the folder.\n2. Once added, click **Refresh** to update the list.\n\n### Loading & Playing\n\n1. Enter a world, stand near the note blocks you want to use, and switch to Survival Mode.\n2. Press `L` to open the NoteBot interface (the hotkey can be rebound under **Keybindings**).\n3. Click **Open Song List**, find your song, and click **Load**.\n4. Return to the main menu and click **Play**. The mod will scan nearby note blocks, match the required pitches (tuning them beforehand if necessary), and begin playing.\n\nYou can also click **Scan Note Blocks** first to verify nearby block matching. The song status will display the number of available note blocks and any missing notes; expand **Missing Notes** to view the specific missing pitches.\n\n### Previewing Songs\n\nClick **Play** directly in the song list to preview a song without needing to enter a world.\n\n## Project Status\n\nThis mod currently has several known issues.\n[Issue](https://github.com/PuceLi/NoteBot/issues) is welcome below.\n\n## Third-Party Credits\n\n- [Meteor Client(GPL-3.0)](https://github.com/MeteorDevelopment/meteor-client) - Ported UI to this project\n\n## Vedio\n\n[YouTuBe](https://youtu.be/JvPiIVKTFDY)\n\n[BiliBili](https://www.bilibili.com/video/BV1mmHk6dEop)"},{"file":"README_zh.md","lang":"zh-Hans","text":"# NoteBot\n\nNoteBot 是一个可以加载的 NBS（Noteblock Studio）文件弹奏音符盒的客户端模组\n\n[![English](https://img.shields.io/badge/English-informational?style=for-the-badge)](README.md)\n\n<p align=\"center\">\n  <img src=\"preview.png\" alt=\"NoteBot\" style=\"max-width: 100%; height: auto;\">\n</p>\n\n---\n\n## 安装\n\n请确保已安装 **LeviLamina** 依赖\n\n### 使用 LIP 安装\n\n`lip install github.com/PuceLi/NoteBot`\n\n### 手动安装\n\n- 从 [Releases](https://github.com/PuceLi/NoteBot/releases) 下载 `NoteBot-client-windows-x64.zip`\n- 使用 **LeviLauncher** 安装，或将文件解压到 `/path/to/your/mods`\n- 启动游戏\n\n## 使用方法\n\n### 准备歌曲\n\n1. 在主界面点击 **打开歌曲列表** → **打开歌曲文件夹**，将 `.nbs` 歌曲文件放入文件夹内\n2. 文件放入后，点击 **刷新** 更新列表\n\n### 加载与演奏\n\n1. 进入世界，靠近要使用的音符盒，并切换到生存模式\n2. 按 `L` 打开 NoteBot 主界面，可以在 **按键绑定** 区域更改打开界面的按键\n3. 点击 **打开歌曲列表**，在歌曲列表中点击需要加载的歌曲后的 **加载**\n4. 回到主界面，点击 **弹奏**，插件会扫描附近音符盒、匹配歌曲所需音符，并在需要时先调整音符盒音高，然后开始演奏\n\n可以先点击 **扫描音符盒** 查看附近音符盒的匹配情况,歌曲状态会显示找到的音符盒数量和缺少的音符；展开 **缺失的音符** 可查看具体缺项\n\n### 试听歌曲\n\n在歌曲列表点击 **播放** 可以试听歌曲，无需进入世界\n\n## 项目状态\n\n此模组目前仍有很多未知的问题，欢迎在 [Issue](https://github.com/PuceLi/NoteBot/issues) 中反馈\n\n由于开发精力有限，该项目更新速度会比较慢\n\n## Credits\n\n- [Meteor Client(GPL-3.0)](https://github.com/MeteorDevelopment/meteor-client) - 移植 UI 到此项目\n\n## 视频演示\n\n[YouTube](https://youtu.be/JvPiIVKTFDY)\n\n[哔哩哔哩](https://www.bilibili.com/video/BV1mmHk6dEop)\n"}],"gallery":[],"versions":[{"version":"1.2.2","prerelease":false,"released":"2026-11-15T04:28:10Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.2.2","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.2.2/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.60.*"}}]}},{"version":"1.2.1","prerelease":false,"released":"2026-11-14T02:05:52Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.2.1","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.2.1/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.60.*"}}]}},{"version":"1.2.0","prerelease":false,"released":"2026-11-10T15:26:37Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.2.0","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.2.0/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.60.*"}}]}},{"version":"1.1.0","prerelease":true,"released":"2026-11-06T16:32:14Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.1.0","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.1.0/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"],"logo":"https://github.com/PuceLi/NoteBot/NoteBlock.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.60.*"}}]}},{"version":"1.0.2","prerelease":false,"released":"2026-11-01T01:53:08Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.0.2","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.0.2/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"],"logo":"https://github.com/PuceLi/NoteBot/NoteBlock.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}},{"version":"1.0.1","prerelease":false,"released":"2026-10-25T11:22:49Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.0.1","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.0.1/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"],"logo":"https://github.com/PuceLi/NoteBot/NoteBlock.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}},{"version":"1.0.0","prerelease":false,"released":"2026-10-07T12:31:51Z","releaseUrl":"https://github.com/PuceLi/NoteBot/releases/tag/v1.0.0","manifestUrl":"https://github.com/PuceLi/NoteBot/blob/v1.0.0/tooth.json","info":{"name":"NoteBot","description":"A client-side feature that automatically plays songs by tuning and hitting nearby Note Blocks based on loaded NBS (Noteblock Studio) files","tags":["platform:levilamina","type:mod"],"logo":"https://github.com/PuceLi/NoteBot/NoteBlock.png"},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}