Phonon

在 Minecraft 中一起聆听音乐。通过扬声器和收音机播放你的音乐,附近的所有玩家都能听到同一首歌的同一时刻。

你能做什么
- 添加任意歌曲。 在游戏中按标题搜索、粘贴链接,或将文件拖入世界中。
- 放置扬声器。 音乐从它所在的位置传出。走过时会移动声音位置,墙壁和水会使其变得沉闷。
- 携带收音机。 它在你的物品栏、鼠标指针上以及地面上持续播放。
- 运行电台。 一个队列,所有扬声器都调至该频道,所有玩家同步收听,即使跨维度也是如此。
- 构建播放列表。 支持队列、随机播放和循环,并为整个服务器保存播放列表。
- 进行连线控制。 红石可以控制扬声器,比较器可读取其进度,鹦鹉还会随之起舞。
安装
在客户端和服务器端都安装 Phonon,使用 NeoForge 或 Fabric 以及 Fabric API。从 Modrinth 或 GitHub 下载。Phonon 支持从 1.21.1 到 26.3 的所有 Minecraft 版本,适用于两种加载器。选择适合你加载器的文件,其支持的 Minecraft 版本需包含你的版本;例如,名为 1.21.3 的文件也可在 1.21.2 上运行。
在 Fabric 上,设置位于 config/phonon-server.json 和 config/phonon-client.json,并且 Mod Menu 会为客户端设置添加一个按钮。
Minecraft 26.x 需要 Java 25,而 1.21.x 需要 Java 21。
开始使用
- 在创造模式菜单中的“功能方块”或“红石方块”分类下找到该物品,或者当你拥有唱片机后,可以合成它。
- 右键点击它,并在搜索框中输入歌曲标题或粘贴链接。你也可以运行命令
/phonon add <链接或标题>。 - 双击歌曲即可播放。
音量遵循游戏唱片机/音符盒滑块设置。
要添加本地文件,请将它们放入世界文件夹中的 phonon_music 目录内,然后运行 /phonon reload。支持 MP3、WAV、FLAC、M4A、AAC、Opus、WMA 和 OGG 格式,且原始文件会保留在文件夹中。
音频工具
添加音频的操作是在运行服务器的机器上进行的,单人游戏中即为你自己的电脑。直接指向 OGG 文件的链接无需其他依赖。其他链接和非 OGG 文件需要 yt-dlp、FFmpeg 和 Deno。
如果缺少这些工具,Phonon 会在首次需要时于聊天栏中提示安装。操作员点击接受后,经过校验和验证的固定版本构建文件将进入游戏文件夹中的 phonon/tools 目录。当 Phonon 尚未安装其自有工具时,会优先使用已存在于系统 PATH 环境变量中的工具。服务器管理员可通过设置 allowToolInstall 来禁用此功能。
在 Windows 上手动安装时,请运行以下命令,然后重启 Minecraft 启动器。winget 还会同时安装 FFmpeg 和 Deno。
winget install --source winget --id yt-dlp.yt-dlp
当网站屏蔽服务器时
许多网站不信任来自云主机的地址,而下载任务由服务器执行,因此链接和搜索都会失败。请先运行 /phonon tools update,因为旧版本的 yt-dlp 会以类似方式失效。之后,服务器配置中将提供 downloadProxy(下载代理)和 cookiesFile(Cookie 文件)。yt-dlp 警告指出,以这种方式使用的账号可能会被封禁,因此请使用备用账号并严格保密该文件。
扬声器界面

