?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Disc Jockey Plus

Disc Jockey Plus

Original mod is Disc Jockey. This project just upgraded it and added some features. 原作品为 Disc Jockey,此项目只是对它进行了升级，加装了一些功能。 仅此而已

414downloads
2followers
414downloads
2followers

Compatibility

Minecraft: Java Edition

26.2

Platforms

Supported environments

Client-side

Tags

Creators

Details

Licensed ARR
Published last month
Updated 4 days ago

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.2+DJP2.7.2 (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 <song> 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 <name> 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 <value> 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 <seconds> 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 <song>           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 <song>        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 <value>         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 <name>                    Count nearby note blocks of the specified instrument   /discjockey remapInstruments map <src> <dst>    Create an instrument mapping   /discjockey remapInstruments unmap <src> <dst>  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 <seconds>       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.2+DJP2.7.2  (可选的)

为 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 取消修复。

📜 指令大全

🎵 基础播放控制

指令 说明
/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 <xxx.nbs> 对指定 NBS 曲目进行临时修复
/discjockey unclamp 取消修复
/discjockey clampstatus 检查当前修复状态
/discjockey fold auto 启用自动修复
/discjockey fold info <xxx.nbs> 查看单个曲目的修复状态
/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 的非官方分支