76 lines
4.6 KiB
Markdown
76 lines
4.6 KiB
Markdown
# 源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创建分支，而不是只在自己仓库中修改。
|
||
|
||
---
|