SoundtrackPlayer

插件

· 作者 Cotii_Art

此模组允许你在不在世界/服务器中时也能播放持久歌曲或声音。

0 本站下载 0 关注 更新于 1 个月前

最新 1.0.1+1.20.1+neoforge · 1.20.1 · NeoForge

一键开服(送7天)

在 Minecraft 中播放你自己的音乐,并确保所有玩家都保持在歌曲的同一秒。使用声音事件、资源包中的 ogg 文件、指向 ogg/mp3/wav 文件的直接链接或任意链接:YouTube、SoundCloud、视频等。

命令:

/soundtrack <play/stop/list>

/soundtrack play <id> resource <sound> [volume] [fadeinTicks] [fadeoutTicks] [loop] [fadeloop] [pitch] [category]

/soundtrack play <id> url <link> [volume] ...

/soundtrack stop <id/all> [fadeoutTicks]

选择 resource,标签补全会显示你的 soundtracks 文件夹中的文件以及模组和原版的声音。选择 url 并粘贴链接。不需要引号。

Soundtracks 文件夹

将你的 .ogg 文件放入资源包内的 assets/<namespace>/soundtracks/ 中,无需 sounds.json。按 F3+T,它们会在标签补全中显示为 namespace:soundtracks/song.ogg。

链接

粘贴指向 ogg、mp3 或 wav 文件的直接链接即可播放。每个玩家只需下载一次,并将其缓存。

也可以链接到 YouTube 或 SoundCloud 等页面以及视频(mp4、webm...)。首次使用时,模组会从官方页面静默下载其所需的免费工具(yt-dlp、deno 和 ffmpeg),无需手动安装。

玩家可以在 config/soundtrackplayer.json 中关闭链接功能。

始终同步

如果某人迟到加入、离开后重新加入,或重载资源包,歌曲会从与其他人相同的秒数开始播放。循环也是如此。F3+T 和暂停菜单不再切断音乐。

淡入、循环和类别

  • fadein / fadeout: 以刻(ticks)为单位(20 = 1 秒)
  • 带淡出的停止: stop 中的 fadeout 会覆盖歌曲开始时使用的 fadeout。留空则使用原始设置
  • fadeloop: true 会在每次循环时淡入淡出,false 仅在第一次启动和停止时淡入淡出
  • pitch: 0.5 到 2.0,同时改变速度
  • category: 默认为 SOUNDTRACKS,也可以是任何原版类别如 MUSIC、AMBIENT 或 RECORDS,以跟随相应的音量滑块

使用相同的 id 和声音再次运行命令会实时更改音量、音调或淡入淡出效果,歌曲会继续从当前位置播放。你自定义的 soundtracks 在离开和进入世界后也会继续播放。

Soundtracks 滑块

“音乐与声音”设置中新增了一个“Soundtracks”滑块,用于控制 SOUNDTRACKS 类别下所有音效的音量。已翻译成 20 种语言。

服务器

  • Paper/Spigot: 使用 SoundtrackplayerPLUGIN 插件:/soundtrackplugin play <@a/player> <id> <url/resource> <link/sound> ... 和 /soundtrackplugin stop <@a/player> <id/all> [fadeoutTicks]。它会保存所有状态,因此后来加入的玩家会在同一时间听到相同的内容。标签补全会显示当前正在播放的 id 以及你的玩家拥有的自定义声音。
  • 单人游戏、Fabric、NeoForge 和 Forge 服务器: 使用你自己模组中的 API。

API

服务端(支持所有加载器,包括单人游戏):

Soundtrack boss = Soundtrack.builder("boss", "soundtrackplayer:soundtracks/boss.ogg")
        .volume(0.8f).fadeIn(40).fadeOut(60).loop(true).build();
SoundtrackPlayerAPI.playForAll(server, boss);
SoundtrackPlayerAPI.play(player, boss);
SoundtrackPlayerAPI.stopForAll(server, "boss", 100);

客户端:使用 SoundtrackClientAPI 播放本地音轨、停止它们、读取或更改 Soundtracks 音量,并监听音轨的开始和停止。

插件:SoundtrackPlayerAPI.get() 提供与 Paper 插件相同的方法,以及当拥有该模组的玩家加入时触发的 SoundtrackClientReadyEvent。

源代码和文档:

适用于 Fabric 1.20.1 - 26.2、NeoForge 1.20.1 - 26.2 和 Forge 1.20.1 / 1.20.4。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源