noteblock-assistant

用于制作音符盒歌曲的实用模组。

工具

Note Block Assistant

无 AI 软件

Note Block Assistant 由人工倾心打造,是对编程艺术的热爱之作,也秉承了用自己的双眼探究软件内部构造的传统。

本模组中没有任何代码由 LLM 或“AI”工具生成。

概述

Note Block Assistant 是一个用于制作音符盒歌曲的实用模组。它旨在将我个人制作音符盒歌曲时的手动步骤自动化,尤其是压缩步骤。如果你也觉得它有帮助,那真是太好了!

Note Block Assistant 提供三个命令:

  • /nba generate 生成一个模板,包含指定的长度和拍号参数,以及乐器方块(即放置在音符盒下方的方块)。
  • /nba select 加载已完成的歌曲并进行校验,为压缩做好准备。
  • /nba placeCompact 将歌曲的压缩版本放置到世界中。你可以指定压缩版本的长度,也可以让命令自动选择一个长度,使结果尽可能接近正方形,以获得最佳聆听效果。(压缩后歌曲的截图见画廊!)

Note Block Assistant 需要 Fabric API 才能工作。它不需要任何配置;你只需将它添加到客户端(用于单人游戏)或服务器即可使用!

使用方法

注意:建议在安装 Note Block Assistant 的同时安装 WorldEdit。Litematica 也很有用(实际上是必需的),可用于在生存模式下建造最终歌曲。

Note Block Assistant 在超平坦风格的世界中效果最佳。

生成模板

要开始一首新歌,请使用 /nba generate 命令生成模板。该命令的形式为:/nba generate <measures> <beatsPerMeasure> <subdivisionsPerBeat> <subdivisionDelay> <instrumentBlock> [additional instrument blocks...]

各时间参数的作用如下:

  • measures:控制歌曲模板中生成多少个小节。

  • beatsPerMeasure:控制每个小节生成多少拍。这通常是乐谱中拍号的上方数字;例如,如果你的歌曲是 3/4 拍,则输入 3。对于某些拍号,选择其他数字可能更有用——例如在 6/8 拍中,传统做法是每小节两拍、每拍三个细分。

  • subdivisionsPerBeat:控制将小节中每一拍分割成多少份。它代表歌曲中可能出现的最短音符。例如,在 3/4 拍中,如果你最短的音符是八分音符,则使用 2;如果你的歌曲有十六分音符,则改用 4。如果你使用 6/8 这样的复合拍号,则需要相应调整细分:每小节两拍时,如果想包含十六分音符,则 subdivisionsPerBeat 应使用 6。

  • subdivisionDelay:控制每个细分的长度——也就是歌曲的速度。Note Block Assistant 生成的歌曲是一排排音符盒(或占位方块),中间用中继器控制每个音符之间的时间;因此,这个数字就是每个生成的中继器所设置的刻数。可设为 1、2、3 或 4,每个中继器刻等于 0.1 秒。示例:

    • 当 subdivisionsPerBeat 为 2、subdivisionDelay 为 2 时,每个细分长 0.2 秒,每拍长 0.4 秒,最终速度为 150 bpm。
    • 当 subdivisionsPerBeat 为 3、subdivisionDelay 为 1 时,每个细分长 0.1 秒,每拍长 0.3 秒,最终速度为 200 bpm。

    该系统确实限制了可实现的速度,但这通常是不可避免的。你需要选择细分延迟,以尽可能接近目标速度。

虽然 Note Block Assistant 只生成单一细分延迟的模板,但选择和压缩系统会保留你对中继器时序所做的修改。因此,如果你的歌曲以八分音符为主要细分,只有少数更短的音符,可以基于八分音符生成模板,然后在一处调整以加入更短的音符。请记住,如果你缩短了一个中继器,要么需要加长下一个中继器来补偿,要么将模板的剩余部分整体平移(WorldEdit 对这类修改很有用)。

在时间参数之后,你可以输入最多九个乐器方块参数。这些是 Minecraft 方块,将生成在音符盒所在位置的下方。如果你想要一首同时具有木琴和长笛音色的歌曲,可以使用 minecraft:bone_block minecraft:clay 生成两条轨道,一条用于木琴,一条用于长笛。注意,每条轨道只能演奏一个音符,所以如果你想让木琴演奏和弦,可能需要添加额外的 minecraft:bone_block 来获得更多轨道。你随时可以使用 minecraft:air 生成一条没有乐器方块的轨道。

