Music Wrapper for Jedi Knight: Dark Forces II and Mysteries of the Sith

Music Wrapper v1.2
for Jedi Knight: Dark Forces II and Mysteries of the Sith

This package bundles the best wrappers and known fixes to help get music working in both games.

For reference, both games used CD Audio for their music tracks. The modern, CD-less solution, used by resellers like GOG and Steam, is to rip the tracks to .ogg files and then supply a wrapper (a special .dll file) to translate the game's calls to play the CD tracks into calls to play the .ogg files from the hard drive, instead. Unfortunately, with newer builds of Windows that haven't been tested with the games' installed compatibility settings, that wrapper can stop working and the result is a loss of music.

This is primarily for the GOG and Steam releases of these games, since its their compatibility settings that interfere with the wrapper. You can, however, also use these instructions to get music working from the hard drive in the retail release.

Install
=======

Copy the five .dll files to your game folder, overwriting any that are already there.

If you still don't have music, perform the following steps, preferably checking music after each one:

* Verify that you have a subfolder named Music with track files named Track12[-32].ogg (JK) or Track02[-14].ogg (MotS).
  If you don't (or you'd like higher quality versions):
    * For JK, follow the directions at https://pcgamingwiki.com/wiki/Star_Wars:_Jedi_Knight_–_Dark_Forces_II#Higher_quality_music
    * For MotS, follow the directions at https://pcgamingwiki.com/wiki/Star_Wars:_Jedi_Knight_–_Mysteries_of_the_Sith#Higher_quality_music

* Rename JK.exe (JK) or JKM.exe (MotS) to something else (ex. JediKnight.exe). This will disassociate the executable from installed compatibility settings that can interfere with music playback.

* Double-click on the provided .reg file. This will remove the compatibility settings from the registry.

* Delete/rename winmm.dll and rename winmm_alternate.dll to winmm.dll. See below for the differences between the two version.

Wrappers
========

* Winmm.dll is Tarvis' fixed wrapper for Windows 10, dated Oct 25, 2015. Credit belongs to Tarvis.

  His changelog:
    -Game not starting on Windows 10
    -Each level plays a track further than it should have 
    -Music playlist would not restart unless player stands still a few seconds/ enters then leaves esc menu 
    -Music volume would not change 
    -Music took about half a second to stop when going back to main menu/starting a cutscene

  Source: https://www.gog.com/forum/star_wars_dark_forces_series/jk_updated_cd_music_player_dll_fix_volume_looping_etc/page1

* Winmm_alternate.dll is GOG's wrapper, dated July 15, 2015. Credit belongs to GOG.

  Unlike Tarvis' version, this one works with the German language pack (and, maybe, other non-English versions of the game or mods). It's possible that it's generally more compatible than Tarvis' version, but doesn't have most of the fixes. One reported issue is that the music stops playing once it's gone through all of the tracks (i.e. it won't loop back to the first track played). For that reason, it's not the default wrapper in this pack, but you may have to live with issues like that if you get no music at all with Tarvis' version.

Changelog
=========

1.2: Added .reg file and re-wrote the instructions
1.1: Added Tarvis' version, made it the default and re-wrote the instructions
1.0: Initial release