# 源README
Download the mod at [Modrinth](https://modrinth.com/mod/disc-jockey) or [CurseForge](https://www.curseforge.com/minecraft/mc-mods/disc-jockey)
# 该版本附加
___
# Disc Jockey Revive

一个 Minecraft Fabric 模组，旨在为音符盒音乐爱好者提供强大的播放和即兴演奏功能。

## 模组特性

### 🎵 歌曲播放
- **播放 `.nbs` 歌曲文件**：支持标准的 Note Block Studio (`.nbs`) 歌曲文件（暂不支持带变速的）。
- **文件夹管理**：支持歌曲文件夹，方便组织和浏览您的音乐库。
- **多种播放模式**：
    - **单曲循环**：重复播放当前歌曲。
    - **列表循环**：按顺序循环播放当前文件夹或列表中的歌曲。
    - **随机播放**：随机播放当前文件夹或列表中的歌曲。
    - **播完停止**：歌曲播放完毕后自动停止。
- **播放进度条**：在 HUD 上显示歌曲播放进度和时间。
- **实时调速**：在播放界面通过滑块实时调整歌曲播放速度（0.25x - 4.0x）。
- **播放失败处理**：当附近音符盒配置不正确时，可选择停止播放或自动播放下一首。
- **音符盒材料清单**：显示播放当前歌曲所需的所有音符盒材料及数量。
- **自动调音**：模组会自动识别并调音附近的音符盒以匹配歌曲音高。
- **全向音符盒音效 (客户端)**：
    - **常规模式**：在播放歌曲或预览时，使音符盒音效全向传播，提供更沉浸的听觉体验。
    - **强制模式**：强制所有音符盒音效（包括手动触发的）始终全向传播。

### 🎹 即兴演奏 (Live DJ)
- **独立界面**：通过专用快捷键打开一个独立界面，用于即兴演奏。
- **键盘弹奏**：利用键盘按键直接弹奏音符盒，就像在 FL Studio 中一样。
- **自定义键位映射**：
    - 独立的键位映射配置界面，允许您为每个键盘按键设置特定的音符（乐器和音高）。
    - 默认提供类似于 FL Studio 的键盘布局预设。
- **即兴演奏调音**：在即兴演奏界面中，可以一键对周围的音符盒进行调音，以确保弹奏的音符准确无误。
- **独立于歌曲播放**：即兴演奏功能与歌曲播放功能完全独立，互不干扰。

### ⚙️ 配置与调试
- **Mod Menu 集成**：通过 Mod Menu 轻松访问模组配置。
- **快捷键**：
    - 打开歌曲选择界面 (默认 `J`)。
    - 打开即兴演奏界面 (默认 `UNKNOW（未指定）`)。
- **调试模式**：可配置的调试模式，开启后会在日志中输出详细的调试信息，方便排查问题。

## 如何使用

1.  **安装**：将 `Disc Jockey Revive` 模组文件和 Fabric API 放入您的 Minecraft `mods` 文件夹。
2.  **添加歌曲**：
    *   在游戏中打开歌曲选择界面 (默认 `J` 键)。
    *   点击“打开文件夹”按钮，将 `.nbs` 歌曲文件放入弹出的 `disc_jockey/songs` 文件夹中。
    *   您也可以直接将 `.nbs` 文件拖放到歌曲选择界面中。
    *   点击“重新加载”按钮以加载新添加的歌曲。
3.  **播放歌曲**：
    *   在歌曲选择界面中选择一首歌曲。
    *   点击“播放”按钮。模组将自动寻找并调音附近的音符盒。
    *   确保您处于生存模式或创造模式，并且附近有足够的音符盒。
    *   您可以通过滑块调整播放速度，并通过播放模式按钮切换循环方式。
4.  **即兴演奏**：
    *   在游戏中打开即兴演奏界面 (默认 `UNKNOW` 键)。
    *   点击“开始调音”按钮，模组将自动调音附近的音符盒。
    *   调音完成后，您可以使用键盘按键直接弹奏音符盒。
    *   点击“编辑键位映射”按钮可以自定义每个按键对应的音符。

## 注意事项

*   **服务器兼容性**：此模组通过发送玩家交互数据包来控制音符盒。在某些服务器上，这可能被反作弊插件误判为作弊行为。**强烈建议在使用前联系服务器管理员。**
*   **音符盒数量**：为了获得最佳播放效果，请确保您周围有足够数量且种类齐全的音符盒。
*   **非官方版本**：此版本为非官方修订版，仅供学习和参考。请支持原版模组作者。

## 贡献与支持

如果您有任何问题、建议或发现 Bug，请联系[BRanulf](https://space.bilibili.com/479966868)（仅限于改二改版本，原版本请前往[原作者GitHub](https://github.com/SemmieDev/Disc-Jockey)）。

不回复是正常现象，因为我也只是随便做做，并没有打算正经地维护，真要搞的化我估计会去GitHub创建分支，而不是只在自己仓库中修改。

---