home *** CD-ROM | disk | FTP | other *** search
/ Igromania 2002 June / Igromania_06.iso / Magazine / Vskritie / UnrealTournament / UMX.RAR / IN_UMX~1.TXT < prev   
Text File  |  2002-01-23  |  9KB  |  218 lines
  1. UMX Decoder Readme (Jan 23, 2002)            http://www.umx-decoder.de.vu
  2.  
  3. ==============================================================================
  4. Table of Contents
  5.  
  6. 1. About UMX Decoder
  7.     1.1. What is an UMX file?
  8.     1.2. Where to find the UMXs?
  9.  
  10. 2. Installation / Download
  11.     2.1. Requirements
  12.     2.2. Installation Instructions
  13.     2.3. Download Location
  14.  
  15. 3. Frequently Asked Questions (FAQ) / Troubleshooting
  16.     3.1. Questions on UMX and UMX Decoder
  17.         3.1.1. How does it work?
  18.         3.1.2. Can I convert UMX to MP3 / WAV?
  19.         3.1.3. Can I create my own UMX?
  20.     3.2. Troubleshooting
  21.         3.2.1. General solutions
  22.         3.2.2. UMX files don't have the Winamp icon in Explorer etc.
  23.         3.2.3. Certain UMX files don't play correctly!
  24.         3.2.4. I have a problem which is not listed here!
  25.  
  26. 4. ChangeLog
  27.  
  28. 5. Miscellaneous
  29.  
  30. 6. Contact
  31.  
  32. ==============================================================================
  33.  
  34.  
  35. 1. About UMX Decoder
  36.  
  37.    Current Version: 0.6.s3m, tested with Winamp versions up to 2.78
  38.                     
  39.    Description:  UMX  Decoder  is a plug-in for winamp that lets you play
  40.    Unreal music packages (*.umx) directly from Winamp.
  41.  
  42.    Homepage: http://www.umx-decoder.de.vu
  43.  
  44. ------------------------------------------------------------------------------
  45.  
  46. 1.1. What is an UMX file?
  47.  
  48.    Computer  games  using  the  Unreal  3D-engine (most notably, Unreal &
  49.    Unreal  Tournament)  store the game music in UMX files. Currently, UMX
  50.    is just a wrapper around MOD files. Future versions may also use a MP3
  51.    codec,  but  who  knows... So Winamp can play MODs, but not UMX files.
  52.    That's what this plug-in changes.
  53. ------------------------------------------------------------------------------
  54.  
  55. 1.2. Where to find the UMXs?
  56.  
  57.    Probably in the [Your Unreal game directory]\Music folder.
  58.    Alternative: Start Windows Explorer, press F3 and search all disks for
  59.    "*.umx".
  60.    Unreal  &  Unreal  Tournament  contain 62 UMX tracks alltogether. Some
  61.    add-on  maps have their own music (very few). Other games based on the
  62.    Unreal engine may also use UMX, e.g. Deus Ex.
  63.    Have fun listening to the most Unreal soundtrack ever!
  64. ------------------------------------------------------------------------------
  65.  
  66. 2. Installation / Download
  67.  
  68. 2.1. Requirements
  69.  
  70.    Every computer capable of running Unreal and Winamp should be able to
  71.    run UMX Decoder. You should get a recent release of Winamp Standard or
  72.    Full (NOT Lite) though. Download it at http://www.winamp.com/download/.
  73.    UMX  Decoder  has been tested with Winamp from version 2.64 to version
  74.    2.78.
  75. ------------------------------------------------------------------------------
  76.      
  77. 2.2. Installation Instructions
  78.      
  79.    1. First step: Download the plug-in!
  80.       The  easiest  way  of  installing  the  plug-in is to download the
  81.       self-installing  executable. If you want to download the zip file,
  82.       be  sure  to  have a zip extracting program and to know how to use
  83.       it!
  84.    2. Second step: Install the file you downloaded.
  85.         + If  you downloaded the self-installing program, then you just
  86.           have to execute it in Windows Explorer or your favorite file
  87.           manager, click "Next" and let the software do the rest :)
  88.         + If  you downloaded the zip file, you must extract it to [Your
  89.           Winamp  directory]\plugins.  This path is usually 
  90.           "C:\Program Files\Winamp\plugins".
  91. ------------------------------------------------------------------------------
  92.  
  93. 2.3. Download Location
  94.    
  95.    Go to http://www.umx-decoder.de.vu and click "Download" in the left
  96.    frame.
  97. ------------------------------------------------------------------------------
  98.  
  99. 3. Frequently Asked Questions (FAQ) / Troubleshooting
  100.  
  101. 3.1. Questions on UMX and UMX Decoder
  102.  
  103. 3.1.1. How does it work?
  104.  
  105.    UMX  Decoder  extracts the MOD data from the UMX packages and plays it
  106.    through Winamp's MOD plug-in. (That's why Winamp Lite is not supported
  107.    -  it  lacks the MOD plug-in.) This method is more or less a hack, but
  108.    it  works  well. I often get mail asking how to read UMX packages. You
  109.    can find some information about the UMX format here:
  110.    http://unreal.epicgames.com/packages.htm
  111. ------------------------------------------------------------------------------
  112.  
  113. 3.1.2. Can I convert UMX to MP3 / WAV?
  114.  
  115.    Yes,  it's  possible.  Go  into  your  Winamp  preferences  and select
  116.    "Nullsoft   Disk   Writer  plug-in"  as  your  output  plug-in.  Click
  117.    "Configure"  and  select  an output folder (make sure you have some 50
  118.    megs of free space there). Then play the UMX as you would do normally.
  119.    You  won't  hear  anything,  but Winamp is writing a WAV file into the
  120.    selected  folder.  After the song has played, be sure to reselect your
  121.    normal output plug-in (usually DirectSound or WaveOut) since otherwise
  122.    Winamp  would  write  all music you hear afterwards to a WAV file. You
  123.    can  use  any MP3 encoder to make a MP3 from the WAV file, for example
  124.    LAME (freeware, http://www.mp3dev.org/mp3/)
  125. ------------------------------------------------------------------------------
  126.  
  127. 3.1.3. Can I create my own UMX?
  128.         
  129.    Why  would  you  want  to?  :)  You  only need files in UMX format for
  130.    playing  them  in your own Unreal levels, right? It's not an easy task
  131.    to  create  UMX  files. The first step is: You need the music in a MOD
  132.    format.  That  is,  for  example,  a .mod, .it, or .s3m file. No .wav,
  133.    .mp3,  .mid, whatever... That's the difficult part - as far as I know,
  134.    there's  no  reasonable way to convert MP3 for example to MOD formats.
  135.    Instead,  you  have  to  compose  the music in a MOD editor program, a
  136.    so-called  tracker.  Then  you  can  import the file into a UMX module
  137.    using UnrealEd.
  138. ------------------------------------------------------------------------------
  139.  
  140. 3.2. Troubleshooting
  141.  
  142. 3.2.1. General solutions
  143.  
  144.    Does the plug-in show up in the Preferences window (Plug-ins, Input)?
  145.    If  it  does  not,  go  to  your  Winamp's  plug-in directory (usually
  146.    "C:\Program Files\Winamp\plugins").
  147.      * Is in_umx.dll there?
  148.        If  not,  reinstall  the  plug-in,  this  time  into  the  correct
  149.        folder... :)
  150.      * Is in_mod.dll there?
  151.        If  not,  reinstall  Winamp.  Also  note  that  the MOD plug-in is
  152.        missing in Winamp Lite. You need at least WA Standard. Download it
  153.        from http://www.winamp.com/download/.
  154. ------------------------------------------------------------------------------
  155.  
  156. 3.2.2. UMX files don't have the Winamp icon in Explorer etc.
  157.  
  158.    Check  Setup,  File Types in the Preferences window. Is "UMX" selected
  159.    in the listbox? If not, select it by yourself.
  160. ------------------------------------------------------------------------------
  161.  
  162. 3.2.3. Certain UMX files don't play correctly!
  163.  
  164.    Please  try  playing  them  with UnrealEd (Unreal Editor) which is the
  165.    normative  reference  concerning  UMX.  You  can  find UnrealEd in the
  166.    "System" subdirectory of your Unreal game directory.
  167.    Also  try  exporting  them  to disk  (as .MOD / .IT file)  to check if
  168.    Winamp's MOD support is the problem.
  169.    If any of those fails, it's not a problem with UMX Decoder itself.
  170. ------------------------------------------------------------------------------
  171.    
  172. 3.2.4. I have a problem which is not listed here!
  173.  
  174.    You should post the problem to our Webboard on our Homepage
  175.    (at http://www.umx-decoder.de.vu).
  176. ------------------------------------------------------------------------------
  177.  
  178. 4. ChangeLog
  179.  
  180.    Version
  181.    0.3     first public release
  182.    0.4     some tweaks with the error messages
  183.    0.5     Winamp 2.72 support
  184.    0.5a    vast rewrite of the plug-in code, removed some minor glitches
  185.    0.5b    HTML readme file
  186.    0.6.s3m now plays the "hidden tunes" in S3M-based UMX modules
  187.  
  188.    There  has  not been very much development in the last months. Because
  189.    of  problems  with the ImpulseTracker module format, I have planned to
  190.    bring  out  a  major  rewrite;  directly  based  on the popular MikMod
  191.    library,  it would allow for better playback, more options and greater
  192.    speed;  also,  the  Nullsoft  MOD  Player would no longer be required.
  193.    However, it is far from complete... I don't have too much free time at
  194.    the moment, so it may take some more ages ;)...
  195. ------------------------------------------------------------------------------
  196.  
  197. 5. Miscellaneous
  198.  
  199.    Thanks to
  200.  
  201.    Nullsoft - for free Winamps all over the desktop
  202.  
  203.    Epic  -  for  two  amazing  games  (nearly as good as the Quake series
  204.    [opinions differ - the webmaster])
  205.  
  206.    all  my  fans  &  supporters  :)  - especially James J. Lane for first
  207.    discovering the "hidden tunes"
  208. ------------------------------------------------------------------------------
  209.  
  210. 6. Contact
  211.  
  212.    If  you have any problems with the plug-in, or if you have suggestions
  213.    or comments on the plug-in please post them to our Webboard at our
  214.    homepage (http://www.umx-decoder.de.vu).
  215.  
  216.    If you find errors in this text file, please report them by filling in
  217.    the form on our website (click "Contact" to get to it)
  218.