DIsc_Jockey_revive/README.md

源README

Download the mod at Modrinth or CurseForge

该版本附加

---

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（仅限于改二改版本，原版本请前往原作者GitHub）。

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

---