Troubleshooting

# Troubleshooting

This page covers common issues with SEMusicBoxMaker, NordVader Synced Music Player, and compatible music packs.

## The player shows no tracks

Check:

— The music pack mod is added to the world/server mod list.
— NordVader Synced Music Player is also added to the same world/server mod list.
— The music pack was generated or refreshed with SEMusicBoxMaker.
— `Write / Refresh Track Durations + Provider` was run after the last changes.
— The music pack contains sound definitions.
— The audio files are present.
— The paths in the definitions match the real files.

## Artists or albums are missing

Check:

— `Organize as Artist / Album / Track` was enabled during import.
— Tracks have Artist and Album metadata.
— The metadata provider was refreshed.
— The pack is not using a flat folder structure.
— The player terminal list was refreshed.

## Track names include the artist name

Use SEMusicBoxMaker:

«`text
Bulk Rename -> Remove artist prefix
«`

Correct:

«`text
Artist: Kino
Title: Gruppa krovi
«`

Wrong:

«`text
Title: Kino — Gruppa krovi
«`

## The thumbnail does not appear in Space Engineers

Check that the root of the mod contains:

«`text
thumb.jpg
«`

Do not use only:

«`text
temp.jpg
thumbnail.png
cover.jpg
«`

Recommended image size:

«`text
1024×1024
«`

## Some players see the track change but do not hear sound

This is usually a local playback issue on that client.

The player mod uses recovery and resync logic, but logs are still useful for debugging.

Client log location:

«`text
%APPDATA%SpaceEngineersSpaceEngineers.log
«`

Look for lines containing:

«`text
NordVaderMusicBlock
sync
play
recovery
Exception
MOD_ERROR
«`

## The custom player UI does not appear in the block terminal

Check the Space Engineers log for:

«`text
NordVaderMusicBlock
Script loaded
Exception
MOD_ERROR
«`

If the script fails to compile or load, Space Engineers will show only the vanilla SoundBlock terminal UI.

## SEMusicBoxMaker build errors

If the project has both WPF and WinForms enabled, type names can collide.

Common ambiguous types:

— `TextBox`
— `Button`
— `CheckBox`
— `DragEventArgs`
— `MouseEventArgs`
— `KeyEventArgs`
— `Point`

Fix by using explicit WPF aliases or fully qualified type names.

## Safe reset for local mod testing

For local testing, fully close Space Engineers, then replace the local mod folder:

«`text
%APPDATA%SpaceEngineersModsNordVaderSyncedMusicPlayer
«`

Then restart the game and check the log.