唱片机曲目定义格式

唱片机曲目（Jukebox Song）决定了物品插入唱片机后播放音乐的行为。唱片机曲目定义文件是唱片机曲目在数据包中的数据驱动定义文件。

定义格式

唱片机曲目在游戏内使用JUKEBOX_SONG注册表，数据包路径为jukebox_song，即所有唱片机曲目定义文件都需要在data/<命名空间>/jukebox_song目录内定义，唱片机曲目标签则需要在data/<命名空间>/tags/jukebox_song目录内定义。

唱片机曲目定义文件使用JSON格式，并具有下列结构：

• JSON文件根对象
  • *comparator_output: （0≤值≤15）唱片机播放该曲目时，通过红石比较器输出的红石信号强度。
  • *description：（文本组件），用于在提示框中显示曲目名称。
  • *length_in_seconds：（值>0）歌曲的播放时长，以秒为单位。游戏实际使用时将此值按TPS为20转换为游戏刻，并额外增加20游戏刻作为最终时长。此值可以与声音事件内的声音长度不同，游戏只使用此值控制唱片机的停止时间。
  • *sound_event：唱片机曲目播放的声音事件。此声音播放无视客户端传播距离。
    • 声音事件，见Template:Nbt inherit/sound event/source

定义行为

唱片机曲目定义数据仅在服务端启动时被加载一次，使用/reload命令不可以使唱片机曲目定义被重新加载，而必须重启服务端。

当唱片机内插入带有jukebox_playable物品堆叠组件的物品堆叠时，游戏会读取组件内的唱片机曲目信息，并进行播放。如果组件内的唱片机曲目不存在则什么也不会发生。

唱片机播放的音乐归属record（唱片机/音符盒）分类，声音实例音量为4，实例音高为1，立刻播放，音量线性衰减。玩家能听到音乐唱片音乐的最远距离为声音事件引用sound_id定义的attenuation_distance值乘上音量4，即默认为64格；而声音事件内的range在此不参与声音计算，游戏以世界事件发送唱片机播放信息，因此无视声音事件传播距离。

历史

Java版
1.21			24w21a				向数据包中加入了唱片机曲目。