## JukeBoxPlus

## JukeBoxPlus

🎵 《我的世界》的Spotify风格音乐叠加层！通过精美的HUD查看当前播放内容 - 唱片名称、艺术家、进度条和历史记录。再也不用纠结"这是什么歌？"了！

游戏机制

## JukeBoxPlus预览查看大图

JukeBoxPlus

那首曲子正在播放，而你却不知道它是什么

每次游玩都会遇到这种情况。你正在建造、探索、挖矿——然后Minecraft的音乐响了起来。那段钢琴曲。那段环境音。那首十年来你听过上千次却始终叫不出名字的曲子。

你打开选项菜单。你看看唱片机。你试图从音符粒子中辨认出来。毫无头绪。曲子结束了，你依然不知道刚才放的是什么。

JukeBoxPlus用一个简洁、带有动画的覆盖层解决了这个问题，它会随时告诉你当前播放的是什么。曲名、艺术家、时长、进度条、播放控制。还有一个完整的音乐库供你浏览和搜索。把它想象成你手机上的"正在播放"组件，只不过它活在Minecraft里面。

一个按键，仅此而已。按下H键，一切尽在眼前。

按下H键后你会看到什么

正在播放栏

在屏幕顶部（或你设置的任何位置——完全可配置），一个纤细的HUD栏会显示：

  • 曲名，以清晰的文字呈现
  • 艺术家/来源（C418、Lena Raine、唱片名称、生物群系等）
  • 实时移动的进度条
  • 已过时间/剩余时间
  • 播放/暂停指示器

启用后，这个栏会始终可见。你只需瞥一眼，就知道正在播放什么。无需菜单。无需指令。不会打断你正在做的事情。

覆盖层会随你的GUI缩放比例调整。不会与聊天框重叠。不会遮挡你的快捷栏。它有自己的专属空间。

完整音乐播放器GUI

按下H键（默认按键，可重新绑定），一个完整的音乐播放器界面就会打开。这是JukeBoxPlus从"好用的覆盖层"升级为"真正的音乐播放器"的地方。

布局模仿真实音乐应用：

  • 大尺寸专辑封面展示，显示音乐唱片纹理（或环境/生物群系音乐的类别图标）
  • 曲名和艺术家，以醒目文字呈现
  • 完整播放控制：播放、暂停、下一首、上一首、随机播放、单曲循环/全部循环
  • 音量滑块——无需打开选项菜单，直接在此调整Minecraft音乐音量
  • 进度条，支持拖拽跳转（跳到曲子的任意位置）
  • 顶部分类选项卡，可按音乐类型筛选

分类：

  • 唱片 — 全部13+种音乐唱片（Cat、Blocks、Chirp、Far、Mall、Mellohi、Stal、Strad、Ward、11、13、Pigstep、Otherside、5、Relic、Creator）
  • 环境 — 探索时随机播放的主世界环境/背景音乐
  • 下界 — 所有下界生物群系音乐曲目
  • 末地 — 末地维度音乐
  • 创造模式 — 创造模式音乐
  • 其他 — 菜单音乐、鸣谢音乐，以及其他不属上述分类的音乐

点击分类选项卡，音乐库会立即筛选。滚动列表。点击任意曲目即可立即播放。

随机播放与循环：

  • 随机播放：将当前分类中的曲目顺序打乱
  • 单曲循环：循环当前曲目
  • 全部循环：循环整个分类
  • 不循环：列表播放一次后停止

这些控制功能的工作方式与你从任何音乐应用中期望的完全一致。没有意外。没有奇怪的Minecraft特定逻辑。标准的播放行为。

音乐库浏览器

在播放控制下方，一个可滚动的列表会显示所选分类中的每一首曲目。每条条目显示：

  • 曲名
  • 艺术家
  • 时长
  • 播放指示器（曲目播放时显示动画条）

点击即可播放。就是这么简单。列表支持搜索——输入文字即可按曲名筛选。当你有几十首曲目并想快速找到某一首时非常有用。

音乐库会动态更新。如果某个模组向游戏添加了新的音乐（比如音乐唱片模组或生物群系音乐扩展），JukeBoxPlus会自动检测并将其添加到音乐库中。

这适合谁？

真正聆听Minecraft音乐的玩家 Minecraft拥有令人惊叹的音乐。C418的作品是标志性的。Lena Raine的添加入耳动听。但大多数玩家不知道这些曲子叫什么，也不知道是谁创作的。JukeBoxPlus提供了这些背景信息。你听到一首歌，看到它的名字，之后可以查询它，添加到你的真实播放列表，等等。

边建造边听音乐的玩家 如果你一边建造一边播放Minecraft的原声带——很多建造者都这样做，因为它确实是完美的背景音乐——JukeBoxPlus让你在不打断工作流程的情况下控制播放内容。跳过不符合氛围的曲子。循环播放合适的曲子。所有操作都在覆盖层上完成。

