「于垂花门后」节奏模式MOD/资源包制作图文教程

节奏模式的设计相较之前的其它游戏功能MOD制作更加复杂,请各位MOD制作者仔细阅读本教程。
由于涉及视频制作,此模式并未提供模板,自定义资源包储存路径为“创意工坊项目/节奏舞台/节奏模式”。

文件夹内容:
必须文件
参数.txt
主要节奏.csv
主要视频.ogv
主要音频.mp3
可选文件-分支
失败节奏.csv
失败视频.ogv
失败音频.mp3
成功节奏.csv
成功视频.ogv
成功音频.mp3
可选文件-样式
完美音效.mp3
很好音效.mp3
普通音效.mp3
节拍图标.png
判定图标.png
请注意,请不要修改以上文件的文件名称,以防止游戏无法识别。

参数.txt
一共有5行内容,只使用英文逗号,以UTF-8格式储存:
暂停次数,
是否有限暂停时间,
暂停时间,
速度,
是否有分支画面,
暂停次数为玩家可以在单次游玩重暂停的次数,只能填入阿拉伯数字。
是否有限暂停时间为设置在游玩中玩家的暂停为“无限暂停只能手动取消”,还是“在设定暂停时间倒计时结束后,自动取消暂停”,仅能使用汉字的“是”或“否”。
暂停时间为如果设置了存在有限暂停时间,则需要设置对应的暂定时间,必须为整数,单位为秒,只能填入阿拉伯数字。
速度,从节拍图标出现到移动到判定区域的时间,可以使用整数或者小数(浮点数),单位为秒,只能填入阿拉伯数字和小数点。
在音乐节奏游戏中,节拍图标会在显示画面外生成,并移动至判定区域,玩家则需要在节拍图标位于判定区域时及时按下按键,而“速度”设置则是会影响节拍图标移动的速度,设置的值越大,那么移动至判定区域的时间就越久,则速度越慢,反之设置的值越小,那么移动至判定区域的时间就越短,则速度越快。
并且,这个设置会影响主要节奏.csv、失败节奏.csv、成功节奏.csv的内容,这点会在下一部分进一步说明。
是否有分支画面为设置在玩家成功通过或者通过失败后是否存在对应的额外关卡,仅能使用汉字的“是”或“否”。
如果设置为“是”,则项目中必须附带“可选文件-分支”中的所有文件。
在节奏模式中,失败的唯一方式为,玩家主动点击ESC键放弃。

一个完整但简单的参数.txt为:
暂停次数,3
是否有限暂停时间,是
暂停时间,3
速度,3
是否有分支画面,是

主要节奏.csv(失败节奏.csv,成功节奏.csv)文件则是节拍图标生成的时间点,以CSV UTF-8格式储存,如果使用文本编辑器打开则会是:
1.1
2.1
...
内容可以使用整数或者小数(浮点数),只能填入阿拉伯数字和小数点,单位为秒,最小单位为0.1秒,由小到大顺序排列。
注意:这个数值为节拍图标生成的时间点,而不是位于判定区域的时间点,假设如果希望节拍图标命中的时间点为歌曲的第7.1秒,并且设置的速度为5(秒),那么在csv文件中就应该填写2.1。

主要视频.ogv(失败视频.ogv,成功视频.ogv)文件则可以通俗理解为歌曲的MV,储存格式为.ogv,建议使用ffmpeg进行格式的转换等处理。
注意:为了保证音乐游戏的准确性,在资源管理中,视频与音频将会分开进行处理(时间计算以音频的解析为主),所以不建议在ogv视频文件中也添加音轨(音轨单独保存为.mp3文件)。

主要音频.mp3(失败音频.mp3,成功音频.mp3)文件则是歌曲本身,储存格式为.mp3。
在节奏模式中,所有的判定以音频为主,所以请无比保证视频文件长度等于音频文件。

额外可选文件:
完美音效.mp3为当节拍图标完美判定时,发出的音效。
很好音效.mp3为当节拍图标略微有偏差判定时,发出的音效。
普通音效.mp3为当节拍图标偏差有些大的判定时,发出的音效。
节拍图标.png为显示的节拍图标的的图案样式,要求为120*120像素。
判定图标.png为判定区域的的图案样式,要求为120*120像素。
有关于节拍图标与判定图标,注意实际的判定区域仅有100像素宽,所以在绘制时,可以留出一部分空白边框空间。