
Vmse — 真正具有空间感的音乐模组
大多数音乐插件只是播放立体声文件。Vmse 将声源放置在玩家 世界中,位于听者的两侧,并进行双耳渲染——当你转头时,音乐会随之转动;附近的人听到的声音方向正确,而不会听到原本为其他人准备的声音。
基于 Simple Voice Chat 构建。提供四个 JAR 包,覆盖 Minecraft 1.12.2 至 26.3 版本,每个版本在发布前均已在真实服务器上进行负载测试。
在 Modrinth 下载 · 源代码与问题反馈 · 中文说明
✨ 功能特性
| 模块 |
功能说明 |
| ? 双耳立体声 |
两个位于 ±45° 的声源会跟随你的视角旋转,具备 ITD(时间差)、头部阴影和交叉馈送效果——营造真实的声场,而非简单的立体声拓宽 |
| ?️ 控制面板 |
/vmse menu 打开一个库存面板,仅显示你有权使用的选项;管理员按钮对普通玩家完全隐藏 |
| ?️ 音乐区域 |
圆形或长方体区域,进入时自动播放,支持按区域设置音量、声场宽度和曲目,并拥有独立的面板 |
| ? 环境层 |
/vmse env 让墙壁和房间大小影响混音效果;关闭后恢复为纯立体声混音 |
| ? 反射通道 |
/vmse region reflect 离线采样区域,存储房间对各声道的影响特征 |
| ? 播放列表 |
顺序 / 随机 / 循环 / 单曲循环,支持全局或个人列表,YAML 持久化存储,自动推进 |
| ?️ DSP 预设 |
关闭、录音室、耳机、宽广、大厅、低音、人声、夜间——每种均为完整的滤波器组合,不仅仅是混响 |
| ? 同步歌词 |
mc_lyrics JSON 格式,逐字高亮,支持动作栏 / 标题栏 / Boss 血条 / 聊天栏,严格的时间起止控制 |
| ? 在线歌词 |
支持 LRCLIB、网易云、QQ 音乐和酷狗,根据标题、艺术家和时长进行评分,确保封面图不会干扰匹配结果 |
| ⬇️ 下载支持 |
直接音频链接、ZIP 压缩包和 Bilibili 页面,包含恶意归档检查 |
| ? 金锄头法杖 |
左键/右键点击以设置区域角点或移动声源位置 |
| ?️ 语音留言 |
可选集成,运行时自动检测——无需额外安装任何内容 |
? 你需要哪个 JAR 包?
| Jar |
服务端 |
Java |
VMSE-1.2.0-1.12.2.jar |
1.12 – 1.12.2 |
8 |
VMSE-1.2.0-1.16.5-1.18.2.jar |
1.16.5 – 1.18.2 |
8 – 17 |
VMSE-1.2.0-1.19-1.21.11.jar |
1.19 – 1.21.11 |
17 – 21 |
VMSE-1.2.0-26.1-26.3.jar |
26.1 – 26.3 |
25 |
不支持 1.13 – 1.15 版本,因为 Simple Voice Chat 没有针对这些版本的构建——不存在可供播放的音频通道。
? 安装
- 在服务器上安装 Simple Voice Chat,并为所有需要听到音乐的玩家在其客户端上安装。
- 将匹配的
VMSE-1.2.0-*.jar 放入 plugins/ 目录。
- 重启服务器。首次运行时会自动创建配置文件、语言文件和文件夹。
- 将音频文件放入
plugins/Vmse/music,然后使用 /vmse play <song> 或 /vmse menu。
音频解码功能已内置(JLayer / MP3SPI / VorbisSPI)。FFmpeg 和 yt-dlp 为可选组件,仅在使用非常规容器格式或视频网站链接时才需要。
? 日常命令
| 命令 |
描述 |
/vmse menu |
打开控制面板 |
/vmse play <target> <song> [-original] |
为你自己、某位玩家或所有人播放 |
/vmse url <target> <url> |
从链接进行流式播放(会缓存并自动清理) |
/vmse stop / pause |
停止或暂停播放 |
| `/vmse env [on |
off]` |
/vmse effect list / set <preset> |
浏览或应用 DSP 预设 |
/vmse region menu [name] |
显示你所在区域的面板,或指定名称的区域 |
/vmse region reflect <name> |
运行离线反射计算过程 |
/vmse lyrics <song> |
在线获取歌词表 |
/vmse download <url> <name> |
将音轨保存到曲库中 |
/vmse help 列出所有命令,包括选择器(me、all、@a、@p 及玩家名称)。
?️ 安全运行保障
- 下载仅允许 HTTP/HTTPS 协议,并拒绝私有地址、回环地址和本地链路主机——包括重定向后。
- ZIP 包被视为恶意来源:拒绝路径遍历、绝对路径和盘符,拒绝可执行签名,并对条目数量、大小和压缩比进行限制。
- 流式文件存储在
cache/stream 中,其歌词文件位于旁边,按时间和总大小进行修剪,绝不会混入你的曲库。
- 配置的文件夹无法跳出插件目录。
- 无遥测数据收集,除你启用的歌词数据库外,不进行任何外部调用。
? 许可证
AGPL-3.0。 如果您将修改后的版本作为公共服务运行,请公开您的更改。

