home *** CD-ROM | disk | FTP | other *** search
/ GameStar Special 2004 March / GSSH0304CD2.iso / Mafia / MafiaDataXTractor / MafiaDataXTractor.txt < prev   
Text File  |  2004-01-28  |  8KB  |  150 lines
  1. ----------------------
  2. MafiaDataXTractor v1.1
  3. by MassaSnygga
  4. ----------------------
  5.  
  6. -----------------
  7. - WHAT IS THIS? -
  8. -----------------
  9. This is a little tool that allows you to extract all the files from the Mafia *.dta files.
  10. This includes all the GREAT music  (In .ogg format. Get a new WinAmp to play them!), the
  11. sounds, the textures, the models...
  12. This tool even patches the Mafia game to read the data files you extracted (and perhaps
  13. modified afterwards :). This makes Mafia-Modding possible!!
  14.  
  15. ----------------------
  16. - HOW DO I USE THIS? -
  17. ----------------------
  18. It's very easy to use. Just start it and say OK when it asks you about patching Mafia.
  19. Then choose one or more data files you want to decrypt. Press EXTRACT and there you GO!
  20. Repeat as often you want :)
  21.  
  22. - NOTE: The files will always be extracted into your Mafia directory as Mafia will try
  23.   to read them from there. But don't fear, they will all be in directories like: sounds,
  24.   mission... So you wont end up with a directory with one godzillion unsorted files.
  25. - NOTE: Mafia is HUGE so if you choose to extract all files, have in mind that it will
  26.   take some time and consume A LOT of disk space (~2.9 GB).
  27. - NOTE: Although the extracted data files will be written to disk and are read from there
  28.   by the game, it is NOT possible to delete the *.dta files as Mafia checks for their
  29.   presence. One could patch this, though.
  30.  
  31. --------------------------
  32. - WHY SHOULD I USE THIS? -
  33. --------------------------
  34. There are numerous reason why one could be interested in this, for example:
  35.  
  36. - Listen to the FABULOUS music without playing the game.
  37. - Rip textures and sounds.
  38. - Modify the game!
  39.   This is for sure the interesting part of all. The possibilities go from
  40.   simple cheating over texture/music modifications and unlocking hidden features to
  41.   creating custom missions.
  42.   At this point there are several modding tools as well as many nice mods avaliable. Just
  43.   visit your favourite Mafia fanpage for more info.
  44.  
  45. --------------
  46. - 1.1 Issues -
  47. --------------
  48. With the 1.1 version a8.dta was added to Mafia which contains some replacement files as
  49. well as some new ones. The MafiaDataXTractor is now capable of extracting this file too.
  50. It also should be capable to extract a file named b8.dta, although I it isn't installed
  51. with the patch but Mafia tries to load it upon startup. If you have a version of Mafia
  52. that uses this file, please let me know.
  53.  
  54. One problem with the a8.dta is, that is overwrites some old files from the old dta files.
  55. So by extracting some of the old dtas you reverse that as the patched Mafia favours
  56. extracted files over packed ones. As this is not what we want, MafiaDataXTractor detects
  57. such a situation and asks the user if he also wants to extract a8.dta afterwards so the
  58. old files are overwritten again and the game will behave as if it's patched.
  59. I stronly recommend you to answer with yes, but of course you are free in your decision.
  60.  
  61. There is also a file called ISdata.dll but I have not been able to open it, in fact even
  62. Mafia itself doesn't seem to use it. But again there might be versions that actually do.
  63.  
  64. -------
  65. - FAQ -
  66. -------
  67. Since the release of this tool I recieved a lot of mail from people that had problems
  68. using my tool. As most of the questions keep repeating itself over and over I created this
  69. little FAQ in the naive belief that I won't have to answer the same old questions ever 
  70. again.
  71.  
  72. Q: Is there a dta packer? If not, write one now!
  73. A: I have heard of a dta packer, but I don't have it, I don't know where to get it and I
  74.    am not interested in it. I also won't write one for I don't see the point in it. It is
  75.    so much easier to distibute a tiny 100 kb mod over the net than a 400 meg dta monster.
  76.    Right?
  77.  
  78. Q: Your program doesn't work! Mafia doesn't accept my changes. I probably need a packer to
  79.    make it work.
  80. A: It's not my program, it's the following:
  81.    As you may have noticed there aren't only *.bmp in the maps directory but also other
  82.    files like *.565, *.555, *.dx1, *.dx3 and most of them have the same filename as a bmp
  83.    (followed by a suffix). These files contain the same texture as the bmp but have
  84.    another fileformat. Upon execution Mafia chooses the files to load based on the texture
  85.    settings (*.bmp = truecolor, *.565 *.555 *.dx1*.dx3 = other). So the modified textures
  86.    aren't loaded but a lower-quality version that remained unmodified. Unfortunately many
  87.    mods rely on the truecolor setting as bmp files are the easiest to edit.
  88.    AND TO MAKE IT CLEAR ONCE AND FOR ALL:
  89.    You don't need a dta packer! NEVER EVER! Mafia definitely loads the extracted files as
  90.    long as it is using the patched rw_data.dll. A dta packer won't help that kind of
  91.    problems in any way. It just makes testing and mod distibution more difficult.
  92.  
  93. Q: Do I need to extract all the files (or at least some files) to make <insert mod here>
  94.    work?
  95. A: NO! This is definitely not neccessary, although even some mod makers claim the 
  96.    opposite. As soon as MafiaDataXTractor patched your rw_data.dll every mod will work,
  97.    even without extraction. You only have to make sure to put the files in the right 
  98.    directories (textures go in maps, models in models ...)
  99.  
  100. Q: Is there a way to edit the 4ds files? I tried every 3D program on this planet, but it
  101.    doesn't work.
  102. A: There is no 3D program that can open 4ds files as they it is a file format that was
  103.    explicitly designed for being used with the Mafia engine. But there is a converter that
  104.    can convert most 4ds files to a commom format. Read more about this here:
  105.    http://www.saarcor.de/mafia/
  106.  
  107. Q: I want to know more about the dta file format. Can you give me any information?
  108. A: Yes I can! I actually wrote a little tutorial about it. Check this out:
  109.    http://www.kamalook.de/mafia/dta.html
  110.  
  111. Q: Where can I get the latest version of the MafiaDataXTractor?
  112. A: From now on you can always download it from this location:
  113.    http://www.kamalook.de/mafia/mafiadataxtractor.zip
  114.    But this is as far as I will go, forget about a webpage or anything else beyond that.
  115.    I'm just too lazy :)
  116.  
  117. --------------
  118. - WHAT ELSE? -
  119. --------------
  120. This version of MafiaDataXTractor was only tested with the US/UK version of the game as
  121. I don't have access to any other versions of the game.
  122. It is possible, however unlikely, that other versions of the game use different decryption
  123. keys. Contact me if you have any problems with data extraction. But be prepared that I 
  124. might not able to help you if you have a problem that is related to a different
  125. localisation of the game. Although if someone would donate that specific version to me,
  126. I would be happy to tackle the problem :).
  127.  
  128. Furthermore this program was only tested under Win98 and WinXP. I don't have Win95/NT/2k
  129. and therefore WON'T be able fix the program to work in these environments, if there are
  130. any problems.
  131.  
  132. If you have any suggestions, bug reports or have found an interesting way to mod Mafia,
  133. mail me:
  134. MassaSnygga@kamalook.de
  135.  
  136. -----------
  137. - HISTORY -
  138. -----------
  139. v.1.1
  140. - added support for the Mafia version 1.1 and particularly for the a8.dta
  141. - added some measures to make the MafiaDataXTractor more stable in case of errors during extraction
  142. - added FAQ to documentation
  143. - some minor bugfixes
  144.  
  145. v.1.01
  146. - fixed a bug that caused the wrong files to be extracted when one or more dta files was missing
  147. - added the version number to the titlebar
  148.  
  149. v.1.0
  150. - intitial release