Skip to content
Mikolka9144 edited this page Dec 22, 2024 · 2 revisions

Song metadata

P-Slice can store additional information about a given song in a special file called "metadata.json" (mods/your-mod/data/song-name/metadata.json). They're mostly responsible for changing the way this song appears in the freeplay.

Creating new metadata

Head over to chart editor and click on the "Metadata" tab. It should look like this:

Here are the fields as described above (except song length as this one is set automatically).

Metadata fields

Rating (songRating)

  • Stores the rating (in stars) for this song. Maximum value is 99, but star bar will only display up to 15.

Show "new" tag (allowNewTag)

  • Allows for your song to display "new" tag on the song's freeplay cardcard
  • It gets cleared once the player completes it on any difficulty

Freeplay preview start sec (freeplayPrevStart)

  • The second on which freeplay's song preview should start.
  • Because of the implementation, it'll likely start a bit later.

Freeplay preview end sec (freeplayPrevEnd)

  • The second on which freeplay's song preview should end/loop.
  • Because of the implementation, it'll likely end/loop a bit earlier.

Internally handled (freeplaySongLength)

  • The song's length in seconds.
  • This field is used to properly load a song's preview.

Player character(freeplayCharacter)

  • The character, to which this song belongs.
  • If empty, this song won't belong to any character and any character with showUnownedChars set to "true" will display it.

Song album (albumId)

  • The album, to which this song belongs.
  • If empty, the album image as well as star rating bar won't display for it.

Song alt vocals (altInstrumentalSongs)

  • A list of songs containing alternative vocals for the current song.
  • It can be then selected from Inst menu after selecting it in freeplay.

One you're done click "Export metadata" to save them as a "metadata.json" file.

Clone this wiki locally