MIDI 播放器:铜管版

MIDI 播放器:铜管版

采用hhhzzzsss的SongPlayer模组,并添加26.1版本及铜管乐器支持

装饰

这是 hhhzzzsss 所开发 SongPlayer 模组的一个分支,新增了对 26.1/26.2 的支持,并兼容新的铜管乐器。

免责声明:我与 SONGPLAYER 的开发者没有任何关联,请勿向 HHHZZZSSS 寻求关于本模组的支持!!!

该模组的原始 readme 如下(已移除支持链接,因为本分支与原版 SongPlayer 模组无关,寻求本模组支持的人不应前往原模组的支持页面):

SongPlayer

一个使用音符盒播放歌曲的 Minecraft Fabric 模组。

如何安装

你可以从 releases 部分获取模组 jar 文件。 此模组需要 fabric api。

添加歌曲

你可以将 midi 或 NoteBlockStudio 文件放入 .minecraft/songs 文件夹。 SongPlayer 支持任何有效的 midi 以及几乎所有版本的 NBS 文件(该模组目前尚不支持 NBS 文件中的铜管乐器)。

使用客户端

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

你还可以在 songs 文件夹中将歌曲组织到子目录中。Tab 补全功能将使导航变得轻松。也支持符号链接目录。

命令

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

$help

$help <command>

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

$setPrefix <prefix>

别名:$prefix

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

$play <filename or url>

播放 .minecraft/songs 文件夹中的特定 midi,或者,如果指定了 url,则下载该 url 处的歌曲并尝试播放。

如果已经有歌曲正在播放,新歌曲将被添加到队列中。

$stop

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

$skip

跳过当前歌曲并转到下一首。

$goto <mm:ss>

跳转到歌曲中的特定时间。

$loop

切换歌曲循环。

$status

别名:$current

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

$queue

别名:$showqueue

显示队列中的所有歌曲。

$songs

$songs <subdirectory>

别名:$list

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

$playlist play <playlist>

$playlist create <playlist>

$playlist list [<playlist>]

$playlist delete <playlist> <song>

$playlist addSong <playlist> <song>

$playlist removeSong <playlist> <song>

$playlist renameSong <playlist> <old name> <new name>

$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

别名:$velocityThreshold、$threshold

设置最小力度,低于该力度的音符将不会被播放(适用于 midi 和 nbs)。这必须是 0 到 100 之间的数字。对于歌曲物品,阈值在物品创建时即被固化。

$toggleAutoCleanup

别名:$autoCleanup

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

$cleanupLastStage

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

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

不会替换流体或门之类的双层方块,也不会替换方块实体数据。 也可能无法正确处理放置在其它方块上的方块,如火把。

$announcement <enable | disable | getMessage>

$announcement setMessage

设置当你开始播放歌曲时发送的公告消息。 使用 setMessage 时,在歌曲名称应出现的位置写入 [name]。

示例:$announcement setMessage &6Now playing: &3[name]

$toggleSurvivalOnly

别名:$survivalOnly

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

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

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

$toggleFlightNoclip

别名:$flightNoclip

切换飞行穿墙。启用后,你的本地玩家在播放歌曲时可以穿墙,但仅在飞行时有效。

$songItem create <song or url>

$songItem setSongName <name>

别名:$item

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

它会自动生成自定义物品名称和描述,但这些可以修改或删除而不影响歌曲数据,因此你可以随意编辑这些物品。SongPlayer 只查看 SongItemData 标签。

$testSong

我在开发期间用于测试的命令。 它会按顺序播放全部 400 个可能的音符盒声音。

机制

SongPlayer 放置的音符盒已经带有 nbt 和乐器数据,因此音符盒无需单独调音。

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

播放歌曲时会启用自由视角(freecam)。你可以自由移动,但实际上你只是在移动你的视角,而你的玩家仍停留在音符盒的中心。这是因为只有当你在音符盒的触及距离内时才能播放它们,所以你必须站在音符盒的中心才能播放,但在歌曲播放时能够四处移动仍然很不错。

致谢

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

Sk8kman:Songplayer 3.0 的若干更改受到其 SongPlayer 分支的启发。最显著的是其替代舞台设计,但这也促使我实现了播放列表和可切换动作。

Lizard16:被 Sk8kman 引用为球形舞台设计者。


hhhzzzsss:SongPlayer 模组的主要开发者,本模组基于其开发。