Optional Mod   : Jukebox mod
eXtreme Version: 2.6

Description:
This optional mod adds the necessary sound files (placeholders) and sound
aliases for the jukebox.
This is a CLIENT SIDE modification!

The optional jukebox mod holds 50 one-second silent tracks ("sound\jukebox").
These files are placeholders to allow the jukebox to run in case you enable
it without adding tracks. The files are named "track01.mp3" to "track50.mp3",
which are referenced by sound aliases ("soundaliases\xx_jukebox.csv").
The idea is that you add an optional jukebox music download as a seperate
iwd file. In this file you need to make a "sound\jukebox" folder structure.
The easiest way is to add tracks with the same name as the included silent
tracks. If you want other file names, or if you need more than 50 tracks,
you will have to edit the xx_jukebox.csv file in the "soundaliases" folder.

There are three ways to integrate the jukebox into eXtreme:
A. One global MANDATORY jukebox iwd, no personal jukebox files allowed
   See Instructions A.
B. One global OPTIONAL jukebox iwd, no personal jukebox files allowed
   See Instructions B.
C. One global OPTIONAL jukebox iwd, personal jukebox files* allowed
   See Instructions C.

* Personal jukebox files:
- Personal jukebox iwd files are named localized_english_iw12.iwd, and are
  in the "main" folder on the client's PC ("main\localized_english_iw12.iwd").
  Personal jukebox files are made and maintained by the players. You don't have
  to put them on the server.
- The server has to known how many tracks a player has in the personal jukebox
  file, and what the track lengths are. As an admin you tell the server by making
  jukebox profiles in jukebox.cfg, linking player names to profile names.
  See jukebox.cfg for instructions and examples.
- Personal jukebox files only work if you have all global jukebox tracks in a
  seperate jukebox iwd, made as an optional download (by adding _svr_ to the iwd
  file name), including all remaining silent tracks. You have no silent tracks in
  the mod's iwd ("e26").


Instructions:

Instructions A (global mandatory jukebox, no personal jukebox files):
- Open PakScape. Click on File, New.
- Drag the folders from the jukebox mod into PakScape.
- Replace the silent tracks with real mp3 sound files. You can add up to
  50 sound files. If you have less, replace only the tracks you need,
  starting with track01.mp3. Leave the other silent tracks in there.
- Save to j26.iwd.
  If PakScape creates a zip (j26.iwd.zip), rename the file to j26.iwd.
- Copy the file to your server (fs_game).
- Copy the file to your download redirect server too (fs_game).
- Make sure your jukebox.cfg is updated on the server.
- Connecting players will have to download this file before playing.


Instructions B (global optional jukebox, no personal jukebox files):
- Open the main client side iwd (e26.iwd) in WinRAR.
- Drag the folders from the jukebox optional mod into WinRAR.
- If you wish, install other client side mods now.
- Save the main client side iwd, and copy it to your server (fs_game).
- Copy this file to your download redirect server too (fs_game).

- Open PakScape. Click on File, New.
- Create a folder names "sound" (Object -> New Directory).
- Inside the "sound" folder, create a folder named "jukebox" ("sound\jukebox").
- Add real jukebox mp3 files. Use the same names as the silent tracks, starting
  with track01.mp3. You can add up to 50 sound files.
- Save to j26_svr_.iwd.
  If PakScape creates a zip (j26_svr_.iwd.zip), rename the file to j26_svr_.iwd.
- Copy this file to your server (fs_game).
- Copy this file to your website, and link it for everyone to download.
- Make sure your jukebox.cfg is updated on the server.
- Connecting players will NOT be forced to download this file before playing.
  Only players who downloaded the jukebox file from your website and put it in
  the local fs_game folder can hear the jukebox playing.


Instructions C (global optional jukebox, personal jukebox files allowed):
- Open the main client side iwd (e26.iwd) in WinRAR.
- Drag the "soundaliases" folder from the jukebox mod into WinRAR.
  WARNING: ONLY the "soundaliases" folder. Do NOT copy the "sound" folder!
- If you wish, install other client side mods now.
- Save the main client side iwd, and copy it to your server (fs_game).
- Copy this file to your download redirect server too (fs_game).

- Open PakScape. Click on File, New.
- Drag the "sound" folder from the jukebox mod into PakScape.
  WARNING: ONLY the "sound" folder. Do NOT copy the "soundaliases" folder!
- Replace the silent tracks with real mp3 sound files. You can add up to
  50 sound files. If you have less, replace only the tracks you need,
  starting with track01.mp3.
- IMPORTANT: Remove all unused silent tracks!
- Save to j26_svr_.iwd.
  If PakScape creates a zip (j26_svr_.iwd.zip), rename the file to j26_svr_.iwd.
- Copy this file to your server (fs_game).
- Copy this file to your website, and link it for everyone to download.
- Make sure your jukebox.cfg is updated on the server.
- Inform visitors of your website how to create personal jukebox files. They
  need to submit a playlist so you can add a profile to jukebox.cfg. Typically
  this is only done for clan members.
- Connecting players will NOT be forced to download this file before playing.
  Only players who downloaded the jukebox file from your website and put it in
  the local fs_game folder, and players with a personal jukebox file can hear
  the jukebox playing. Players with a personal jukebox file should not download
  the global jukebox file from your website. 
