Level file format specifications

A Sunniesnow level file usually has the extension .ssc.

Table of contents

File structure

It is a ZIP file that contains files that are essential to a level.

All file entires in the ZIP file should not be contained in any directory. At least one music file and one chart file should be included. Other optional files includes background files and readme files. How a file will be treated is purely determined by its filename (mainly by its extension).

Music file

A music file is an audio file. Whether a file is regarded as a music file is determined by its filename extension.

The following formats of audio are supported:

Although other formats are not supported, their filename extensions are still recognized.

Chart file

A chart file is a text file that contains the chart data. It is a JSON file, with the filename extension .json.

See Chart file specifications for more information.

Background file

A background file is an image file. Whether a file is regarded as a background file is determined by its filename extension. The supported formats are determined by the player’s browser. Although other formats are not supported, their filename extensions are still recognized.

Readme file

The contents of a readme file will be displayed below the game interface. Any markdown files or plain text files are regarded as readme files. Other filenames that are recognized as readme files are those that start with (they are all case-insensitive and the underscores in them can be omitted):

Markdown files will be sanitized. Do not try to be a bad boy!

Mime type

The mime type of a Sunniesnow level file is application/zip. It is also OK to use application/octet-stream.