Disc Jockey Plus

Minecraft 版本： 26.2

平台： fabric

标签： game-mechanics

Disc Jockey Plus

A professional note-block music mod for Minecraft Java 26.2
Unofficial fork of the original Disc Jockey - Fully ported to 26.2 -
Built-in full localization - Real-time spectrum visualization - 88-key piano keyboard

Dependent Mods

• Fabric Loader >= 0.19.2
• Fabric API >= 0.157.0
• Cloth Config API >= 26.2.155
• Mod Menu >= 20.0.1 (optional)
• PianoLib >= 1.0.3+DJP2.7.3 (optional)

================================================================================
Introduction

Disc Jockey Plus is an unofficial fork of the original Disc Jockey, fully ported
to Minecraft Java 26.2. 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

================================================================================
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 <xxx.nbs>       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 <xxx.nbs>   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 Loader >0.19.2
Fabric API >0.157.0
Cloth Congih API >=26.2.155
Mod Menu >=20.0.1  (可选的)
PianoLib >=1.0.3+DJP2.7.3  (可选的)

为 Minecraft Java 版 26.2 打造的专业级音符盒音乐播放模组
原版 Disc Jockey 的非官方分支 · 全版本适配 26.2 · 内置完整多语言 · 实时频谱可视化 · 88 键钢琴键盘

✨ 简介

Disc Jockey Plus 是原版 Disc Jockey 的非官方分支，已将模组完整适配至 Minecraft Java 版 26.2，并追加了多项实用功能：内置 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 取消修复。

📜 指令大全

🎵 基础播放控制

🛡️防反作弊

增强了原版Disc Jockey的防反作弊。

🔁 播放模式

👂 预览系统

按键绑定可在"控制"设置中修改。

⚡ 速度与音调

🛠️ NBS 修复

修复为临时、非破坏性操作，不会改动原文件。

🎹 乐器管理

🧰 实用工具

📌 注意事项

• 仅支持带有 .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 的非官方分支