声波脉冲

声波脉冲

面向Minecraft的专业高保真音乐播放器与响应式可视化工具。可从任意来源流式播放,配备随节拍律动的高级可定制HUD。

游戏机制

SonicPulse

一个专业的 Minecraft Fabric 音频流媒体与反应式可视化模组,支持 Minecraft 26.3("Wilderness Bound") 和 1.21.4。

从 YouTube、SoundCloud、Bandcamp、Vimeo、网络电台和本地文件流式播放音乐——全部在 Minecraft 内完成,并配有随节拍脉动的炫酷反应式 HUD 缎带。


✨ 功能特性

🎵 音频流媒体

  • YouTube 播放 – 粘贴任意 YouTube 链接,立即开始播放
  • SoundCloud / Bandcamp / Vimeo – 支持所有主流平台的直接 URL 流式播放
  • 网络电台(M3U) – 加载并保存 M3U 流媒体播放列表,内置 BBC 预设
  • 本地文件播放 – 浏览并流式播放你电脑上的 .mp3、.flac 和 .wav 文件
  • 收藏与历史 – 一键保存、重命名、重新排序并重播你的曲目

🌊 反应式可视化 HUD

  • 实时均衡器柱状图 – 直接渲染在 HUD 缎带上的动画 FFT 频谱柱
  • 多种视觉风格 – 方块、线条、波形、镜像、峰值、圆点等
  • 背景特效 – 脉冲闪光、光环渐变漂移、VHS 故障、热力图和星空
  • 音频反应式皮肤 – HUD 边框和背景随音乐动态变化
  • 颜色主题 – 20+ 精选调色板颜色,用于柱状图、标题文字和强调元素
  • SonicPulse 徽标 – 动画文字徽标,支持逐色自定义

🎧 DSP 音频引擎

  • 低音与高音均衡器 – 针对特定频段的增益滑块(–100% 到 +100%)
  • 立体声扩展 – 从单声道(0%)到超宽(200%)的声场扩展
  • 水下自动闷音 – 潜入水中时自动启用低通滤波器
  • 流缓冲 – 可配置的预加载缓冲(0–15 秒),防止慢速连接下卡顿
  • 缓冲进度条 – HUD 底部的实时加载指示器

⚙️ 播放控制

  • 配置界面内的传输控制 – 直接在配置界面中提供 ⏮ 上一首、▶/⏸ 播放/暂停、⏹ 停止、⏭ 下一首
  • 快速播放快捷键 – 一键 播放收藏 和 播放本地 标题按钮
  • 会话模式 – 按会话跟踪远程、电台、收藏、历史和本地模式

🎮 默认按键绑定

按键 操作 备注
P 打开配置界面 打开完整的 SonicPulse 控制面板
ESC 关闭配置界面 未聚焦文本框时的标准关闭方式

提示: 配置按键可在 选项 ➔ 控制 ➔ 按键绑定 的 SonicPulse 分类下完全重新映射。


📦 安装与兼容性

选择与你的 Minecraft 版本匹配的发布文件:

适用于 Minecraft 26.3(v1.1.0)

  • Minecraft: 26.3
  • Fabric Loader: >= 0.19.5
  • Fabric API: >= 0.161.0+26.3
  • Java: 25 LTS

适用于 Minecraft 1.21.4(v1.0.0)

  • Minecraft: 1.21.4
  • Fabric Loader: >= 0.16.9
  • Fabric API: 0.119.4+1.21.4
  • Java: 21

步骤

  1. 为你的 Minecraft 版本安装 Fabric Loader。
  2. 下载 Fabric API 并将其放入你的 .minecraft/mods 文件夹。
  3. 下载匹配的 SonicPulse 版本(26.3 用 SonicPulse-1.1.0.jar,1.21.4 用 SonicPulse-1.0.0.jar)。
  4. 将 .jar 文件放入你的 .minecraft/mods 文件夹。
  5. 使用 Fabric 配置文件启动 Minecraft。
  6. 在游戏中按 P 打开 SonicPulse 配置界面并开始流式播放!

注意: SonicPulse 自带音频引擎(LavaPlayer)——无需外部服务器或配套应用。


⚙️ 配置

在游戏中按 P 打开完整配置界面。九个专用标签页让所有设置触手可及:

标签页 内容
📡 REMOTE(远程) 粘贴 YouTube / SoundCloud / 直接 URL,最近的流媒体快捷方式
🎨 VISUAL(视觉) HUD 可见性、皮肤、徽标、曲目名称、EQ 柱状图风格、背景特效、颜色
📐 LAYOUT(布局) 元素顺序(徽标 / 曲目 / 柱状图顺序)、HUD 缩放、HUD 宽度
🕒 HIST(历史) 重播或删除最近流式播放的曲目
★ FAVS(收藏) 管理已保存的收藏——重新排序、重命名和快速播放
📻 RADIO(电台) M3U 网络电台,含 BBC 预设和 4 个自定义保存槽位
♫ LOCAL(本地) 浏览并播放你电脑上的音频文件
⚙ ENGINE(引擎) 流缓冲、缓冲条、低音 EQ、高音 EQ、立体声宽度、水下闷音
i ABOUT(关于) 版本信息、更新检查器、捐赠二维码

视觉特效详情

特效 作用
PULSE(脉冲) 节拍反应式闪光叠加层——强度和衰减可配置
AURA(光环) 缓慢变化的渐变;速度和色调调色板可调
VHS 低音击打时的像素分裂故障,可选 CRT 扫描线
HEATMAP(热力图) 与频率振幅同步的热色渐变
STARFIELD(星空) 低音击打时喷出的火花粒子——数量和衰减可配置

📋 路线图

未来更新中正在考虑的内容:

  • 环境混响 – 大厅、洞穴和大型房间虚拟预设
  • Discord Rich Presence – 可选的曲目标题和艺术家状态显示
  • Sync-Link 聊天分享 – 直接在 Minecraft 聊天中分享流媒体 URL
  • 服务器电台 – 面向多人游戏的服务器级广播
  • 3D 定位音频 – 与唱片机方块关联的距离衰减
  • 动态元数据获取 – 自动标记缺少内嵌曲目信息的原始 URL
  • 红石同步视觉效果 – 基于振幅的音乐反应式红石触发器

🤝 贡献

始终欢迎贡献和反馈!

  • 报告错误: 在 GitHub 上提交 issue,附上重现步骤和相关日志。
  • 建议功能: 在 GitHub issues 区分享想法。
  • 拉取请求: Fork、编写代码并提交 PR!

📄 许可证

本项目基于 MIT 许可证 授权。


📊 版本历史

v1.1.0 –(2026 年 10 月 2 日)

  • 新增: 与 Minecraft 26.3("Wilderness Bound") 完全兼容
  • 新增: 工具链更新至 Java 25 LTS 和 Gradle 9.8.0,搭配 Fabric Loom 1.18.2
  • 新增: 渲染引擎现代化,适配 Minecraft 26.3 的 GuiGraphicsExtractor 和 JOML Matrix3x2fStack
  • 新增: HUD 注册更新为 HudElementRegistry.attachElementAfter(VanillaHudElements.CHAT, ...)
  • 新增: 网络负载系统迁移至 CustomPacketPayload,使用 Identifier.fromNamespaceAndPath
  • 新增: 引擎标签页中的水下自动闷音开关
  • 新增: 立体声宽度 DSP 滑块(0% 单声道 → 100% 正常 → 200% 超宽)
  • 新增: 配置界面标题栏中的播放收藏 / 播放本地快速播放按钮
  • 新增: 关于标签页中的捐赠按钮,通过 Minecraft 内置的 ConfirmLinkScreen 链接到 PayPal
  • 新增: 实时版本检查器——轮询 Modrinth API,如有更新版本则显示更新徽章
  • 修复: YouTube 播放在 39% 处停滞——升级至 dev.lavalink.youtube 1.18.2 并稳定了 Android 客户端
  • 修复: 流加载失败时的缓冲卡死——onTrackException 现在会立即清除缓冲状态
  • 修复: 关于界面二维码渲染(修正了 UV 坐标和边框)
  • 变更: ConfigScreen 组件迁移至 Button、EditBox 和 AbstractSliderButton

v1.0.0 –(2024 年 12 月 / 2025 年 1 月)

  • 新增: 面向 Minecraft 1.21.4 的初始发布
  • 新增: 专业音频流媒体和反应式可视化缎带
  • 新增: 由 LavaPlayer 和 YouTube 源提供器驱动的远程音频播放
  • 新增: 游戏内配置界面,支持可自定义的调色板、主题和布局
  • 新增: 实时音频 DSP 管线,含 EQ、立体声扩展和水下闷音
  • 新增: ModMenu 集成和自定义按键绑定支持

☕ 支持

喜欢 SonicPulse?考虑请 Steve 喝杯咖啡——游戏内 关于 标签页中有二维码和按钮,或使用下方链接。

☕ 请 Steve 喝杯咖啡(PayPal)


🙏 致谢