SongPlayer

模组

· 作者 hhhzzzsss

一个用于 Minecraft 的 Fabric 模组,能够通过音符盒播放歌曲。支持 MIDI 格式。

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

需要前置:Fabric API

最新 3.3.5 · 1.21.10 · Fabric

一键开服(送7天)

SongPlayer

一款用于 Minecraft 的 Fabric 模组,可通过音符盒播放歌曲。

如果您有问题、想分享歌曲或只是想聊聊这个模组,欢迎加入我们的 Discord 服务器。

安装方法

您可以从 Releases(发布)页面下载模组的 jar 文件。 此模组需要 Fabric API。

添加歌曲

您可以将 MIDI 文件或 NoteBlockStudio 文件放入 .minecraft/songs 文件夹中。 SongPlayer 支持任何有效的 MIDI 文件以及所有版本的 NBS 文件。

使用客户端

要开始使用,请将一些 MIDI 或 NBS 文件添加到你的 songs 文件夹中,然后在开阔区域使用 $play <文件名>。 文件名和文件路径中不支持空格。 如果你提供了有效的 MIDI 或 NBS 文件,它将尝试将你的游戏模式设置为创造模式,放置歌曲所需的音符盒,然后尝试将你切换为生存模式,最后开始播放。

你也可以将歌曲整理到歌曲文件夹的子目录中。使用 Tab 补全功能可以轻松导航。也支持符号链接(symlinked)目录。

命令

所有命令都不区分大小写。

$help

$help <command>

如果未提供参数,则列出所有 SongPlayer 命令。 否则,将解释指定的命令并显示其语法。

$setPrefix <prefix>

别名:$prefix

设置用于所有 SongPlayer 命令的前缀(默认值为 $)

$play <文件名或链接>

播放位于 .minecraft/songs 文件夹中的某个 MIDI 文件;如果指定的是 URL,则会下载该链接处的歌曲并尝试播放。

如果当前已有歌曲正在播放,新添加的歌曲将被加入队列。

$stop

停止播放/构建并清空队列。

$skip

跳过当前歌曲,播放下一首。

$goto <mm:ss>

跳转到歌曲的指定时间点。

$loop

切换歌曲循环播放。

$status

别名:$current

获取当前正在播放的歌曲的状态。

$queue

别名:$showqueue

显示队列中的所有歌曲。

$songs

$songs <subdirectory>

别名:$list

如果未提供参数,则列出 songs 文件夹中的歌曲。否则,列出指定子目录中的歌曲。

$playlist play <播放列表>

$playlist create <播放列表>

$playlist list [<播放列表>]

$playlist delete <播放列表> <歌曲>

$playlist addSong <播放列表> <歌曲>

$playlist removeSong <播放列表> <歌曲>

$playlist renameSong <播放列表> <旧名称> <新名称>

$playlist loop

$playlist shuffle

创建、编辑、删除或播放播放列表。您还可以切换循环或随机播放。

$setCreativeCommand <command>

别名:$sc

默认情况下,客户端使用 /gamemode creative 进入创造模式。 然而,并非所有服务器都支持 /gamemode creative 命令。 如果服务器的创造模式指令不同,请使用以下命令进行设置: 例如,如果服务器使用的是原版指令,请执行 $setCreativeCommand /gamemode creative。

$setSurvivalCommand <command>

别名: $ss

默认情况下,客户端使用 /gamemode survival 进入生存模式。 然而,并非所有服务器都支持 /gamemode survival 命令。 如果服务器的生存模式命令不同,请使用此命令进行设置。 例如,如果服务器使用的是原版命令,请执行 $setSurvivalCommand /gamemode survival。

$useEssentialsCommands

别名:$essentials, $useEssentials, $essentialsCommands

切换为使用 Essentials 的模式命令。

相当于 $setCreativeCommand /gmc 和 $setSurvivalCommand /gms

$useVanillaCommands

别名:$vanilla, $useVanilla, $vanillaCommands

切换为使用原版模式命令。

相当于 $setCreativeCommand /gamemode creative 和 $setSurvivalCommand /gamemode survival

$toggleFakePlayer

别名:$fakePlayer, $fp

