SonicPulse
一款面向 Minecraft Fabric 的专业音频流媒体与动态可视化模组,支持 Minecraft 26.3 ("Wilderness Bound") 和 1.21.4。
直接在 Minecraft 内从 YouTube、SoundCloud、Bandcamp、Vimeo、网络电台和本地文件播放音乐,并配有令人惊叹的动态 HUD 光带,随节拍律动。
✨ 功能特性
? 音频流媒体
- YouTube 播放 – 粘贴任意 YouTube 链接即可立即开始播放
- SoundCloud / Bandcamp / Vimeo – 支持所有主流平台的直接 URL 流媒体播放
- 网络电台 (M3U) – 加载和保存 M3U 流媒体播放列表,内置 BBC 预设
- 本地文件播放 – 浏览并播放电脑中的
.mp3、.flac 和 .wav 文件
- 收藏与历史 – 一键保存、重命名、重新排序和回放您的曲目
? 动态可视化 HUD
- 实时均衡器条 – 直接在 HUD 光带上渲染动画 FFT 频率条
- 多种视觉风格 – 方块、线条、波浪、镜像、峰值、圆点等更多样式
- 背景特效 – 脉冲闪光、光环渐变漂移、VHS 故障效果、热力图、星场
- 音频驱动皮肤 – HUD 边框和背景根据音乐动态反应
- 颜色主题 – 为频率条、标题文本和装饰元素提供 20+ 种精选调色板
- SonicPulse Logo – 带有逐色自定义功能的动画文字标志
? DSP 音频引擎
- 低音与高音 EQ – 特定频率的增益滑块(–100% 至 +100%)
- 立体声扩展 – 声场从单声道 (0%) 扩展到超宽 (200%)
- 水下自动滤波 – 在水下时自动应用低通滤波器
- 流媒体缓冲 – 可配置的预加载缓冲时间(0–15 秒),以防止慢速连接下的卡顿
- 缓冲进度条 – HUD 底部显示实时加载指示器
⚙️ 甲板控制
- 配置内传输控制 – 在配置界面中直接进行 ⏮ 上一曲、▶/⏸ 播放/暂停、⏹ 停止、⏭ 下一曲操作
- 快速播放快捷键 – 一键点击 Play Favs(播放收藏)和 Play Local(播放本地)头部按钮
- 会话模式 – 远程、电台、收藏、历史和本地模式按会话跟踪
? 默认按键绑定
| 按键 |
操作 |
备注 |
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 |
带有 BBC 预设和 4 个自定义保存槽位的 M3U 网络电台 |
| ♫ LOCAL |
浏览并播放电脑中的音频文件 |
| ⚙ ENGINE |
流媒体缓冲、缓冲条、低音 EQ、高音 EQ、立体声宽度、水下滤波 |
| i ABOUT |
版本信息、更新检查器、捐赠二维码 |
视觉效果详情
| 效果 |
作用 |
| PULSE |
随节拍反应的闪光叠加层 — 强度和衰减可配置 |
| AURA |
缓慢变化的渐变;速度和色调调色板可调 |
| VHS |
低音冲击时的像素分割故障效果,可选 CRT 扫描线 |
| HEATMAP |
与频率振幅同步的热彩色渐变 |
| STARFIELD |
低音冲击时喷射的火花粒子 — 数量和衰减可配置 |
? 路线图
正在考虑用于未来更新的功能:
- 环境混响 – 大厅、洞穴和大房间虚拟预设
- Discord Rich Presence – 可选显示曲目标题和艺术家状态
- Sync-Link 聊天分享 – 直接在 Minecraft 聊天中分享流媒体 URL
- 服务器电台 – 多人游戏的服务器-wide 广播
- 3D 定位音频 – 基于距离的淡入淡出,与唱片机方块联动
- 动态元数据获取 – 自动标记缺乏嵌入式曲目信息的原始 URL
- 红石同步视觉效果 – 基于振幅的音乐驱动红石触发器
? 贡献
欢迎贡献和反馈!
- 报告错误: 在 GitHub 上打开一个问题,附上复现步骤和相关日志。
- 建议功能: 在 GitHub 问题部分分享您的想法。
- 拉取请求: Fork、编码并提交 PR!
? 许可证
本项目采用 MIT License 授权。
? 版本历史
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 处理管线,包含均衡器、立体声展宽及水下消音效果
- 新增: ModMenu 集成及自定义按键绑定支持
☕ 支持
喜欢 SonicPulse 吗?可以考虑请 Steve 喝杯咖啡——在游戏内的 关于 选项卡中有二维码和按钮,或者使用下方的链接。
? 致谢
SonicPulse
A professional audio streaming and reactive visualizer mod for Minecraft Fabric, supporting Minecraft 26.3 ("Wilderness Bound") and 1.21.4.
Stream music from YouTube, SoundCloud, Bandcamp, Vimeo, internet radio, and local files — all from inside Minecraft, with a stunning reactive HUD ribbon that pulses to the beat.
✨ Features
? Audio Streaming
- YouTube Playback – Paste any YouTube link and it starts playing instantly
- SoundCloud / Bandcamp / Vimeo – Direct URL streaming for all major platforms
- Internet Radio (M3U) – Load and save M3U stream playlists with BBC presets built-in
- Local File Playback – Browse and stream
.mp3, .flac, and .wav files from your computer
- Favorites & History – Save, rename, reorder, and replay your tracks with one click
? Reactive Visualizer HUD
- Real-time Equalizer Bars – Animated FFT frequency bars rendered directly on the HUD ribbon
- Multiple Visual Styles – Block, Line, Wave, Mirror, Peak, Dots, and more
- Background Effects – Pulse flash, Aura gradient drift, VHS glitch, Heatmap, and Starfield
- Audio-Reactive Skinning – HUD border and background react dynamically to the music
- Color Themes – 20+ curated palette colors for bars, title text, and accents
- SonicPulse Logo – Animated text logo with per-color customization
? DSP Audio Engine
- Bass & Treble EQ – Frequency-specific gain sliders (–100% to +100%)
- Stereo Widening – Soundstage expansion from Mono (0%) to Super Wide (200%)
- Underwater Auto-Muffle – Automatic low-pass filter when submerged
- Stream Buffering – Configurable pre-load buffer (0–15s) to prevent stutter on slow connections
- Buffer Progress Bar – Live loading indicator at the bottom of the HUD
⚙️ Deck Controls
- In-config Transport Controls – ⏮ Previous, ▶/⏸ Play/Pause, ⏹ Stop, ⏭ Next directly in the config screen
- Quick-Play Shortcuts – One-click Play Favs and Play Local header buttons
- Session Modes – Remote, Radio, Favourites, History, and Local modes tracked per session
? Default Keybindings
| Key |
Action |
Notes |
P |
Open Config Screen |
Opens the full SonicPulse control panel |
ESC |
Close Config Screen |
Standard close when no text field is focused |
TIP: The config key is fully remappable in Options ➔ Controls ➔ Key Binds under the SonicPulse category.
? Installation & Compatibility
Choose the release file matching your Minecraft version:
For Minecraft 26.3 (v1.1.0)
- Minecraft:
26.3
- Fabric Loader:
>= 0.19.5
- Fabric API:
>= 0.161.0+26.3
- Java:
25 LTS
For 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
Steps
- Install Fabric Loader for your Minecraft version.
- Download Fabric API and place it in your
.minecraft/mods folder.
- Download the matching SonicPulse version (
SonicPulse-1.1.0.jar for 26.3, or SonicPulse-1.0.0.jar for 1.21.4).
- Place the
.jar file in your .minecraft/mods folder.
- Launch Minecraft using the Fabric profile.
- Press
P in-game to open the SonicPulse config screen and start streaming!
Note: SonicPulse bundles its own audio engine (LavaPlayer) — no external server or companion app required.
⚙️ Configuration
Press P in-game to open the full configuration screen. Nine dedicated tabs put every setting at your fingertips:
| Tab |
Contents |
| ? REMOTE |
Paste YouTube / SoundCloud / direct URLs, recent stream shortcuts |
| ? VISUAL |
HUD visibility, skins, logo, track name, EQ bar style, background effects, colors |
| ? LAYOUT |
Element sequence (Logo / Track / Bars order), HUD scale, HUD width |
| ? HIST |
Replay or delete your recently streamed tracks |
| ★ FAVS |
Manage saved favorites — reorder, rename, and quick-play |
| ? RADIO |
M3U internet radio with BBC presets and 4 custom save slots |
| ♫ LOCAL |
Browse and play audio files from your computer |
| ⚙ ENGINE |
Stream buffering, buffer bar, Bass EQ, Treble EQ, Stereo Width, Underwater muffle |
| i ABOUT |
Version info, update checker, donation QR code |
Visual Effects Detail
| Effect |
What It Does |
| PULSE |
Beat-reactive flash overlay — intensity and decay configurable |
| AURA |
Slowly shifting gradient; speed and hue palette adjustable |
| VHS |
Pixel-split glitch on bass hits with optional CRT scanlines |
| HEATMAP |
Thermal color gradient synced to frequency amplitude |
| STARFIELD |
Spark particles ejected on bass hits — count and decay configurable |
? Roadmap
Under consideration for future updates:
- Environmental Reverb – Hall, Cave, and Large Room virtual presets
- Discord Rich Presence – Optional track title and artist status display
- Sync-Link Chat Sharing – Share stream URLs directly in Minecraft chat
- Server Radio – Server-wide broadcasting for multiplayer
- 3D Positional Audio – Distance-based fading linked to Jukebox blocks
- Dynamic Metadata Fetching – Auto-label raw URLs that lack embedded track info
- Redstone-Sync Visuals – Music-reactive Redstone triggers based on amplitude
? Contributing
Contributions and feedback are always welcome!
- Report Bugs: Open an issue on GitHub with steps to reproduce and any relevant logs.
- Suggest Features: Share ideas in the GitHub issues section.
- Pull Requests: Fork, code, and submit a PR!
? License
This project is licensed under the MIT License.
? Version History
v1.1.0 – (October 2, 2026)
- NEW: Full compatibility with Minecraft 26.3 ("Wilderness Bound")
- NEW: Updated toolchain to Java 25 LTS and Gradle 9.8.0 with Fabric Loom 1.18.2
- NEW: Modernized rendering engine to Minecraft 26.3's
GuiGraphicsExtractor and JOML Matrix3x2fStack
- NEW: HUD registration updated to
HudElementRegistry.attachElementAfter(VanillaHudElements.CHAT, ...)
- NEW: Network payload system migrated to
CustomPacketPayload with Identifier.fromNamespaceAndPath
- NEW: Underwater Auto-Muffle toggle in Engine tab
- NEW: Stereo Width DSP slider (0% Mono → 100% Normal → 200% Super Wide)
- NEW: Play Favs / Play Local quick-play buttons in the config header
- NEW: Donation button on About tab linking to PayPal via Minecraft's built-in
ConfirmLinkScreen
- NEW: Live version checker — polls Modrinth API and shows an update badge if a newer release exists
- FIXED: YouTube playback stall at 39% — upgraded to
dev.lavalink.youtube 1.18.2 and stabilized Android client
- FIXED: Buffer hang on stream load failure —
onTrackException now clears buffering state immediately
- FIXED: About screen QR code rendering (corrected UV coordinates and border)
- CHANGED:
ConfigScreen widgets migrated to Button, EditBox, and AbstractSliderButton
v1.0.0 – (December 2024 / January 2025)
- NEW: Initial release for Minecraft 1.21.4
- NEW: Professional audio streaming and reactive visualizer ribbon
- NEW: Remote audio playback powered by LavaPlayer and YouTube source provider
- NEW: In-game Config Screen with customizable color palettes, themes, and layouts
- NEW: Real-time audio DSP pipeline with EQ, stereo widening, and underwater muffling
- NEW: ModMenu integration and custom keybinding support
☕ Support
Enjoying SonicPulse? Consider buying Steve a coffee — there's a QR code and button on the About tab in-game, or use the link below.
? Acknowledgments
评论 0
登录后参与评分
还没有评论,来抢沙发吧