Disc Jockey Plus

By
SQL_Minecraft

Upgraded "Disc Jockey" to 26.2, and added some features and language support

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
================================================================================

# 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`。

---

The Disc Jockey Plus Team

2
Projects
574
Downloads

没啥好写的···

Donate

Disc Jockey Plus

###🛡️防反作弊

The Disc Jockey Plus Team

More from SQL_Minecraft

PianoLib

PianoLib