- 音轨:音乐库。双击可播放,或将鼠标悬停在歌曲上以选择立即播放、下一首播放或添加到播放列表。输入文字可过滤列表;若你拥有添加歌曲的权限,下方绿色行会在 YouTube、SoundCloud 或 Bilibili 上查找你输入的内容,或添加粘贴的链接。
- 队列:即将播放的内容。双击可跳转至该曲目,或移除某一行。
- 播放列表:任何人均可创建的保存列表,并标注创作者。打开后可通过输入文字添加歌曲,拖拽以重新排序,并重命名。
- 电台:由一人运营、供所有听众收听的电台。输入新名称会将当前播放内容共享为一个电台,输入已有名称则切换至该电台。离开操作会使你的个人音乐回到原来的位置。
界面会标明按钮的作用对象,并对不可更改的内容显示为灰色。
收音机
使用扬声器合成一台收音机,或在创造模式菜单的音乐唱片之后找到它。使用它以打开控制面板,或潜行并使用它以开启或关闭设备。它的电台调谐方式与扬声器相同。将其放入箱子中,或其支架处于离线状态时,其自身的音乐会暂停并从同一位置继续;电台则会不受影响地继续运行。
红石
面向扬声器时,信号触发侧边动作如下:
| 侧面 | 动作 |
|---|---|
| 左侧 | 上一首音轨 |
| 右侧 | 下一首音轨 |
| 背面 | 停止 |
| 正面、顶部、底部 | 播放或暂停 |
比较器可读取扬声器在当前音轨中的进度:开始时为 1,结束时为 15,停止时为 0。幽匿感测体可侦听其开始与停止,附近的鹦鹉和悦灵会随之跳舞。
命令
所有命令都需要操作员权限。
| 指令 | 说明 |
|---|---|
/phonon add [name] <link> |
下载并注册音频。如果不提供名称,则使用视频标题 |
/phonon add <title> |
添加与标题相关的第一个 YouTube 搜索结果 |
/phonon list |
查看已注册的音频 |
/phonon remove <name> |
移除音频 |
/phonon reload |
重新加载配置并从音乐文件夹导入新文件 |
/phonon config |
显示服务器设置,并提供按钮以开启或关闭各项设置 |
/phonon config <setting> <value> |
更改服务器设置并保存 |
/phonon config <setting> reset |
将服务器设置恢复为默认值 |
/phonon tools |
显示音频工具版本,以及上次成功工作或被封禁的网站 |
/phonon tools install |
在游戏文件夹中安装 yt-dlp、FFmpeg 和 Deno |
/phonon tools update |
更新 Phonon 的 yt-dlp;如果系统中仅有旧版,则先进行安装 |
/phonon tools help |
当网站阻止服务器时该如何处理 |
服务器设置
这些设置对所有玩家生效。操作员可以在游戏中通过 /phonon config 修改它们,该命令还涵盖下载、代理和传输设置,并隐藏代理密码。音频工具设置(包括选择代理、cookies 文件以及是否允许 yt-dlp 自动更新)需要所有者权限(等级 4)。设置保存在 NeoForge 的 config/phonon-server.toml 或 Fabric 的 config/phonon-server.json 中。
| 设置项 | 功能 |
|---|---|
ownerOnlySpeakers |
限制扬声器仅可由放置者及操作员使用 |
anyoneCanAddTracks |
允许所有玩家添加歌曲。玩家只能删除自己添加的内容 |
anyoneCanControlStations |
允许任何正在收听频道的玩家更改播放内容。否则只有创建者和操作员可以控制 |
muffleBehindWalls |
玩家与扬声器之间的墙壁会削弱声音效果。关闭此选项可像唱片机一样无阻碍地听到扬声器声音 |
hearingDistance |
玩家能听到扬声器的距离(以方块为单位),范围为 16 到 128(默认为 64) |
audioQuality |
新添加音频的 Vorbis 质量,范围从 0(最小)到 10(最佳) |
致谢
Phonon 深受 WebDisplays 和 Sound Physics Remastered 的启发。
许可证
GPL-3.0。非官方 Minecraft 产品。未经 Mojang 或 Microsoft 批准或认可。
Phonon

Listen together in Minecraft. Play your music through speakers and boomboxes, and everyone nearby hears the same moment of the same song.

