Disc Jockey Plus Supported Mod Loaders: Fabric (>=0.19.5)[Stable] NeoForge (>=26.3.0.52) [Unstable][Deving] ================= > Messages If you want the latest updates, search for SQL_Minecraft on Bilibili and subscribe to me. > A professional note-block music mod for Minecraft Java 26.2-26.3 > Unofficial fork of the original Disc Jockey - Fully ported to 26.2-26.3 - > Built-in full localization - Real-time spectrum visualization - 88-key piano keyboard Fabric Dependent Mods -------------- - Fabric Loader >= 0.19.5 - Fabric API >= 0.161.0 - Cloth Config API >= 26.2.155 - Mod Menu >= 20.0.1 (optional) - PianoLib >= 1.0.7+DJP2.7.7 (optional) -------------- NeoForge Dependent Mods - NeoForge Loader >=26.3.0.52 (Do Not Use 26.3.0.56!) ================================================================================ Introduction ================================================================================ Disc Jockey Plus is an unofficial fork of the original Disc Jockey, fully ported to Minecraft Java 26.2-26.3. It adds an 88-key piano keyboard (A0-C8), real-time spectrum visualization, MIDI import/export, non-destructive NBS pitch-range repair (Clamp/Fold), instrument remapping, a preview system, a sleep timer, and full internationalization. Press J or run /discjockey to open the main GUI. ================================================================================== In game check update /discjockey update ================================================================================ Piano Screen ================================================================================ ##Add a Piano Screen , Press Keyborads to Play.Please Use PianoLib. ================================================================================ Anti-Anti-Cheating ================================================================================ Reinforced Anti-Anti-Cheating. ================================================================================ Core Features ================================================================================ 88-Key Piano Keyboard --------------------- - Covers all 88 semitones from A0 (-39) to C8 (48), zeroed at A0, mapped one-to-one to PianoLib / NoteBlock pitches. - Physical keyboard mapping (C-major layout: A S D F G H J K L ; ' plus black keys W E T Y U O P [ ]); keys 1/2/3 are fixed to A0/A#0/B0 for quick testing and recording. - Octave transposition: [-] / [+] buttons or the 0 key jump to C4; getDisp() shows the current octave offset. - Three playback paths are tried in order: PianoAPI (sqlmc.api.PianoAPI) first, then PianoLib 88-note cache (pianolib:key_0-key_87), and finally NOTE_BLOCK_HARP with pitch fallback, so sound works both on the main menu and in-world. - MIDI recording: built-in MidiRecorder supports sustain pedal (Sustain CC64), reverb (Reverb CC91/93), and ADSR envelopes; recorded .mid files are auto-saved to the recordings/ folder. Real-Time Spectrum Visualization -------------------------------- - A 16-band spectrum with peak-hold and exponential decay, rendering smoothly with no ghosting. - Five render styles are available and can be switched with one click in the GUI: BAR, WAVE, RING, MIRROR, PARTICLE. - The spectrum is always shown on the main menu and in-world HUD (controlled by the spectrumAlwaysVisible config); both playback and preview drive the spectrum. NBS Playback & NBS Repair (Clamp / Fold) ----------------------------------------- - Loads .nbs songs with support for play / pause / stop / resume / loop / shuffle / autoplay. - Clamp / Fold (non-destructive): runs octave folding at runtime for NBS songs outside the 0-24 range; the original file is not modified and nothing is written to disk, only a foldedNotes cache is generated. - fold auto enables automatic repair; fold scan scans all songs; fold info shows the pitch-range report for a single song. - Transpose: applies runtime octave-fold transposition to notes to prevent high notes from being clipped. MIDI Import & Export -------------------- - NBS -> MIDI export (disc_jockey.screen.export_midi): exports a standard .mid with tempo (Tempo), time signature (4/4 Time Signature), and bar markers (Bar Marker); output goes to the midi/ folder and is opened automatically. - MIDI -> NBS import (disc_jockey.screen.import_midi): reads .mid / .midi via a built-in file chooser, parses note events, generates a Song, and safely falls back on empty files or parse failures. Preview System -------------- - Preview songs from both the main menu and in-world (uses SoundSource.MASTER when outside a world; auto-switches to playLocalSound after joining a world). - M mutes / unmutes preview; P toggles preview looping (keybindings are customizable in Controls settings). - Preview and playback are mutually exclusive: starting one automatically stops the other. Instrument Management -------------------- - instrument counts nearby note blocks of the specified instrument. - remapInstruments manages instrument mapping: map / unmap / show / clear - map one instrument to another (e.g. brass), resolving server-side instrument detection differences. Speed & Transpose ----------------- - speed adjusts playback / preview speed (default 1.0, shared with preview stepping). - transpose transposes the current song (octave folding, preserving #F24 from being clipped). Utilities --------- - reload reloads all songs (including hot-reload watching). - spectrum toggles the in-GUI spectrum display on / off. - sleep stops playback after a timer, or cancels the timer. - now / info / progress show the current song, its info, and playback progress. - clampstatus / fold status check repair status; unclamp cancels repair. ================================================================================ Command Reference ================================================================================ Basic Playback -------------- /discjockey Open the Disc Jockey GUI /discjockey play Play the specified song /discjockey pause Pause playback /discjockey stop Stop playback /discjockey resume Resume playback /discjockey now Show the song currently playing /discjockey info Show current song info and playback speed /discjockey progress Show playback progress Playback Modes -------------- /discjockey loop yes|no Enable / disable single-song loop /discjockey shuffle Toggle shuffle playback mode /discjockey autoplay Enable / disable auto-play (queue) /discjockey random Play a random song from the GUI list Preview ------- /discjockey preview Preview the specified song or show preview status M key Mute / unmute preview P key Enable / disable preview looping Keybindings are customizable in Controls settings. Speed & Transpose ----------------- /discjockey speed Adjust playback speed /discjockey transpose Transpose the current song NBS Repair (Clamp / Fold) ------------------------- (Non-destructive, temporary; does not modify the original file.) /discjockey clamp Temporarily repair the specified NBS song /discjockey unclamp Cancel repair /discjockey clampstatus Check the current repair status /discjockey fold auto Enable automatic repair /discjockey fold info Show the repair status of a single song /discjockey fold rebuild Re-run repair (refresh status) /discjockey fold scan Scan all songs for needed repair /discjockey fold status Equivalent to clampstatus Instrument Management --------------------- /discjockey instrument Count nearby note blocks of the specified instrument /discjockey remapInstruments map Create an instrument mapping /discjockey remapInstruments unmap Remove the specified mapping /discjockey remapInstruments show Show the current mapping state /discjockey remapInstruments clear Clear all instrument mappings Utilities --------- /discjockey reload Reload all songs /discjockey spectrum Toggle the in-GUI spectrum display /discjockey sleep Stop playback after a timer / cancel the timer /discjockey help Show help information ================================================================================ Notes ================================================================================ - Only legal .nbs files are supported. - Clamp / Fold is non-destructive and temporary; it takes effect only at runtime and reverts when disabled or canceled. - The GUI includes real-time spectrum visualization (5 styles available). - All keybindings can be customized in Controls settings. - Requires Fabric Loader + Minecraft 26.2; optionally depends on PianoLib / sqlmc PianoAPI for high-quality piano sounds. ================================================================================ Technical ================================================================================ - Uses a two-layer spectrum architecture - SpectrumDataSmoother (peak-hold + exponential decay) and SpectrumVisualizer (unified playback/preview data source) - for stable, non-pegging spectrum rendering. - Playback uses SongPlayer (configurable async playback, RateLimiter-based packet-rate limiting, sleep timer) together with Tuner (multi-layer fallback note-block lookup after octave folding). - Cross-frame safe GUI opening: Main.openScreenOnNextTick defers screen requests to the next tick via a ConcurrentLinkedQueue, avoiding the race where the closing chat screen carries the new GUI away with it. - Obfuscation-friendly: all Screen subclasses, MidiRecorder, and reflection- using classes (PianoPlayer / DiscJockeyHud) are preserved verbatim via ProGuard keep rules to prevent VerifyError. ================================================================================ Copyright ================================================================================ (c) Disc Jockey Plus - Unofficial fork of Disc Jockey. # Disc Jockey Plus #支持的模组加载器 Fabric （>=0.19.5）【稳定分支】 NeoForge (>=26.3.0.52) 【不稳定】 #消息如果你想要最新的更新，可以在B站搜索 SQL_Minecraft 然后关注我！！！ ## Fabric 依赖项目 Fabric Loader >0.19.5 Fabric API >0.157.0 Cloth Congih API >=26.2.155 Mod Menu >=20.0.1 (可选的) PianoLib >=1.0.4+DJP2.7.4 (可选的) ## NeoForge 依赖项目 NeoForge Loader >=26.3.0.52 (警告：千万别用26.3.0.56 （这个版本本身就有问题，会崩溃）) > **为 Minecraft Java 版 26.2-26.3 打造的专业级音符盒音乐播放模组** > 原版 *Disc Jockey* 的非官方分支 · 全版本适配 26.2-26.3 · 内置完整多语言 · 实时频谱可视化 · 88 键钢琴键盘 ## ✨ 简介 **Disc Jockey Plus** 是原版 *Disc Jockey* 的非官方分支，已将模组完整适配至 **Minecraft Java 版 26.2-26.3**，并追加了多项实用功能：内置 88 键钢琴键盘、实时频谱可视化、MIDI 双向转换、NBS 音域修复、音色映射、预览系统、睡眠定时器等，同时内置完整多语言支持。 > 按 **J 键** 或输入 `/discjockey` 即可打开主界面。 --- ## 🎯 核心功能 ### 🎹 88 键钢琴键盘 - 完整覆盖 **A0(−39) ~ C8(48)** 共 88 个半音，零点为 A0，与 PianoLib / NoteBlock 音高一一对应。 - 支持物理键盘映射，**1/2/3 固定映射 A0/A#0/B0**，方便试音与录制。 - **八度移调**：`[−]` / `[+]` 按钮或数字键 `0` 一键回到 C4，`getDisp()` 显示当前八度偏移。 - **三种播放路径自动择优**：优先 PianoAPI→ 回退 PianoLib 88 音缓存→ 最终回退 `NOTE_BLOCK_HARP` 变调，确保主菜单与世界内都能出声。 - **MIDI 录制**：内置 `MidiRecorder`，支持延音踏板、混响、ADSR 包络，录制的 `.mid` 文件自动保存至 `recordings/` 目录。 ###游戏内检查升级使用/discjockey update ### 📊 实时频谱可视化 - 16 段频谱，峰值保持+ 指数衰减，渲染丝滑无重影。 - 提供 **5 种渲染样式**，可在 GUI 内一键切换： `条形 BAR` · `波形 WAVE` · `圆环 RING` · `镜像对称 MIRROR` · `粒子 PARTICLE` - 主菜单与世界内 HUD 常驻显示，播放/预览均驱动频谱跳动。 ### 🎵 NBS 播放与 NBS 修复 - 加载 `.nbs` 歌曲，支持播放 / 暂停 / 停止 / 恢复 / 循环 / 随机 / 自动连播。 - **Clamp / Fold（非破坏性）**：对超出 0~24 音域的 NBS 曲目做运行时八度折叠，不改原文件、不写盘，仅生成 `foldedNotes` 缓存。 - `fold auto` 启用自动修复；`fold scan` 扫描全部曲目；`fold info <曲目>` 查看单首音域报告。 - 移调：运行时对音符做八度折叠移调，避免高音被截断。 ### 🎼 MIDI 双向转换 - **NBS → MIDI 导出**：导出标准 `.mid`，含速度、拍号、小节线标记，输出至 `midi/` 目录并自动打开。 - **MIDI → NBS 导入**：通过内置文件选择器读取 `.mid` / `.midi`，自动解析音符事件并生成 Song，支持空文件 / 解析失败安全兜底。 ### 🎚️ 预览系统 - 主菜单与世界内均可预览曲目。 - **M 键** 预览静音 / 取消静音，**P 键** 开启 / 关闭预览循环（按键绑定可在"控制"设置中自定义）。 - 预览与播放互斥：启动一方自动停止另一方。 ### 🎷 乐器管理 - `instrument <名称>` 统计周围指定乐器的音符盒数量。 - `remapInstruments` 音色映射管理：`map` / `unmap` / `show` / `clear`，把一种乐器映射到另一种（如铜管乐器映射），解决服务器乐器判定差异。 ### ⚡ 速度与音调 - `speed <数值>` 调整播放 / 预览速度（默认 1.0，与预览步进共享）。 - `transpose` 对当前曲目移调（八度折叠，保护 #F24 不被压掉）。 ### 🧰 实用工具 - `reload` 重新加载所有曲目（含热重载监听）。 - `spectrum` 开启 / 关闭 GUI 内频谱显示。 - `sleep <秒数>` 定时停止播放 / 取消定时。 - `now` / `info` / `progress` 查看当前曲目、信息与进度。 - `clampstatus` / `fold status` 检查修复状态，`unclamp` 取消修复。 --- ## 📜 指令大全 ### 🎵 基础播放控制 | 指令 | 说明 | |---|---| | `/discjockey` | 打开 Disc Jockey GUI | | `/discjockey play <曲目>` | 播放指定曲目 | | `/discjockey pause` | 暂停播放 ⏸ | | `/discjockey stop` | 停止播放 | | `/discjockey resume` | 恢复播放 | | `/discjockey now` | 查看当前正在播放的曲目 | | `/discjockey info` | 查看当前曲目信息与播放速度 | | `/discjockey progress` | 查看播放进度 | ###🛡️防反作弊增强了原版Disc Jockey的防反作弊。 ### 🔁 播放模式 | 指令 | 说明 | |---|---| | `/discjockey loop yes\|no` | 开启 / 关闭单曲循环 | | `/discjockey shuffle` | 切换随机播放模式 | | `/discjockey autoplay` | 开启 / 关闭自动连播 | | `/discjockey random` | 随机播放 GUI 列表中的一首曲目 | ### 👂 预览系统 | 指令 | 说明 | |---|---| | `/discjockey preview <曲目>` | 预览指定曲目或查看预览状态 | | **M 键** | 预览静音 / 取消静音 | | **P 键** | 开启 / 关闭预览循环 | > 按键绑定可在"控制"设置中修改。 ### ⚡ 速度与音调 | 指令 | 说明 | |---|---| | `/discjockey speed <数值>` | 调整播放速度 | | `/discjockey transpose` | 对当前曲目进行移调 | ### 🛠️ NBS 修复 > 修复为**临时、非破坏性操作**，不会改动原文件。 | 指令 | 说明 | |---|---| | `/discjockey clamp ` | 对指定 NBS 曲目进行临时修复 | | `/discjockey unclamp` | 取消修复 | | `/discjockey clampstatus` | 检查当前修复状态 | | `/discjockey fold auto` | 启用自动修复 | | `/discjockey fold info ` | 查看单个曲目的修复状态 | | `/discjockey fold rebuild` | 重新执行修复（刷新状态） | | `/discjockey fold scan` | 扫描所有曲目是否需要修复 | | `/discjockey fold status` | 等同于 `clampstatus` | ### 🎹 乐器管理 | 指令 | 说明 | |---|---| | `/discjockey instrument <名称>` | 统计周围指定乐器的音符盒数量 | | `/discjockey remapInstruments map <源> <目标>` | 建立音色映射 | | `/discjockey remapInstruments unmap <源> <目标>` | 移除指定映射 | | `/discjockey remapInstruments show` | 查看当前映射状态 | | `/discjockey remapInstruments clear` | 清空所有音色映射 | ### 🧰 实用工具 | 指令 | 说明 | |---|---| | `/discjockey reload` | 重新加载所有曲目 | | `/discjockey spectrum` | 开启 / 关闭 GUI 内的频谱显示 | | `/discjockey sleep <秒数>` | 定时停止播放 / 取消定时 | | `/discjockey help` | 查看帮助信息 | --- ## 📌 注意事项 - 仅支持带有 **.nbs** 后缀名的合法音乐文件。 - Clamp / Fold 为**非破坏性操作**，仅临时生效，关闭或取消后恢复原状。 - GUI 内自带**实时频谱可视化**（5 种样式可切换）。 - 所有快捷键均支持在"控制"设置中**自定义**。 - 依赖 Fabric Loader + Minecraft 26.2；可选依赖 PianoLib / sqlmc PianoAPI 用于高品质钢琴音色。 ## 🔧 技术说明 - 采用 `SpectrumDataSmoother`（峰值保持 + 指数衰减）与 `SpectrumVisualizer`（统一播放/预览数据源）双层架构，频谱稳定无卡顶。 - 播放采用 `SongPlayer`（可配置异步播放、发包速率限制 `RateLimiter`、睡眠定时器）+ `Tuner`（八度折叠后多层 fallback 查找音符盒）。 - 跨帧安全开界面：`Main.openScreenOnNextTick` 通过 `ConcurrentLinkedQueue` 把界面请求推迟到下一 tick，规避聊天框关闭带走界面的竞争。 - 混淆友好：所有 Screen 子类、`MidiRecorder`、反射类均通过 ProGuard keep 规则原样保留，避免 `VerifyError`。 --- © Disc Jockey Plus — 基于原版 *Disc Jockey* 的非官方分支