JukeBoxPlus

模组

· 作者 maxlananass

JukeBoxPlus 为 Minecraft 添加了一个类似 Spotify 的音乐覆盖界面。显示每张唱片、环境音轨和生物群系音乐的曲目名称、艺术家和进度条。完整的播放控制——播放、暂停、跳过、随机播放、重复、音量调节。客户端侧 Fabric 模组,无需服务器

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 3.7.0+mc1.21.11 · 1.21.11 · Fabric

一键开服(送7天)

JukeBoxPlus

那首歌正在播放,而你却不知道它是什么

非常感谢 Elfi 为本项目提供图标!

这在每次游戏会话中都会发生。你正在建造、探索或下矿——此时 Minecraft 的音乐响起了。那段钢琴曲。那段环境音效。那段你在过去十年里听过无数遍却永远叫不出名字的曲目。

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

JukeBoxPlus 通过一个简洁的动画覆盖层解决了这个问题,随时告诉你当前正在播放的内容。曲目名称、艺术家、时长、进度条、播放控制。一个你可以浏览和搜索的完整音乐库。把它想象成你手机上的“正在播放”小部件,只不过它存在于 Minecraft 之中。

只需一个快捷键。一切就绪。按下 H 键,所有信息便呈现在眼前。


按下 H 键后你会看到什么

正在播放栏

在顶部(或者你可以将其放置在任何位置——完全可配置),一个细长的 HUD 栏显示:

  • 清晰的曲目名称文本
  • 艺术家/来源(C418、Lena Raine、唱片名称、生物群系等)
  • 实时移动的动态进度条
  • 已用时间 / 剩余时间
  • 播放/暂停指示器

启用时,此栏始终可见。抬头一瞥,你就知道正在播放什么。无需菜单。无需指令。不会打断你当前的操作。

该覆盖层会根据你的 GUI 缩放设置进行缩放。它不会与聊天窗口重叠。也不会遮挡你的快捷栏。它会安放在自己的空间内。

完整音乐播放器界面

按下 H 键(默认快捷键,可重新绑定),即可打开完整的音乐播放器界面。这是 JukeBoxPlus 从“不错的覆盖层”转变为“真正的音乐播放器”的地方。

布局模仿真实音乐应用:

  • 大型专辑艺术展示区,显示音乐唱片纹理(或环境/生物群系音乐的分类图标)
  • 醒目的曲目标题和艺术家文本
  • 完整的播放控制:播放、暂停、快进、快退、随机播放、重复(单曲循环 / 全部循环)
  • 音量滑块 —— 无需打开选项菜单即可在此调整 Minecraft 的音乐音量
  • 支持拖拽跳转的进度条(跳转到曲目的任意位置)
  • 顶部的分类标签,可按音乐类型筛选

分类:

  • 唱片 (Discs) —— 所有 13+ 种音乐唱片(Cat、Blocks、Chirp、Far、Mall、Mellohi、Stal、Strad、Ward、11、13、Pigstep、Otherside、5、Relic、Creator)
  • 环境音 (Ambient) —— 在你探索时随机播放的主世界环境/背景音乐
  • 下界 (Nether) —— 所有下界生物群系音乐曲目
  • 末地 (End) —— 末地维度音乐
  • 创造模式 (Creative) —— 创造模式音乐
  • 其他 (Other) —— 菜单音乐、制作人员表音乐、以及不属于上述类别的任何音乐

点击分类标签,图书馆会立即进行筛选。滚动列表。点击任何曲目即可立即播放。

随机播放与重复:

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

这些控制按钮的行为与你从任何音乐应用中预期的完全一致。没有意外。没有奇怪的 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. 为 Minecraft 1.21.4 安装 Fabric Loader → fabricmc.net/use/installer

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

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

  4. 使用 Fabric 配置启动 Minecraft

  5. 按 H 打开音乐播放器

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


要求

  • Minecraft Java Edition 1.21.4
  • Fabric Loader
  • Fabric API

就是这样。 没有其他依赖项。没有库模组。没有数据库。首次使用前无需编辑任何配置文件。

需要服务器吗? 不需要。JukeBoxPlus 是 100% 客户端模组。它读取你客户端上 Minecraft 的内部音频状态。服务器不需要知道它的存在。适用于单人游戏、多人游戏、Realms、任何类型的服务器。

性能影响: 微乎其微。该模组监听 Minecraft 现有的音频事件并渲染一个小 GUI 覆盖层。无后台处理。无 Tick 循环。无可提及的内存开销。如果你能运行 Minecraft,你就能运行 JukeBoxPlus。