Vmse — spatial music that actually sounds like it is there
Most music plugins play a stereo file at you. Vmse places sound sources in the world, either side of the listener, and renders them binaurally — the music turns when you turn your head, and people standing nearby hear it from the right direction without hearing what was meant for someone else.
Built on Simple Voice Chat. Four jars covering Minecraft 1.12.2 through 26.3, each one load-tested on a real server before release.
Download on Modrinth · Source & issues · 中文说明
✨ What you get
| Module |
What it does |
| ? Binaural stereo |
Two sources at ±45° that track your yaw, with ITD, head shadow and crossfeed — a real stage, not a widened file |
| ?️ Control panel |
/vmse menu opens an inventory panel that only shows what you may use; admin buttons simply never appear for players |
| ?️ Music regions |
Circle/cuboid zones with auto-play on enter, per-region volume, stage and track, plus their own panel |
| ? Environment layer |
/vmse env lets walls and room size colour the mix; turn it off and the plain stereo mix returns |
| ? Reflection passes |
/vmse region reflect samples a region offline and stores how the room colours each channel |
| ? Playlists |
Sequential / shuffle / loop / loop-one, global or personal, YAML-persisted, auto-advance |
| ?️ DSP presets |
Off, Studio, Headphone, Wide, Hall, Bass, Vocal, Night — each a full filter set, not just reverb |
| ? Synced lyrics |
mc_lyrics JSON, per-word highlight, actionbar / title / bossbar / chat, strict start–end timing |
| ? Online lyrics |
LRCLIB, NetEase, QQ Music and Kugou, scored on title, artist and length so a cover never wins |
| ⬇️ Downloads |
Direct audio links, ZIP packs and Bilibili pages, with hostile-archive checks |
| ? Golden hoe wand |
Left/right click to set region corners or move the sound source |
| ?️ Voice messages |
Optional integration, detected at runtime — nothing extra to install |
? Which jar do I need?
| Jar |
Server |
Java |
VMSE-1.2.0-1.12.2.jar |
1.12 – 1.12.2 |
8 |
VMSE-1.2.0-1.16.5-1.18.2.jar |
1.16.5 – 1.18.2 |
8 – 17 |
VMSE-1.2.0-1.19-1.21.11.jar |
1.19 – 1.21.11 |
17 – 21 |
VMSE-1.2.0-26.1-26.3.jar |
26.1 – 26.3 |
25 |
1.13 – 1.15 are not supported, because Simple Voice Chat has no build for those versions — there is no audio channel to play through.
? Install
- Install Simple Voice Chat on the server, and on the client for everyone who should hear the music.
- Drop the matching
VMSE-1.2.0-*.jar into plugins/.
- Restart. Config, language files and folders are created on first run.
- Put audio in
plugins/Vmse/music, then /vmse play <song> or /vmse menu.
Audio decoding is bundled (JLayer / MP3SPI / VorbisSPI). FFmpeg and yt-dlp are optional and only needed for exotic containers and video-site links.
? Everyday commands
| Command |
Description |
/vmse menu |
Open the control panel |
/vmse play <target> <song> [-original] |
Play for yourself, a player, or everyone |
/vmse url <target> <url> |
Stream from a link (cached, auto-cleaned) |
/vmse stop / pause |
Stop or pause |
| `/vmse env [on |
off]` |
/vmse effect list / set <preset> |
Browse or apply a DSP preset |
/vmse region menu [name] |
Panel for the region you are in, or a named one |
/vmse region reflect <name> |
Run the offline reflection pass |
/vmse lyrics <song> |
Fetch a lyric sheet online |
/vmse download <url> <name> |
Save a track into the library |
/vmse help lists everything, including selectors (me, all, @a, @p, player names).
?️ Built to be safe to run
- Downloads only allow HTTP/HTTPS and reject private, loopback and link-local hosts — including after redirects.
- ZIP packs are treated as hostile: path traversal, absolute paths and drive letters are rejected, executable signatures are refused, and entry count, size and compression ratio are capped.
- Streamed files live in
cache/stream with their lyric beside them, trimmed by age and total size, never mixed into your library.
- Configured folders cannot escape the plugin directory.
- No telemetry, no external calls except the lyric databases you enable.
? License
AGPL-3.0. If you run a modified version as a public service, publish your changes.
评论 0
登录后参与评分
还没有评论,来抢沙发吧