What you can do
- Add any song. Find it by title in the game, paste a link, or drop files into the world.
- Place a speaker. The music comes from where it stands. Walk past and it moves, and walls and water muffle it.
- Carry a boombox. It keeps playing in your inventory, on your cursor and on the ground.
- Run a station. One queue, every speaker tuned to it, every player in step, even across dimensions.
- Build playlists. Queue, shuffle and repeat, with playlists saved for the whole server.
- Wire it up. Redstone controls a speaker, comparators read its progress, and parrots dance to it.
Install
Install Phonon on both the client and the server, with either NeoForge or Fabric and Fabric API. Download from Modrinth or GitHub. Phonon supports every Minecraft release from 1.21.1 to 26.3 on both loaders. Choose the file for your loader whose Minecraft versions include yours; a file named for 1.21.3, for example, also runs on 1.21.2.
On Fabric, the settings are in config/phonon-server.json and config/phonon-client.json, and
Mod Menu adds a button for the client settings.
Minecraft 26.x needs Java 25, and 1.21.x needs Java 21.
Get started
- Find the Speaker in the creative menu under Functional Blocks or Redstone Blocks, or craft it once you have a jukebox.
- Right-click it and type a song's title or paste a link into the search box. You can also run
/phonon add <link or title>. - Double-click the song to play it.
Volume follows the game's Jukebox/Note Blocks slider.
To add local files, put them in phonon_music inside the world folder and run /phonon reload. MP3, WAV, FLAC, M4A,
AAC, Opus, WMA and OGG are accepted, and the originals stay in the folder.
Audio tools
Adding audio happens on the machine that runs the server, which in singleplayer is your own PC. Direct links to OGG files need nothing else. Other links and non-OGG files need yt-dlp, FFmpeg and Deno.
If they are missing, Phonon offers to install them in chat the first time they are needed. An operator clicks to
accept, and pinned builds with verified checksums go into phonon/tools in the game folder. Tools already on PATH
are used when Phonon hasn't installed its own. Server owners can turn this off with allowToolInstall.
To install them yourself on Windows, run this, then restart the Minecraft Launcher. winget installs FFmpeg and Deno too.
winget install --source winget --id yt-dlp.yt-dlp
When a site blocks the server
Sites often distrust addresses from cloud hosts, and the server does the downloading, so links fail as well as searches.
Run /phonon tools update first, since an old yt-dlp fails in similar ways. After that, the server config has
downloadProxy and cookiesFile. yt-dlp warns that an account used this way can be banned, so use a spare one and keep
the file private.
The speaker screen