切换是否在播放歌曲时显示一个假人来代表你的真实位置。在播放歌曲时,由于会自动启用自由视角(freecam),你的真实位置与视觉位置会不同。假人会显示你实际所在的位置。默认情况下,此功能处于禁用状态。

$setStageType <DEFAULT | WIDE | SPHERICAL>

别名:$setStage, $stageType

设置要构建的音符盒舞台类型。感谢 Sk8kman 和 Lizard16 提供的球形舞台设计!

  • 默认(Default):方形舞台,最多包含 300 个音符盒
  • 宽幅(Wide):圆柱形舞台,最多包含 360 个音符盒
  • 球形(Spherical):紧密排列的球形舞台,可容纳全部 400 个可能的音符盒

$breakSpeed set <speed>

$breakSpeed reset

设置方块破坏速度(单位:方块/秒)。

$placeSpeed set <speed>

$placeSpeed reset

设置方块放置速度(单位:方块/秒)。

$toggleMovement <swing | rotate>

别名:$movement

切换是否在击打音符盒时挥动手臂并旋转视角以注视正在击打的音符盒。

$setVelocityThreshold <threshold>

别名:$velocityThreshold, $threshold

设置不会被播放的最小速度阈值(适用于 midi 和 nbs 格式)。该值必须为 0 到 100 之间的数字。对于歌曲物品,该阈值在物品创建时已固化。

$toggleAutoCleanup

别名:$autoCleanup

切换是否在播放结束后自动清理舞台并将方块恢复至原始状态。

$cleanupLastStage

清理最近创建的舞台,并尽力将方块恢复到其原始状态。

如果你停止播放并再次开始播放,记录的修改将会重置。

不会替换流体或双格方块(如门),也不会替换方块实体数据。 对于放置在其它方块上的方块(如火把等),可能也无法正确处理。

$announcement <enable | disable | getMessage>

$announcement setMessage

设置在你开始播放歌曲时发送的公告消息。 使用 setMessage 时,请在 [name] 处填入歌曲名称。

示例:$announcement setMessage &6正在播放: &3[name]

$toggleSurvivalOnly

别名:$survivalOnly

启用或禁用仅生存模式,在该模式下禁用自动放置音符盒,并通过右键点击进行自动调音。

在此模式下,你必须自行放置所需的乐器。

如果你尝试播放歌曲但未满足要求,它会告诉你每种类型的乐器需要多少个。

$toggleFlightNoclip

别名:$flightNoclip

切换飞行穿墙模式。启用后,你的本地玩家在播放歌曲时可以穿过方块,但仅限在飞行状态下生效。

$songItem create <歌曲或网址>

$songItem setSongName <名称>

别名:$item

将歌曲数据编码为物品。当你右键点击此类物品时,SongPlayer 会自动检测出这是歌曲物品,并询问你是否要播放它。这些物品一旦创建,任何使用对应版本 SongPlayer 的玩家都可以使用它们。

系统会自动生成自定义的物品名称和描述(lore),但这些内容可以被修改或删除,且不会影响歌曲数据本身,因此你可以随意编辑物品的名称与描述。SongPlayer 仅读取 SongItemData 标签中的数据。

$testSong

一个在开发期间用于测试的命令。
按顺序播放所有 400 种音符盒声音。

机制

SongPlayer 会放置已包含 NBT 和乐器数据的音符盒,因此无需单独对音符盒进行调音。

客户端会在每首歌曲播放前自动检测所需音符盒并自动放置,这使得播放歌曲变得相当简单。唯一的缺点是你需要能够在创造模式和生存模式之间切换,我的客户端将尝试自动完成此操作。

播放歌曲时,自由视角(freecam)将被启用。你可以自由移动,但实际上你只是在移动摄像机,而你的玩家角色保持在音符盒的中心位置。这是因为只有在你处于音符盒的交互范围内时才能播放它们,所以你必须站在音符盒中心来播放它们,但能在歌曲播放期间自由移动仍然很不错。

致谢

Ayunami2000:提出了直接放置带有 NBT 数据的音符盒而非手动调音的概念。

Sk8kman:SongPlayer 3.0 中的多项更改受到其 SongPlayer 分支版本的启发。最显著的是其替代舞台设计,这也激励我实现了播放列表和可切换的移动功能。

Lizard16: 据 Sk8kman 引用,他是球形舞台设计的制作人。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源