内容创作者/主播 观众总会在聊天里问"那是什么歌？"。有了屏幕上可见的"正在播放"覆盖层，你再也不用回答这个问题了。曲名就摆在那里。有些主播会把它作为一个永久性的屏幕元素。

使用音乐模组的玩家 正在使用添加新音乐唱片的模组？或者为生物群系添加环境音乐的模组？JukeBoxPlus会自动识别这些曲目。只要它通过Minecraft的音频系统播放，就会出现在音乐库中。

完美主义者 想听遍Minecraft的所有曲子？音乐库会显示所有可用的内容。按分类浏览，逐一播放。发现你从未听过的曲子——有些环境音乐只在特定条件下播放，大多数玩家完全错过了。

功能——完整列表

正在播放覆盖层

  • 显示当前曲目信息的持久化HUD
  • 显示曲名、艺术家和来源
  • 实时进度条
  • 已过时间和剩余时间
  • 播放/暂停状态指示器
  • 完全可定位（顶部、底部、角落——可配置）
  • 随GUI缩放比例调整
  • 可独立于音乐播放器GUI开关
  • 不与聊天框、快捷栏或动作栏重叠

音乐播放器GUI

  • 带动画的现代界面
  • 大尺寸唱片封面/分类图标展示
  • 完整的曲目元数据（标题、艺术家、时长）
  • 播放/暂停按钮
  • 下一首/上一首按钮
  • 随机播放开关，带视觉指示器
  • 循环模式：关闭、单曲循环、全部循环
  • 音量滑块（独立于选项菜单）
  • 可拖拽跳转的进度条
  • 分类选项卡筛选
  • 可搜索的音乐库
  • 可滚动的曲目列表，带播放指示器
  • 平滑的打开/关闭动画
  • 常用操作的键盘快捷键

播放控制

  • 按需播放任意分类中的任意曲目
  • 暂停和继续，不丢失播放位置
  • 在当前分类中跳到下一首/上一首曲目
  • 随机播放某个分类
  • 循环播放单首曲目或整个分类
  • 一首曲目结束后自动播放下一首（当循环关闭时）

音乐检测

  • 自动检测游戏中所有音乐
  • 适用于原版Minecraft音乐（所有分类）
  • 适用于模组添加的音乐（自定义唱片、生物群系音乐包等）
  • 模组变更时动态更新音乐库
  • 按音乐来源分类（唱片、环境、维度）

自定义

  • 可重新绑定的按键（默认：H）
  • 可配置覆盖层位置
  • 可配置覆盖层透明度
  • 可配置覆盖层缩放
  • 可独立于GUI开关覆盖层
  • 按钮点击音效反馈（可开关）
  • GUI主题选项（如果有——请检查配置）

控制

动作 默认按键 备注
打开音乐播放器 H 可在控制菜单中重新绑定
播放/暂停 GUI内按钮 GUI打开时也可按空格键
下一首 GUI内按钮 也可按右箭头键
上一首 GUI内按钮 也可按左箭头键
切换随机播放 GUI内按钮 视觉指示器显示状态
切换循环 GUI内按钮 循环：关闭 → 单曲 → 全部
音量增大/减小 GUI内滑块 拖拽或使用滚轮
搜索音乐库 GUI内文本输入框 输入文字筛选，按Escape清除
关闭GUI Escape 标准Minecraft行为

所有按键均可通过Minecraft控制菜单中JukeBoxPlus类别重新绑定。

安装

三步，一分钟内完成。

  1. 安装 Fabric Loader，用于Minecraft 1.21.4 → fabricmc.net/use/installer

  2. 安装 Fabric API → modrinth.com/mod/fabric-api → 将其放入你的 /mods/ 文件夹

  3. 从本页面下载 JukeBoxPlus.jar → 将其放入你的 /mods/ 文件夹

  4. 使用Fabric配置文件启动Minecraft

  5. 按 H 键打开音乐播放器

就是这样。无需配置。无需安装服务器。无需资源包。安装后即可立即使用。

需求

  • Minecraft Java版 1.21.4
  • Fabric Loader
  • Fabric API

仅此而已。 没有其他依赖。没有库模组。没有数据库。首次使用前无需编辑任何配置文件。

需要服务器吗？ 不需要。JukeBoxPlus是100%客户端侧的。它读取你客户端的Minecraft内部音频状态。服务器无需知道它的存在。可在单人游戏、多人游戏、领域、任何服务器类型上运行。

性能影响： 可忽略不计。该模组监听Minecraft现有的音频事件并渲染一个小的GUI覆盖层。没有后台处理。没有滴答循环。没有值得一提的内存开销。如果你能运行Minecraft，你就能运行JukeBoxPlus。

兼容性