- Tracks: the library. Double-click to play, or hover a song for play now, play next and add to a playlist. Typing filters the list, and if you may add songs, the green row below finds what you typed on YouTube, SoundCloud or Bilibili, or adds a pasted link.
- Queue: what's up next. Double-click to jump, or remove a row.
- Playlists: saved lists anyone can make, credited to their creator. Open one to add songs by typing, drag to reorder, and rename it.
- Stations: music one person runs, for everyone who listens in. Typing a new name shares what's playing as a station, and typing an existing name tunes to it. Leave brings your own music back where it was.
The screen says who a button affects, and greys out what you can't change.
Boombox
Craft one from a Speaker, or find it after the music discs in the creative menu. Use it to open its controls, or sneak and use it to switch it on or off. It tunes to stations like a speaker does. Put away in a chest, or with its holder offline, its own music waits and carries on from the same point; a station keeps going without it.
Redstone
A signal turning on acts by side, as seen facing the speaker:
| Side | Action |
|---|---|
| Left | Previous track |
| Right | Next track |
| Back | Stop |
| Front, top, bottom | Play or pause |
A comparator reads how far through the track the speaker is: 1 at the start up to 15 at the end, and 0 when stopped. Sculk sensors hear it start and stop, and nearby parrots and allays dance.
Commands
All commands need operator permission.
| Command | Description |
|---|---|
/phonon add [name] <link> |
Download and register audio. Without a name, it uses the video's title |
/phonon add <title> |
Add the first YouTube result for the title |
/phonon list |
View registered audio |
/phonon remove <name> |
Remove audio |
/phonon reload |
Reload configuration and import new files from the music folder |
/phonon config |
Show the server settings, with buttons to switch them on or off |
/phonon config <setting> <value> |
Change a server setting and save it |
/phonon config <setting> reset |
Put a server setting back to its default |
/phonon tools |
Show audio tool versions, and which sites last worked or were blocked |
/phonon tools install |
Install yt-dlp, FFmpeg and Deno into the game folder |
/phonon tools update |
Update Phonon's yt-dlp, installing it first if it's only on the system |
/phonon tools help |
What to do when a site blocks the server |
Server settings
They apply to every player. Operators can change them in game with /phonon config, which also covers download,
proxy and transfer settings, and hides a proxy's password. The audio tool settings, which choose the proxy, the
cookies file and whether yt-dlp updates itself, need owner permission (level 4). Settings are saved in
config/phonon-server.toml on NeoForge or config/phonon-server.json on Fabric.
| Setting | What it does |
|---|---|
ownerOnlySpeakers |
Limits a speaker to whoever placed it and operators |
anyoneCanAddTracks |
Lets every player add songs. Players can delete only what they added |
anyoneCanControlStations |
Lets anyone tuned to a station change what it plays. Otherwise only its creator and operators can |
muffleBehindWalls |
Walls between a player and a speaker muffle it. Turn off to hear speakers unobstructed, like a jukebox |
hearingDistance |
How far away, in blocks, players hear a speaker, from 16 to 128 (64 by default) |
audioQuality |
Vorbis quality of newly added audio, from 0 (smallest) to 10 (best) |
Credits
Phonon is greatly inspired by WebDisplays and Sound Physics Remastered.
License
GPL-3.0. Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.
下载 Phonon
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Phonon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
0.4.0
适用于从 1.21.1 到 26.3 的每一个 Minecraft 版本,支持 NeoForge 和 Fabric,相较于 0.3.1 有所更新。本次发布将 0.4 beta 线提升为正式版本,该 beta 线引入了对 Fabric 的支持以及从 1.21.1 开始的每一个 Minecraft 版本;以下变更是在 0.4.0-beta.3 之后新增的内容。
变更
- 操作员可以通过
/phonon config在游戏内查看并修改所有服务器设置。代理密码保持隐藏,而音频工具设置需要所有者权限才能更改。 - 新增一项服务器设置
muffleBehindWalls,允许服务器关闭声音遮挡效果,使每位玩家都能无阻碍地听到扬声器发出的声音,就像唱片机一样。 - 玩家能听到扬声器的距离现在统一采用服务器的
hearingDistance设置,对所有玩家一致,取代了原先每位玩家各自的“最大音频距离”设置。
修复
- 地毯、台阶和其他薄型方块仅在声音实际穿过它们时才会产生遮挡效果。此前,铺有地毯的地面产生的遮挡效果与石墙相同。粉末雪在所有 Minecraft 版本中均会产生遮挡效果。
- 手持式收音机在行走时始终保持在屏幕中央,不再出现左右声道交替切换的现象。
客户端和服务器都必须进行更新,因为发送给玩家的设置发生了变化。
在 Minecraft 1.21.10 及更早版本的 Fabric 上,服务器的曲库和电台列表必须能够在一个 1 MiB 的数据包中传输,因为该版本的 Fabric API 无法拆分更大的数据包;这相当于数千首曲目。在 Minecraft 1.21.1 的 Fabric 版本中,扬声器的灯条在黑暗中不会发光。
测试证据
- 目标:23 个构建版本,每个加载器对应一个,并按 Minecraft 版本分组,每组均针对该组最新的 NeoForge 或 Fabric API 进行测试。Java 21.0.6 用于 1.21.x 版本,Java 25.0.3 用于 26.x 版本,于 2026 年 11 月 12 日在搭载 Apple Silicon 芯片的 macOS 系统上的提交
aba8762处完成测试。 - 所有构建版本均能成功编译并通过 65 项自动化测试。
- 所有构建版本均通过真实客户端中的简短启动测试:单人游戏中扬声器正常播放,手持式收音机的工具提示显示正常,且所有名称均已翻译。
- 在从 1.21.1 到 26.3 的每一个版本中,每种加载器的生产专用服务器均可使用本次发布的 jar 文件启动,执行
/phonon reload后正常停止。在每五次启动中,有一次在 Minecraft 1.21.2 配合 NeoForge 21.2.1-beta 时,服务器进程虽已停止但并未退出;这是由于 NeoForge 在加载模组前启动的一个线程导致进程未能完全终止。 - 在 26.3 版本中,完整脚本检查清单在两种加载器的真实客户端及专用服务器上均顺利通过:包括播放控制、多个扬声器、电台和手持式收音机、1 MB 缓存淘汰、资源重载、重新连接以及服务器重启。在一次 seek(跳转)操作后,两个客户端保持同步:NeoForge 延迟 -6 毫秒,Fabric 延迟 +6 毫秒。
- 在真实客户端中对 1.21.1 和 26.3 版本进行测量,两种加载器下:铺有地毯的地面不再对扬声器产生遮挡效果,而石墙、玻璃和粉末雪仍会产生遮挡;关闭
muffleBehindWalls设置可消除所有遮挡效果。手持式收音机在听者耳旁播放。 - 在两种加载器上使用
/phonon config命令:验证了参数修改、重置、范围错误处理,代理密码保持隐藏,且在未获得所有者权限时拒绝访问音频工具设置。 - 未进行长时间运行测试:本次发布经过代码审查及上述检查后即推出,未进行长期服务器压力测试。
0.4.0-beta.3
支持从 Minecraft 1.21.1 到 26.3 的所有版本,相比 0.4.0-beta.1 有所扩展。
变更
- Phonon 在 NeoForge 和 Fabric 上均支持 Minecraft 1.21.1 至 26.3。每个加载器和一组 Minecraft 版本对应一个文件;例如,适用于 1.21.3 的文件也兼容 1.21.2。
- 在 Fabric 上,Phonon 会标识其兼容的最旧 Fabric API 版本,因此在游戏启动时报告的是较旧的 API 版本,而不是直接崩溃。
对于 Minecraft 1.21.10 及更早版本的 Fabric,服务器的库(library)和电台(station)列表必须能容纳在一个 1 MiB 的数据包中,因为该版本的 Fabric API 无法拆分更大的数据包;这相当于数千首曲目。对于 Minecraft 1.21.1 的 Fabric 版本,扬声器(speaker)的灯带在黑暗中不会发光。
测试证据
- 目标: 23 个构建版本,每个加载器和每组 Minecraft 版本各一个,分别针对该组最新的 NeoForge 或 Fabric API 进行测试。1.21.x 使用 Java 21,26.x 使用 Java 25,均在搭载 Apple Silicon 芯片的 macOS 上进行测试。
- 所有构建均能编译并通过 63 项自动化测试。
- 所有构建均通过真实客户端中的短启动测试:单人游戏中扬声器播放音乐、收音机(boombox)工具提示显示正常,且所有名称均有翻译。
- 在从 1.21.1 到 26.3 的每个版本中,每种加载器的专用服务器均能通过发布版 jar 文件正常启动,执行
/phonon reload命令后干净地停止。共享同一个 jar 文件的版本(如 1.21.2)会使用该 jar 允许的最早加载器版本进行启动。 - 在 26.3 版本中,完整的脚本化检查清单在真实客户端和专用服务器上对两种加载器均顺利通过:包括播放控制、多个扬声器、电台和收音机、1 MB 缓存驱逐、资源重新加载、重新连接以及服务器重启。在一次快进操作后,两个客户端保持同步:NeoForge 延迟 +20 ms,Fabric 延迟 +3 ms。
0.4.0-beta.1
适用于 Minecraft 26.2,由 0.3.1 升级而来。
更改内容
- Phonon 同时支持 Fabric 和 NeoForge,提供相同的方块、物品、命令和设置。需要安装 Fabric API。
设置文件位于
config/phonon-server.json和config/phonon-client.json,Mod Menu 中会显示一个用于客户端设置的按钮。 - 当 Fabric 客户端无法与服务器通信时,会在加入时被提示安装与服务端一致版本的 Phonon,行为方式与 NeoForge 相同。
由于加载器不同,Fabric 和 NeoForge 玩家无法互相加入对方的服务器。对于 NeoForge 玩家而言,没有任何变化。
测试证据
- 目标环境:Minecraft 26.2,搭配 NeoForge 26.2.0.93,以及搭配 Fabric Loader 0.20.1 和 Fabric API 0.161.0+26.2。Java 版本为 25,在搭载 Apple Silicon 芯片的 macOS 上进行测试。
- 63 项自动化测试全部通过。
- 脚本化检查清单在真实客户端和专用服务器上对两种加载器均顺利通过:包括播放控制、多个扬声器、电台、Boombox(便携音箱)、1 MB 缓存驱逐、资源重载、重新连接以及服务器重启。
- 专用服务器上两个客户端保持同步:Fabric 延迟为加入后期 -20 ms,寻址后 -2 ms;NeoForge 延迟分别为 -30 ms 和 -20 ms。
- 两种加载器的生产级专用服务器(分别由 NeoForge 安装程序和 Fabric 服务器启动器配置)使用发布版 JAR 包启动,执行
/phonon reload命令后能够正常停止。
0.3.1
适用于 Minecraft 26.2,由 0.3.0 升级而来。
更改内容
- 在电台上,扬声器屏幕会在“正在播放”旁显示其运营者,且音频电平表保持清晰可见。
- 播放按钮会标明其操作是否针对所有人生效,例如“暂停 · 对所有人”。被锁定的按钮仍会显示锁定原因。
- 当已存在同名电台时,按 Enter 键将切换到该电台,而不是创建一个同名的新电台。
- Phonon 的图标现在显示在游戏的模组列表中。
测试证据
- 目标环境:Minecraft 26.2、NeoForge 26.2.0.93、Java 25,在 Apple Silicon macOS 上进行测试。
- 63 项自动化测试全部通过,且在真实客户端和专用服务器上的脚本化检查清单也全部通过:包括播放控制、多个扬声器、1 MB 缓存驱逐、资源重载、重新连接以及服务器重启。
- 专用服务器上两个客户端保持了同步:延迟加入时为 -33 ms,Seek(跳转)后为 2 ms。
- 在真实客户端中:启动电台、在其名称上按 Enter 键使第二个扬声器切换而非创建重复项、收音机屏幕打开,以及
/phonon add <title>成功添加了 YouTube 搜索结果。
更新日志
0.3.0-beta.2
首次发布的 Beta 版本,适用于 Minecraft 26.2 和 1.21.1。其他目标平台仍保持在 0.3.0-alpha.3。由于 0.3.0-beta.1 标签指向了错误的提交,发布检查拒绝了它们。这些标签未产生任何发布版本并保留占用。自测试提交以来唯一的更改就是版本号和本说明。
测试证据
- 目标:Minecraft 1.21.1, NeoForge 21.1.235, Java 21, 提交
65f0555, 在 Apple Silicon 的 macOS 上测试。 - 自动化测试和脚本化清单(
neoforge/driver/checklist)在实际客户端和专用服务器上均通过:播放、暂停、恢复、搜索、停止、音量调节、多个扬声器、自动停止、资源重载、重新加入、服务器重启,以及没有操作员权限的玩家。 - 同一台机器上两个客户端之间的同步:迟加入者的播放时钟与第一名玩家的偏差在 10 毫秒以内,且在搜索后为 5 毫秒。这是对比播放时钟,而非声音本身。
- 游戏内工具安装、YouTube 链接导入和音乐文件夹导入在此目标上通过。
未测试
- 尚未有人试听此构建,包括音量滑块的变化。
- Windows 和 Linux,包括这些系统上的工具下载。
- 两台计算机通过真实网络连接,以及多小时的会话。
/phonon tools update、allowToolInstall=false和非默认的audioQuality。
已知问题
- 暂停单人游戏可能会使音频滞后于播放时钟。这是根据代码推测的,尚未测量。
- 在 1.21.1 中,资源重载可能会记录
Stop: Invalid name parameter。播放可以恢复。
入门指南
- 在创造模式菜单中列出扬声器,拾取唱片机时解锁其配方,并添加第一个进度。
- 当操作员需要 yt-dlp、FFmpeg 和 Deno 时,从聊天窗口提供安装提示,使用具有已验证校验和的固定构建版本,然后重试添加操作。可通过
allowToolInstall关闭此功能。输入/phonon tools查看找到的内容并更新 yt-dlp。 - 在世界文件夹中的
phonon_music目录导入音频文件,在游戏启动和/phonon reload时生效。 /phonon add不再需要名称或引号:它可以使用视频标题。
播放
- 跟随唱片机/音符盒音量滑块,而不是方块音量。
- 当附近的扬声器开始新曲目时,显示原版“正在播放”行。
消息
- 说明添加音频失败的原因及解决方法,而不是一直归咎于 yt-dlp。
- 翻译所有 GUI 和命令文本,并添加简体中文。
修复与设置
- 每次更改都保存曲目列表,因此
/phonon reload不再忘记服务器启动后添加的曲目。 - 添加
audioQuality服务器设置。
0.3.0-alpha.3
此 Alpha 版本修复了玩家报告的错误。它在所有目标上均通过编译和自动化测试。手动游戏玩法测试仍在进行中,因此该构建仍保持 Alpha 状态。
修复
- 在跳过零透明度颜色的目标上恢复扬声器和配置屏幕文本。
- 直接运行 yt-dlp 而不是用 5 秒限制探测它,这可能会将缓慢启动报告为“未找到”并阻塞服务器线程。
- 当 yt-dlp 失败时记录其输出,并在无法启动时记录
PATH。 - 在 Minecraft 1.21.1 到 1.21.8 上保持曲目列表高亮在选择框内。
0.3.0-alpha.1
这是一个 Alpha 构建。所有目标均通过编译和自动化测试,选定的目标通过了服务器或客户端启动的冒烟测试,但每个已发布的 Minecraft 目标在提升为 Beta 之前仍需进行手动游戏内验证。
性能
- 将 OGG 页索引从全文件读取改为有界的顺序通道读取。
- 将服务器音频读取移出 Tick 线程,保持文件通道在每次传输期间打开,预取两个块,并在全局和每玩家的字节预算下公平调度玩家。
- 移除客户端流媒体中的重复数据包分割和全缓冲区缓存组装。
- 直接将 PCM 解码到 OpenAL 绑定的缓冲区中,并保留部分 Vorbis 帧,而无需在每次填充时重新分配本机临时内存。
- 跨扬声器共享压缩缓存的 OGG 字节,同时保持独立的解码器状态。
- 用交错的块遍历替换重复的碰撞射线裁剪以实现声学遮挡。
- 缓存排序后的音频元数据快照和标准化的客户端搜索键。
可靠性与安全
- 添加显式流 ID、有序块、取消机制、引用计数的共享下载和安全的前向只读流重用。
- 使用单调本地播放时钟和延迟调整的状态快照,而不是跨机器比较墙钟时间。
- 验证扬声器交互距离、资源 ID、操作、搜索边界、音量、数据包收集大小、字符串、标头、块和采样率。
- 在注册前验证 OGG Vorbis 文件,并限制直接下载和转换的文件大小。
- 在支持的情况下,通过原子替换的临时文件保存元数据和缓存流。
- 强制执行配置的客户端缓存限制并清理不完整的缓存文件。
- 在断开连接、资源重载和重复的集成服务器生命周期之间重置服务器和客户端流媒体状态。
构建与发布管理
- 为 Minecraft 1.21.1 至 1.21.11、26.1、26.1.1、26.1.2 和 26.2 添加精确目标发布分支;
main分支对应 26.2。 - 将每个分支锁定到其匹配的 NeoForge 版本。Minecraft 1.21.x 使用 Java 21,而 Minecraft 26.x 使用 Java 25。
- 移除未使用的 Mixin 声明,并用无依赖的原版屏幕替换可选的 Cloth Config 屏幕。
- 为 OGG 索引、查找定位、分段缓冲、播放时钟、元数据索引、持久化和流共享添加单元测试。
- 添加明确的 alpha、beta 和 release 渠道映射,带有版本限定的 Minecraft 标签以及受保护的 GitHub 发布环境。
- 在 1.21.1、1.21.2、1.21.4、1.21.9、26.1 和 26.2 上通过专用服务器启动冒烟测试,以及 26.2 客户端资源和音频引擎启动冒烟测试。完整的多玩家与播放检查清单仍未进行测试。
更新日志
0.3.0-alpha.3
此 Alpha 版本修复了玩家报告的错误。它在所有目标平台上均通过编译和自动化测试。手动游戏内测试仍在进行中,因此该构建仍保持 Alpha 状态。
修复
- 在跳过零透明度颜色的目标上恢复扬声器和配置屏幕的文本显示。
- 直接运行 yt-dlp,而非使用 5 秒限制进行探测,这可能会将启动缓慢误报为“未找到”并阻塞服务器线程。
- 当 yt-dlp 失败时记录其输出,并在无法启动时记录
PATH。 - 在 Minecraft 1.21.1 至 1.21.8 中,使曲目列表高亮保持在选择框内。
0.3.0-alpha.1
这是一个 Alpha 构建。所有目标均通过编译和自动化测试,部分目标通过了服务器或客户端启动的冒烟测试,但每个已发布的 Minecraft 目标在升级为 Beta 之前仍需进行手动游戏内验证。
性能
- 将 OGG 页索引从全文件读取改为有界的顺序通道读取。
- 将服务器音频读取移出 tick 线程,按传输保留文件通道,预取两个块,并在全局和每玩家的字节预算下公平调度玩家。
- 移除客户端流媒体中的重复数据包拆分和全缓冲区缓存组装。
- 直接将 PCM 解码到 OpenAL 绑定缓冲区,并保留部分 Vorbis 帧,无需在每次填充时重新分配原生临时内存。
- 在多个扬声器间共享压缩缓存的 OGG 字节,同时保持独立的解码器状态。
- 用交错区块遍历替代重复的碰撞射线裁剪,以实现声学遮挡。
- 缓存排序后的音频元数据快照和标准化的客户端搜索键。
可靠性和安全性
- 添加显式流 ID、有序块、取消机制、引用计数的共享下载以及安全的前向只读流复用。
- 使用单调本地播放时钟和延迟调整的状态快照,取代跨机器比较墙钟时间。
- 验证扬声器交互距离、资源 ID、操作、寻址边界、音量、数据包收集大小、字符串、头部、块和采样率。
- 在注册前验证 OGG Vorbis 文件,并限制直接下载和转换文件的大小。
- 在支持的情况下,通过原子替换的临时文件保存元数据和缓存流。
- 强制执行配置的客户端缓存限制并清理不完整的缓存文件。
- 在断开连接、资源重载和重复的内部服务器生命周期之间重置服务器和客户端流媒体状态。
构建与发布管理
- 为 Minecraft 1.21.1 至 1.21.11、26.1、26.1.1、26.1.2 和 26.2 添加精确目标发布分支;
main分支针对 26.2。 - 将每个分支锁定到匹配的 NeoForge 版本。Minecraft 1.21.x 使用 Java 21,而 Minecraft 26.x 使用 Java 25。
- 移除未使用的 Mixin 声明,并用无依赖的原生界面替换可选的 Cloth Config 界面。
- 为 OGG 索引、寻址查找、分段缓冲、播放时钟、元数据索引、持久化和流共享添加单元测试。
- 添加显式的 Alpha、Beta 和 Release 频道映射,带有版本限定的 Minecraft 标签以及受保护的 GitHub 发布环境。
- 在 1.21.1、1.21.2、1.21.4、1.21.9、26.1 和 26.2 上通过专用服务器启动冒烟测试,以及 26.2 客户端资源和音频引擎启动冒烟测试。完整的多玩家和播放清单仍未进行测试。
更新日志
0.3.0-alpha.1
这是一个 alpha(测试)版本。所有目标平台均通过编译和自动化测试,部分目标平台通过了服务器或客户端启动的冒烟测试,但每个发布的 Minecraft 目标在升级为 beta(预发布)版本前仍需进行手动游戏内验证。
性能优化
- 将 OGG 页面索引从全文件读取改为有界的顺序通道读取。
- 将服务器音频读取移出 Tick 线程,保持文件通道在每次传输期间打开,预取两个数据块,并在全局和按玩家分配的字节预算下公平调度玩家。
- 移除客户端流式传输中重复的数据包拆分和完整缓冲区缓存组装。
- 直接将 PCM 解码到 OpenAL 绑定缓冲区,并保留部分 Vorbis 帧,避免在每次填充时重新分配本地临时内存。
- 共享压缩缓存的 OGG 字节,同时保持独立的解码器状态。
- 使用交错的方块遍历替代重复的碰撞射线裁剪,以实现声学遮挡效果。
- 缓存排序后的音频元数据快照和标准化的客户端搜索键。
可靠性与安全
- 添加显式流 ID、有序数据块、取消机制、引用计数的共享下载以及安全的单向流复用。
- 使用单调的本地播放时钟和延迟调整的状态快照,取代跨机器比较墙钟时间。
- 验证扬声器交互距离、资源 ID、操作、查找边界、音量、数据包收集大小、字符串、头部信息、数据块和采样率。
- 在注册前验证 OGG Vorbis 文件,并限制直接下载和转换文件的大小。
- 通过临时文件保存元数据和缓存流,并在支持的情况下使用原子替换。
- 强制执行配置的客户端缓存限制,并清理不完整的缓存文件。
- 在断开连接、资源重载和重复的内嵌服务器生命周期之间重置服务器和客户端流式传输状态。
构建与版本管理
- 为 Minecraft 1.21.1 至 1.21.11、26.1、26.1.1、26.1.2 和 26.2 添加精确的目标发布分支;
main分支针对 26.2。 - 将每个分支锁定到其匹配的 NeoForge 版本。Minecraft 1.21.x 使用 Java 21,而 Minecraft 26.x 使用 Java 25。
- 移除未使用的 Mixin 声明,并用无依赖的原版屏幕替换可选的 Cloth Config 屏幕。
- 为 OGG 索引、查找查找、分段缓冲、播放时钟、元数据索引、持久化和流共享添加单元测试。
- 添加显式的 alpha、beta 和 release 频道映射,包含带版本限定符的 Minecraft 标签以及受保护的 GitHub 发布环境。
- 在 1.21.1、1.21.2、1.21.4、1.21.9、26.1 和 26.2 上通过专用服务器启动冒烟测试,并通过 26.2 客户端资源和音频引擎启动冒烟测试。完整的多玩家和播放清单仍未测试。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