虽然模板生成器每条轨道只限于一个乐器方块,但你可以更换乐器方块来临时改变音色,而选择/压缩系统会保留这些更改。因此,例如如果你想加入打击乐,即使使用多种乐器,也可能只需一两条轨道。一个在底鼓和军鼓之间交替的节拍可以在一条轨道上完成:使用 minecraft:stone 生成轨道用于底鼓,然后将军鼓的节拍替换为沙子,再将模式重复到歌曲结尾(WorldEdit 的 //stack 命令非常适合重复模式)。

创作你的歌曲

生成模板后,你面前会出现一排方块。这是你的标记线。它起到时间线的作用,显示小节和拍子的对齐位置,便于跟踪。钻石块标记每个小节的第一个音符,金块标记该小节中后续每一拍的第一个音符。

在标记线的右侧,会生成你的轨道。轨道以三个为一组生成,中间轨道上放置中继器以传递红石信号。第二层的平滑石头方块是音符占位块;将它们替换为音符盒以添加音符。注意,在每个组内,第一条轨道生成在中间,第二条轨道生成在左侧,第三条生成在右侧。这是因为如果一个组只有一条轨道,它需要位于中间有中继器的位置。因此,如果你生成了九条轨道的模板,布局将是:

M   2 1 3   5 4 6   8 7 9

这起初可能令人意外,但它在压缩后能得到最高效的最终布局。

要试听你的歌曲,只需用红石线将按钮连接到每条中间轨道的第一块音符盒或占位块。按下按钮,然后在歌曲上方飞行,以保持在能听到的位置。(完成后,压缩功能会生成一个你可以站在原地聆听的歌曲版本。)

压缩你的歌曲

当你把一切调整到理想状态后,Note Block Assistant 可以接收你完成的歌曲,通过将轨道折叠在一起使音符盒相互交错,并将每组三条轨道放在单独的一层上,从而生成一个紧凑版本。这样,你的歌曲就从一条漫长、笨重(但易于编辑)的线,变成一个尽可能占用最小空间的 3D 建筑,如有需要可以在生存模式下建造。(用 WorldEdit 也能做到这一点,但需要一些数学计算和大量麻烦,这也是本模组最初被创建的原因。)

要压缩你的歌曲,首先站在标记线上第一个钻石块的顶部,面朝标记线的另一端。然后使用命令 /nba select <tracks>,其中 tracks 是你歌曲中的轨道数。Note Block Assistant 会朝你面向的方向扫描标记线以计算歌曲长度,然后扫描并存储所有音符盒、乐器方块、中继器和占位块。

因此,虽然你可以在创作过程中更换乐器方块、缩短/加长歌曲,但你的标记线必须保持不间断,并且你不能改变轨道相对于标记线的位置。

Note Block Assistant 会告诉你它找到的歌曲长度。如果正确,就飞到附近的位置并运行 /nba placeCompact 生成压缩版本。为了减少生存模式下建造所需的资源,Note Block Assistant 会自动从压缩版本中移除任何不需要的音符占位块和乐器方块,因此无需事先手动处理。默认情况下,每一层都会生成一层玻璃地板,以便于建造并托住沙子或沙砾等会掉落的乐器方块。你可以使用 WorldEdit 将地板替换为其他方块,或按需移除。你也可以在这一阶段将平滑石头方块替换为任何其他可被充能的固体方块。

默认情况下,Note Block Assistant 生成的压缩歌曲尽可能接近正方形,这样你可以站在中心,所有音符盒都处于最小距离内,都能被听到。但是,如果你的歌曲需要放入特定区域,生成一个不同的矩形形状可能更有用。如果是这种情况,你可以使用 /nba placeCompact <length> 指定矩形一边的长度(以方块为单位),歌曲将自动调整宽度以容纳该长度。注意,在一个方向上需要额外的长度,以便红石线在每一行末端绕回,因此虽然音符盒会被纳入你指定的尺寸内,但最终形状会根据你选择矩形的哪一边作为 <length> 而略有不同。

一旦你对压缩歌曲的形状满意,就可以将其作为参考在生存模式下建造(Litematica 模组是迄今为止最好的方法)。然后,连接一个红石电路,同时为每一层的第一个音符盒供能。实现方法有很多,取决于你希望如何触发歌曲以及建造地点,因此 Note Block Assistant 不生成这一部分。