
声波脉冲
面向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
步骤
- 为你的 Minecraft 版本安装 Fabric Loader。
- 下载 Fabric API 并将其放入你的
.minecraft/mods文件夹。 - 下载匹配的 SonicPulse 版本(26.3 用
SonicPulse-1.1.0.jar,1.21.4 用SonicPulse-1.0.0.jar)。 - 将
.jar文件放入你的.minecraft/mods文件夹。 - 使用 Fabric 配置文件启动 Minecraft。
- 在游戏中按
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和 JOMLMatrix3x2fStack - 新增: 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 喝杯咖啡——游戏内 关于 标签页中有二维码和按钮,或使用下方链接。
🙏 致谢
- 使用 Fabric 和 LavaPlayer 构建
- YouTube 支持通过 lavalink-devs/youtube-source
- 灵感来自 Minecraft 模组社区
正在加载版本记录…








正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。