Skip to content

资源文件说明

由于模拟器本身不提供资源文件,因此需要用户自行上传谱面、音乐、图片等资源文件。

结构

你可以单独上传谱面、音乐、图片等资源文件,也可以将它们打包为 zip 文件后上传。

特别地,如果浏览器支持,你还可以直接上传包含它们的文件夹。

  • 谱面文件:必需,通常为官谱 JSON 格式,也可以是支持的非官谱格式谱面。

  • 背景音乐:可选,与谱面同时播放的音乐。

    • 也支持视频文件的音乐播放,如果浏览器支持还可以将背景图片替换为视频。
    • 未上传音乐播放谱面时,不会播放音乐,时长显示为谱面时长[1]
  • 背景图片:可选,通常为曲绘封面,谱面播放时置于背景。
    • 未上传图片播放谱面时,背景显示为纯白。
    • 背景缩放采用“center+cover”的策略[2]
    • gif等动态图片将取第一帧以静态图显示。
  • info.csv:可选,用于自动填写谱面信息,详见下文。

  • line.csv:可选,用于替换指定判定线贴图,详见下文。

支持的文件格式仅供参考,以浏览器实际支持为准。

info.csv

置于 zip 文件根目录,用于自动填写谱面信息。参考:csv 标准文档

格式示例:

csv
,Chart,Music,Image,Name,Artist,Level,Illustrator,Charter,AspectRatio,NoteScale,GlobalAlpha
,谱面,音乐,图片,名称,曲师,等级,曲绘,谱师,宽高比,按键缩放,背景变暗
,SpasmodicSP.json,SpasmodicSP.ogg,SpasmodicSP.png,Spasmodic(Haocore Mix),姜米條 Remixed by Daily,SP Lv.?,笔记RE,"Phigros Spasming Team ""無極病院""",1.777778,1,0.6
,Theme Of SSS.pec,Theme Of SSS.mp3,Theme Of SSS.jpg,Theme Of SSS,ANANT-GARDE EYES,AB Lv.12,《Angel Beats!》,Tachibana InterJoke,1.461538,0.9,0.8
属性说明
Chart谱面(zip 文件内完整路径)
Music音乐(zip 文件内完整路径)
Image图片(zip 文件内完整路径)
Name名称(显示在画面左下角)
Artist曲师(显示于过渡动画)
Level等级(显示在画面右下角)
Illustrator曲绘(显示于过渡动画)
Charter谱师(显示于过渡动画)
AspectRatio宽高比(画面宽度与高度的比值,默认 1.777778,即 16:9)
NoteScale按键缩放(数值越大 Note 越大,默认 1)
BackgroundDim背景变暗(背景不透明度,数值越大背景越暗,默认 0.6)

line.csv

置于 zip 文件根目录,用于替换指定判定线贴图。参考:csv 标准文档

格式示例:

csv
,Chart,LineId,Image,Scale,Aspect,UseBackgroundDim,UseLineColor,UseLineScale
,谱面,判定线id,图片,缩放,拉伸,跟随背景变暗,跟随FC/AP指示器着色,使用判定线缩放策略
,SpasmodicSP.json,20,.0.png,1,1,0,0,1
,SpasmodicSP.json,21,.1.png,1,1,0,1,1
,SpasmodicSP.json,22,.2.png,4,1,1,1,0
,SpasmodicSP.json,23,.3.png,4,1,1,1,0
属性说明
Chart谱面(zip 文件内完整路径)
LineId判定线 id(即判定线数组下标,从 0 开始)
Image图片(zip 文件内完整路径)
Scale缩放(将图片以画面单位高度(画面高度/1080)整体缩放,默认 1)
Aspect拉伸(将图片水平拉伸至原来的若干倍,默认 1)
UseBackgroundDim跟随背景变暗(1:是;0:否,即图片亮度不受背景变暗的影响;默认 0)
UseLineColor跟随 FC/AP 指示器着色(1:是;0:否,即图片亮度不受 FC/AP 的影响;默认 0)
UseLineScale使用判定线缩放策略(1:是,即宽高比小于 3:4 时缩放受画面宽度影响;0:否;默认 1)

隐藏文件

.开头的文件和文件夹将被隐藏,不会显示在选项框,通常用于存放配置文件所需的资源。

例:上传的.line.png文件将不会显示在图片选项框中,但可以在line.csv中使用。

非官谱格式的谱面及其配置文件

Working in progress...

备注

  1. 谱面最后一个 Note 的结算时间和最后一个事件的结束时间的较大值(去掉 ≥1e9 的数值)。

  2. 保持图片居中、宽高比不变并尽可能大的缩放图片,直到图片恰好完全覆盖背景。

CC-BY-NC-4.0 Licensed