Music Pack Format

Music Pack Format

NordVader Synced Music Player expects music packs to be prepared in a compatible format.

A random Space Engineers sound mod may not provide enough data for browsing artists, albums, tracks, and durations.

Required data

A compatible music pack should include:

  • audio files;
  • Space Engineers sound definitions;
  • stable SoundId values;
  • artist metadata;
  • album metadata;
  • track title metadata;
  • duration metadata;
  • a valid thumbnail if the pack is published.

Recommended folder structure:

Audio/
  Artist Name/
    Album Name/
      Track Name.xwm

Example:

Audio/
  Artist One/
    First Album/
      Opening Track.xwm
      Second Track.xwm
  Artist Two/
    Live Set/
      Intro.xwm
      Main Theme.xwm

Track title rules

Track titles should be display names, not full file descriptions.

Good:

Track Title

Bad:

Artist - Track Title
Track Title - official video
Track Title mp3 converted final

Artist names belong in the artist field. Album names belong in the album field.

SoundId stability

SoundId values should stay stable after publishing.

Changing SoundId values can break old saved playlists or player references.

For an existing public pack, avoid unnecessary SoundId changes.

Duration data

Duration data lets the player display and manage tracks more cleanly.

If duration data is missing, some UI and playlist behavior may be less accurate.

Refresh duration data after changing the audio library.

Thumbnail

Use:

thumb.jpg

Recommended size:

1024x1024

Keep the image readable at small Steam Workshop size.

Compatibility checklist

Before publishing, check:

[ ] Audio files exist.
[ ] Sound definitions exist.
[ ] SoundId values are stable.
[ ] Artist metadata exists.
[ ] Album metadata exists.
[ ] Track title metadata exists.
[ ] Duration data exists.
[ ] thumb.jpg exists.
[ ] The pack was tested with NordVader Synced Music Player.

Next steps