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 引用,他是球形舞台设计的制作人。
SongPlayer
A Fabric mod for Minecraft that plays songs with noteblocks.
If you have questions, want to share songs, or just want to talk about the mod, then come over to the discord server.
How to install
You can grab the mod jar from releases section. This mod requires fabric api.
Adding songs
You can put midis or NoteBlockStudio files in the .minecraft/songs folder.
SongPlayer supports any valid midi and all versions of NBS files.
Using the client
To get started, add some midis or nbs files to your songs folder, and use $play <filename> in an open area.
Spaces are not supported in filenames or filepaths.
If you have provided it a valid midi or nbs file, it will try to set your gamemode to creative, place the required noteblocks for the song, try to switch you to survival, then start playing.
You can also organize songs into subdirectories in your songs folder. Tab completion will make it easy to navigate. Symlinked directories are supported too.
Commands
All the commands are case insensitive.
$help
$help <command>
If no arguments are given, lists all SongPlayer commands. Otherwise, explains the specified command and shows its syntax.
$setPrefix <prefix>
aliases: $prefix
Sets the prefix used for all SongPlayer commands (by default: $)
$play <filename or url>
Plays a particular midi from the .minecraft/songs folder, or, if a url is specified, downloads the song at that url and tries to play it.
If there is a song already playing, the new song will be added to the queue.
$stop
Stops playing/building and clears the queue.
$skip
Skips the current song and goes to the next one.
$goto <mm:ss>
Goes to a specific time in the song.
$loop
Toggles song looping.
$status
aliases: $current
Gets the status of the current song that is playing.
$queue
aliases: $showqueue
Shows all the songs in the queue.
$songs
$songs <subdirectory>
aliases: $list
If no arguments are given, lists songs in the songs folder. Otherwise, lists songs in the specified subdirectory.
$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
Create, edit, delete, or play playlists. You can also toggle looping or shuffling.
$setCreativeCommand <command>
aliases: $sc
By default, the client uses /gamemode creative to go into creative mode.
However, /gamemode creative does not work on all servers.
If the creative command is different, set it with this command.
For example, if the server uses vanilla commands, do $setCreativeCommand /gamemode creative.
$setSurvivalCommand <command>
aliases: $ss
By default, the client uses /gamemode survival to go into survival mode.
However, /gamemode survival does not work on all servers.
If the survival command is different, set it with this command.
For example, if the server uses vanilla commands, do $setSurvivalCommand /gamemode survival.
$useEssentialsCommands
aliases: $essentials, $useEssentials, $essentialsCommands
Switch to using Essentials gamemode commands.
Equivalent to $setCreativeCommand /gmc and $setSurvivalCommand /gms
$useVanillaCommands
$aliases: $vanilla, $useVanilla, $vanillaCommands
Switch to using vanilla gamemode commands.
Equivalent to $setCreativeCommand /gamemode creative and $setSurvivalCommand /gamemode survival
$toggleFakePlayer
aliases: $fakePlayer, $fp
Toggles whether a fake player will show up to represent your true position while playing a song. When playing a song, since it automatically enables freecam, your true position will be different from your apparent position. The fake player will show where you actually are. By default, this is disabled.
$setStageType <DEFAULT | WIDE | SPHERICAL>
aliases: $setStage, $stageType
Sets the type of noteblock stage to build. Thanks Sk8kman and Lizard16 for the spherical stage design!
- Default: A square shaped stage with a maximum of 300 noteblocks
- Wide: A cylindrical stage with a maximum of 360 noteblocks
- Spherical: A densely packed spherical stage that can contain all 400 possible noteblocks
$breakSpeed set <speed>
$breakSpeed reset
Sets the block breaking speed in blocks/sec.
$placeSpeed set <speed>
$placeSpeed reset
Sets the block placement speed in blocks/sec.
$toggleMovement <swing | rotate>
aliases: $movement
Toggles whether you swing your arm when hitting a noteblock and rotate to look at the noteblocks you are hitting.
$setVelocityThreshold <threshold>
aliases: $velocityThreshold $threshold
Sets the minimum velocity below which notes won't be played (applies to midi and nbs). This must be a number from 0 to 100. For song items, the threshold is baked in upon item creation.
$toggleAutoCleanup
aliases: $autoCleanup
Toggles whether you automatically clean up your stage and restore the original blocks after playing.
$cleanupLastStage
Cleans up the most recent stage that you made and does its best to restore the blocks to their original state.
If you stop playing and start playing again, the recorded modifications gets reset.
Will not replace fluids or double blocks such as doors, and does not replace tile entity data. May not properly handle blocks that rest on other blocks such as torches, either.
$announcement <enable | disable | getMessage>
$announcement setMessage
Set an announcement message that is sent when you start playing a song.
With setMessage, write [name] where the song name should go.
Example: $announcement setMessage &6Now playing: &3[name]
$toggleSurvivalOnly
aliases: $survivalOnly
Enables or disables survival-only mode, in which automatic noteblock placement is disabled and automatic tuning is done by right-clicking.
In this mode, you must place the necessary instruments yourself.
If you try to play a song and the requirements are not met, it will tell you how many instruments of each type you need.
$toggleFlightNoclip
aliases: $flightNoclip
Toggles flight noclip. When enabled, your local player can clip through blocks when playing a song, but only while flying.
$songItem create <song or url>
$songItem setSongName <name>
aliases: $item
Encodes song data into an item. When you right click on such an item, SongPlayer will automatically detect that it is a song item and ask if you want to play it. These items, once created, can be used by anyone that is using the necessary version of SongPlayer.
It will automatically generate custom item names and lore, but these can be modified or deleted without affecting the song data, so feel free to edit the items as you wish. SongPlayer only looks at the SongItemData tag.
$testSong
A command I used for testing during development. It plays all 400 possible noteblock sounds in order.
Mechanism
SongPlayer places noteblocks with nbt and instrument data already in them, so the noteblocks do not need to be individually tuned.
The client will automatically detect what noteblocks are needed and place them automatically before each song is played, which makes playing songs quite easy. The only drawback is that you need to be able to switch between creative and survival mode, which my client will attempt to do automatically.
When playing a song, freecam is enabled. You will be able to move around freely, but in reality you are only moving your camera while your player stays at the center of the noteblocks. This is because noteblocks can only be played if you're within reach distance of them, so you have to stand at the center of the noteblocks to play them, but it's still nice to be able to move around while your song is playing.
Acknowledgements
Ayunami2000: Came up with the concept of directly placing noteblocks with nbt data instead of manually tuning them.
Sk8kman: Several of Songplayer 3.0's changes were inspired by their fork of SongPlayer. Most notably was their alternate stage designs, but it also motivated me to implement playlists and togglable movements.
Lizard16: Cited by Sk8kman as the person who made the spherical stage design.
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
下载 SongPlayer
- 修复假玩家崩溃
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