Cobblemon Diamond DJ

Cobblemon Diamond DJ

全服务器同步播放音乐，并支持 Cobblemon 对战音乐！

Cobblemon Diamond DJ 是一款 Fabric 模组，可向所有已连接的玩家广播 OGG 音乐文件。所有人都会在同一时间听到同一首歌，带来共享电台般的体验。Cobblemon 对战开始时，会播放具有空间音效的对战音乐，并平滑切换。

正在从旧版本更新？
请删除旧的配置文件（config/cobblemon-diamond-dj-server.json 和 config/cobblemon-diamond-dj-hud.json），让模组使用最新的默认设置重新生成配置。每次更新都会添加新字段，过时的配置可能导致意外行为。

第一次使用？
安装后，请花点时间阅读config/cobblemon-diamond-dj-server.json——其中包含所有选项，默认设置也很合理；你还可以自定义许多内容（对战音乐、流媒体、投票跳过、自动开始等）。

DJ 播放列表系统

• 同步播放——所有玩家听到的歌曲进度完全一致
• 自动下载——客户端会自动从服务器下载并缓存歌曲
• 独立音量控制——Cobblemon Diamond DJ 使用唱片机／唱片音量滑块，因此玩家可以调低服务器 DJ 音乐的音量，同时将Minecraft 原版音乐保持在自己喜欢的音量
• 投票跳过——玩家可以通过投票跳过歌曲
• 投票开关——服务器可以启用或禁用玩家投票
• 可自定义 HUD——可选择简洁、详细或自定义小组件布局
• 无需外部服务——完全通过本地 OGG 文件或资源包运行
• 流媒体模式——支持播放 YouTube、SoundCloud、Bandcamp 和 Vimeo 链接
• 安全可靠——可防范恶意服务器（路径遍历、文件验证、域名白名单）

Cobblemon 对战音乐

• 空间音效——越靠近对战地点，对战音乐就越响
• 自动触发——任何 Cobblemon 对战开始时都会播放对战音乐
• 交叉淡化切换——DJ 音乐与对战音乐之间可平滑交叉淡化
• 按范围播放——配置半径内附近的非参战玩家也能听到对战音乐
• 死亡感知——玩家死亡时立即停止对战音乐，并在重生后恢复全局音乐

资源包支持

• 从服务端资源包的 resourcepacks/ 文件夹加载音乐
• 兼容现有的第三方音乐包
• 资源包中的任何 .ogg 文件都会加入 DJ 播放列表
• 位于 battle/ 文件夹中的文件会加入对战音乐库
• 三种模式："local"（仅使用配置文件夹）、"resourcepack"（仅使用资源包）或 "both"

命令

所有玩家：

• /dj skip – 投票跳过当前歌曲
• /dj nowplaying – 查看当前歌曲信息

管理员：

• /dj start – 开始播放
• /dj stop – 停止播放
• /dj forceskip – 无需投票，直接跳过
• /dj reload – 重新加载歌曲库和资源包
• /dj list – 列出所有歌曲
• /dj status – 查看服务器状态
• /dj clearcache – 清除所有在线玩家的客户端缓存
• /dj clearcacheplayer <player> – 清除指定玩家的客户端缓存

流媒体模式（管理员）：

• /dj play <url> – 立即播放链接
• /dj queue <url> – 将链接添加到队列
• /dj addplaylist <url> – 添加播放列表链接（YouTube／SoundCloud）
• /dj clearqueue – 清空流媒体队列

选项 1：本地文件（默认）

1. 在服务器和所有客户端上安装该模组
2. 将 .ogg 文件添加到：config/cobblemon-diamond-dj/songs/
3. 将战斗音乐添加到：config/cobblemon-diamond-dj/battle/
4. 在游戏中运行 /dj start

选项 2：资源包

1. 将音乐资源包（.zip）放入服务器的 resourcepacks/ 文件夹
2. 在 config/cobblemon-diamond-dj-server.json 中设置 "musicSource": "resourcepack"
3. 在游戏中运行 /dj start

选项 3：两者兼用

1. 将本地文件添加到配置文件夹，并将资源包放入 resourcepacks/
2. 在配置中设置 "musicSource": "both"
3. 歌曲名称冲突时，优先使用本地文件

选项 4：流媒体

1. 在 config/cobblemon-diamond-dj-server.json 中设置 "playbackMode": "streaming"
2. 将 URL（每行一个）添加到 config/cobblemon-diamond-dj/streaming_playlist.txt
3. 可选：配置 YouTube 身份验证（youtubePoToken、youtubeOAuthRefreshToken），以播放有年龄限制的内容
4. 运行 /dj start，或使用 /dj play <url> 按需播放流媒体

配置

编辑 config/cobblemon-diamond-dj-server.json：

{
  "voteThresholdPercent": 50,
  "voteTimeoutSeconds": 30,
  "voteEnabled": true,
  "battleMusicEnabled": true,
  "battleMusicRadius": 48,
  "battleBleedEnabled": true,
  "clearCacheOnDisconnect": true,
  "musicSource": "local",
  "autoStartEnabled": true,
  "playbackMode": "local",
  "streamingPlaylistFile": "streaming_playlist.txt",
  "battleMusicDisabledInStreaming": false
}

• voteThresholdPercent – 跳过歌曲所需的玩家百分比
• voteTimeoutSeconds – 投票过期前的等待时间
• battleMusicEnabled – 启用/禁用 Cobblemon 战斗音乐
• battleMusicRadius – 战斗音乐可被听到的距离（方块）
• battleBleedEnabled – 是否允许战斗音乐跨维度传播
• clearCacheOnDisconnect – 断开连接时清除客户端缓存
• musicSource – 音乐来源："local"、"resourcepack" 或 "both"
• autoStartEnabled – 服务器启动时自动播放 DJ 歌单
• playbackMode – 播放模式："local"（OGG 文件）或 "streaming"（URL）
• streamingPlaylistFile – URL 歌单的文件名（每行一个 URL）
• battleMusicDisabledInStreaming – 流媒体模式下禁用战斗音乐

客户端 HUD

编辑 config/cobblemon-diamond-dj-hud.json：

{
  "enabled": true,
  "preset": "SUPER_MINIMAL",
  "anchor": "TOP_LEFT",
  "scale": 1.0
}

预设： SUPER_MINIMAL（默认——仅显示进度条）、MINIMAL、VERBOSE、NONE、CUSTOM

支持的流媒体服务

• YouTube（包括 YouTube Music 和播放列表）
• SoundCloud
• Bandcamp
• Vimeo

出于安全考虑，所有 URL 都会在服务器和客户端通过内置域名白名单进行验证。注意：请只从 CurseForge 下载此模组。我以后可能会改变主意，但目前不会。

依赖

• Minecraft 1.21.1
• Fabric Loader 0.18.4+
• Fabric API
• Fabric Language Kotlin
• Cobblemon（适用于 1.21.1 的任意版本）

音频格式

• 格式：仅支持 OGG Vorbis
• 立体声或单声道：两者均可（立体声会自动混合为单声道，用于战斗空间音频）