兼容：

  • 所有原版Minecraft音乐（每张唱片、每首环境曲目、每个维度音乐）
  • 通过Minecraft音频系统添加曲目的音乐模组
  • 替换音乐文件的资源包（曲名会相应更新）
  • 光影（覆盖层渲染在所有内容之上）
  • 小地图模组、背包模组、任何其他客户端侧模组
  • Sodium / Iris / OptiFine（无渲染冲突）
  • 任何类型的多人游戏服务器（原版、Paper、模组——无所谓，它是客户端侧的）

不兼容：

  • Minecraft基岩版（仅Java版）
  • Forge（仅Fabric——可能会根据需求稍后推出Forge移植版）

常见问题

这个模组能播放外部音乐/Spotify/YouTube吗？ 不能。JukeBoxPlus是为Minecraft自己的音乐设计的播放器和覆盖层。它向你展示游戏中正在播放的内容，并允许你控制播放。它不会流式播放外部音频。把它想象成你游戏中已有原声带的"正在播放"组件和音乐库。

服务器需要安装什么东西吗？ 不需要。100%客户端侧。该模组从你自己的游戏客户端读取音频事件。它不发送数据包。它不修改服务器行为。它完全不与服务器交互。

为什么我不能播放某个特定的唱片？我点击了它，但什么也没发生。 JukeBoxPlus通过Minecraft的内部音乐系统控制游戏播放的内容。音乐唱片特别需要一个世界中的唱片机——该模组直接控制环境、生物群系和维度音乐。唱片曲目会出现在音乐库中供浏览和查看信息。请查看模组的GitHub页面获取最新的播放范围。

这个模组会显示模组添加的音乐吗？ 会，如果音乐是通过Minecraft的标准音频系统添加的。通过SoundEvent系统注册音乐的模组会自动出现在音乐库中。通过自定义方法（外部音频注入等）播放音频的模组不会被检测到。

我可以把覆盖层移到屏幕上的不同位置吗？ 可以。覆盖层位置可在模组设置中配置。你可以将其放置在屏幕的顶部、底部、左侧、右侧或角落。透明度和缩放比例也可调整。

它会与其他HUD模组冲突吗？ 大多数情况下不会。覆盖层位于其自己的可配置区域。如果你使用一个将HUD元素放在相同位置的模组，你可以移动JukeBoxPlus的覆盖层以避免重叠。尚未收到与常见HUD模组进行渲染冲突的报告。

我可以在整合包中使用这个模组吗？ 可以。模组包使用无限制。

曲名看起来不对/只有英文。 曲名会从Minecraft的内部本地化系统中获取（如果可用），否则会回退到英文显示名。如果你使用重命名曲目的资源包，该模组可能会显示原始名称。这已在改进计划中。

你会添加Forge支持吗？ 有可能，如果有足够的需求的话。如果你想要Forge支持，请留下评论或在GitHub上开启一个议题。要求的人越多，它的优先级就越高。

我想看到更大的专辑封面/唱片纹理。 GUI会在主显示区域显示音乐唱片纹理（针对唱片曲目）或分类图标（针对环境音乐）。当前版本中大小是固定的。可自定义的艺术品显示大小已在计划中。

为什么会存在这个模组

我从2013年开始玩Minecraft。我知道这些音乐很特别——C418的作品确实是游戏史上最优秀的音乐之一。但多年来我完全不知道这些曲子的名字。我会在建造时听到一些美妙的东西，想在Spotify或YouTube上找到它，但做不到，因为我不知道名字。

我启动这个项目时只是一个简单的"显示曲名"覆盖层。然后我添加了一个进度条，因为不知道一首曲子还剩多长时间很烦人。接着是播放控制，因为一旦你知道在放什么，你就想跳过那些不符合氛围的曲子。然后是一个完整的音乐库浏览器，因为何乐而不为呢——数据都在那里。

最终的结果是，让Minecraft的原声带感觉像是一种真正的音乐体验，而不是你无法互动的背景噪音。这些音乐值得这样的待遇。它一直值得。

按下H键。看看正在播放什么。也许你会发现一首你听过几百次却从不知道名字的曲子。

开发路线图

  • 自定义覆盖层主题/配色方案
  • 播放列表创建（保存自定义曲目列表）
  • 音乐统计（播放次数最多的曲目、聆听时间）
  • Forge移植版（如果有需求）
  • 新曲目开始播放时的通知弹出（类似手机通知）
  • 与ReplayMod时间线的集成
  • 可自定义的曲目封面大小

功能在可用时发布。没有具体时间表。GitHub议题驱动发展路线。

支持

  • Bug报告：GitHub议题 或 Discord，附上你的Fabric版本、模组版本和问题描述
  • 功能请求：GitHub议题 或 Discord——如果足够多人想要，就会实现
  • 评价：如果JukeBoxPlus让你更欣赏Minecraft的音乐，请在这里留下评价。这是其他玩家发现这个模组的首要方式。
  • 源代码：GitHub链接——欢迎贡献

由一位终于想知道夜晚建造时播放的那首钢琴曲叫什么名字的人制作。