Skip to content

How to create and use the songData.json file

EndersteveGamer edited this page May 22, 2022 · 1 revision

How to create and use the songData.json file:

The songData.json file is a very important file, as it will define which characters and backgrounds are used in the song

First create a songData.json file in the folder of the song you want to edit. Then, write {} in the file, and add the following things:

"Stage":
To choose which background is used in the song, add {"stage": stage name here}. The stage name is the same as the folder where the background is. If no stage is specified, a default black background will be used

"character1" or "character2":
To choose the characters used in the song, use {"character1": character data here} or {"character2": character data here"}
"character1" defines the opponent's character and "character2" defines the player's character
The character data should look like {"Name": character name here, "pos": character pos here, "size": character size here}
The character name is the same as the name of the folder where the character is saved
The character pos should look like [character x pos here, character y pos here]. The 0, 0 point is the bottom left of the screen (bottom right for the player's character)
The character size should look like [left anim size here, down anim size here, up anim size here, right anim size here, idle anim size here]. Each animation size should look like [x size ratio, y size ratio]. Each size ratio is a number between 0 (not included) and 1. The character's texture size will be multiplied by the ratio
The size parameter may be changed in a future update to a single list for all animations, as currently all animations have the same size
For example, the "character1" data for aurora in the aurora song is:

"character1": {
        "Name": "Aurora",
        "pos": [483, 70],
        "size": [
            [0.45, 0.45],
            [0.45, 0.45],
            [0.45, 0.45],
            [0.45, 0.45],
            [0.45, 0.45]
        ]
    }

This character is located at 483, 70; have its texture's sizes all set to 0.45 and uses the textures from the "Aurora" folder in assets\Images\Characters

"modchartCharacters":
The "modchartCharacters" key stores the characters that are loaded in the beginning of the song to be used for character changes in the modchart
It should look like {"modchartCharacters": [characters here]}
Each character should look like {character name here: character data here}
The character data is the same as the main characters, but without the "Name" key, as it is already in the "character name here" position

Clone this wiki locally