Musicreater/docs/生成文件的使用说明.md

音·创 Musicreater

库版 Package Version

生成文件的使用说明

由于先前的 读我文件(README.md) 过于冗杂，现另辟蹊径来给大家全方位的教程。

这是本库生成后文件的相关说明，不是使用本库的教程，若要查看本库的演示程序使用教程，可点击此处

文件格式

1. 附加包格式（.mcpack）

   使用附加包格式导出音乐，则音乐会以指令函数文件（.mcfunction）存储于附加包内。在附加包中，函数文件的存储结构应为：

   • functions\
     • index.mcfunction
     • mscply\
       • progressShow.mcfunction
       • track1.mcfunction
       • track2.mcfunction
       • ...
       • trackN.mcfunction

   如图，其中，index.mcfunction文件和mscply文件夹存在于函数目录的根下；在mscply目录中，包含音乐导出的众多音轨播放文件（trackX.mcfunction），同时，若生成此包时选择了带有进度条的选项，则会包含progressShow.mcfunction文件。

   index.mcfunction用于开始播放，其中包含打开各个音轨对应函数的指令，以及加分指令，这里的加分，是将播放计分板的值大于等于1的所有玩家的播放计分板分数增加1。同时，若生成此包时选择了自动重置计分板的选项，则会包含一条重置计分板的指令。