兼容性

兼容:

  • 所有原版 Minecraft 音乐(每张唱片、每种环境音轨、每种维度音乐)
  • 通过 Minecraft 音频系统添加曲目的音乐模组
  • 替换音乐文件的资源包(曲目名称会相应更新)
  • 光影(覆盖层渲染在所有元素之上)
  • 小地图模组、物品栏模组、任何其他客户端模组
  • Sodium / Iris / OptiFine(无渲染冲突)
  • 任何类型的多人服务器(原版、Paper、模组服务器——无所谓,它是客户端模组)

不兼容:

  • Minecraft Bedrock Edition(仅限 Java)
  • Forge(仅限 Fabric —— 根据需求可能会有 Forge 移植版)

常见问题

这会播放外部音乐/Spotify/YouTube 吗? 不会。JukeBoxPlus 是用于 Minecraft 自身音乐的播放器和覆盖层。它向你展示游戏中正在播放的内容并允许你控制播放。它不流式传输外部音频。把它想象成游戏内置配乐的一个“当前播放”小部件和音乐库。

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

为什么我不能播放特定的唱片?我点击了但它没反应。 JukeBoxPlus 通过 Minecraft 内部音乐系统控制游戏播放。音乐唱片特别需要在世界中使用唱片机——该模组直接控制环境音、生物群系音乐和维度音乐。唱片曲目出现在库中仅用于浏览和信息查询。请查看模组的 GitHub 以获取最新的播放范围说明。

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

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

它会与其他 HUD 模组冲突吗? 在大多数情况下不会。覆盖层位于其自己的可配置区域。如果你使用的模组将 HUD 元素放在相同的位置,你可以移动 JukeBoxPlus 的覆盖层以避免重叠。据报道,与常见的 HUD 模组没有渲染冲突。

我可以在整合包中使用这个吗? 可以。对整合包包含没有限制。

曲目名称看起来不对 / 仅显示英文。 如果可用,曲目名称会从 Minecraft 的内部本地化系统中提取,否则回退到英文显示名称。如果您使用了重命名曲目的资源包,模组可能会显示原始名称。改进此问题已在开发计划中。

你会添加对 Forge 的支持吗? 如果有足够多的需求,有可能。如果您希望支持 Forge,请留下评论或提交 GitHub Issue。询问的人越多,它的优先级就越高。

我想让专辑封面 / 唱片纹理更大一些。 主显示区域会显示音乐唱片纹理(针对唱片曲目)或分类图标(针对环境音乐)。当前版本中大小是固定的。自定义艺术展示尺寸已在开发计划中。


为什么会有这个模组

我从 2013 年就开始玩 Minecraft。我知道这里的音乐很特别——C418 的作品确实是史上最好的游戏音乐之一。但多年来,我一直不知道任何一首曲子的名字。当我在建造时听到美妙的旋律,想要去 Spotify 或 YouTube 上找到它,却因为我不知道名字而找不到。

我开始这个项目只是为了简单地“显示曲目名称”的覆盖层。然后我添加了进度条,因为不知道一首曲子还有多久结束很让人烦恼。接着是播放控制,因为一旦你知道正在播放什么,你就想跳过那些不符合心情的曲目。然后是完整的库浏览器,既然数据都在那里,为什么不呢?

结果就是,它让 Minecraft 的原声带感觉像是一个真正的音乐体验,而不是你无法互动的背景噪音。音乐值得拥有这些。它一直都值得。

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


开发计划

  • 自定义覆盖层主题 / 配色方案
  • 播放列表创建(保存自定义曲目列表)
  • 音乐统计信息(最常播放的曲目、收听时间)
  • Forge 移植版(如果有需求的话)
  • 新曲目开始时弹出通知(类似手机通知)
  • 与 ReplayMod 时间线集成
  • 可自定义的曲目艺术展示覆盖层大小

功能只有在完善后才会发布。没有预计发布时间。GitHub Issues 驱动着开发计划。


支持

  • 错误报告: GitHub Issues 或在 Discord 上反馈,请提供你的 Fabric 版本、模组版本以及问题描述
  • 功能请求: GitHub Issues 或在 Discord —— 如果足够多人想要某个功能,它就会实现
  • 评价: 如果 JukeBoxPlus 让你更加欣赏 Minecraft 的音乐,请在这里留下评价。这是其他玩家发现此模组的首要方式。
  • 源代码: GitHub 链接 —— 欢迎贡献

由一个终于想知道夜晚建造时播放的那首钢琴曲名字的人构建。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源