home *** CD-ROM | disk | FTP | other *** search
/ Total Destruction / Total_Destruction.iso / addons / quark407.exe / QUARK.TXT < prev    next >
Encoding:
Text File  |  1997-12-14  |  7.4 KB  |  166 lines
  1.  
  2.  *** Quake Army Knife ***
  3.  
  4.  
  5. This is a level/patch/etc editor for Quake, the game by ID Software;
  6. for Hexen II, by Raven Software; and for Quake 2, by ID Software. This
  7. file is an introduction to Quake Army Knife. Please have a look at it if
  8. you don't know it. Note that Quake Army Knife is based on QuakeMap.
  9.  
  10. A good introduction to Quake Army Knife's features, with screen shots and
  11. all that kind of things, as well as infos on the latest Quake Army Knife
  12. updates and other Quake Army Knife odd-ons is available at Derrick's Home
  13. Page, as well as on-line documentation :
  14.  
  15.   http://www.planetquake.com/quark
  16.  
  17. Quake Army Knife ("QuArK" for short) is centralized on a proprietary file
  18. format, with extension ".qme". Although you may use it as a standard ".map"
  19. editor, I recommend using the ".qme" file format, because it can store a
  20. lot of things more than just a map.
  21.  
  22. You can store several maps, code patches (written in QuakeC), files like new
  23. sounds or new models for Quake, and more, in a single .qme file. When you run
  24. QuArK, the window you see is the "QuArK Explorer", which allows you to
  25. edit such .qme files. See the introduction below and instructions in file 
  26. EXPLORER.TXT. When you open a map, either a standard .map file or a map 
  27. included in a .qme file, a new window pops up : the "QuArK Editor", a 3D 
  28. level editor. See EDITOR.TXT for a detailed description of the editor.
  29.  
  30. QuArK also has a Model editor. No documentation is available about it at the
  31. time I wrote this.
  32.  
  33.  
  34.  *** Requirements ***
  35.  
  36. Target Quake version : from 0.91 to 1.06 REGISTERED ; QuakeWorld. It may
  37. work with other versions, at least partially, but it has not been tested
  38. with these.
  39.  
  40. The QBSP, VIS and LIGHT utilities from id Software are required to
  41. "nodebuild" maps, i.e. to prepare them in order to play to Quake in them.
  42.  
  43. Using a more recent version of QBSP than id's first one is recommended.
  44. Try out the one recommended in file FAQ.TXT, for example.
  45.  
  46. Estimated Hardware/Software Requirements:
  47. - 486DX2/66 or better processor.
  48. - 16mb RAM
  49. -  1mb Hard Drive Space for QuArK
  50. - Windows 95
  51. - Registered version of Quake
  52. These are estimates based on limited testing.
  53.  
  54.  
  55.  *** Installation ***
  56.  
  57. Just unzip all the files in whatever directory you want. I recommend creating a
  58. new directory, named for example "QuArK", and unzipping the archive there.
  59. You will be asked when required where Quake is. You don't have to put QBsp, Vis
  60. and Light in the same directory as QuArK; if they are elsewhere, QuArK will
  61. ask you where.
  62.  
  63. When QuArK needs to run Quake, it sometimes create a lot of files
  64. (.map and .bsp files, progs.dat, quake.rc, .cfg files, etc). That is why it
  65. creates a temporary temporary directory structure under your Quake directory,
  66. named "QMapExec\". Files are extracted at their correct location under this
  67. directory : for example, maps are extracted in "QMapExec\maps\", sounds in
  68. "QMapExec\sounds\", etc. When it launches Quake, QuArK uses a "-game QMapExec"
  69. command-line parameter to tell Quake to use these files.
  70.  
  71. WARNING: consider this QMapExec directory and all its sub-dirs as TEMPORARY !
  72. Never save your work under it. Do not put QuArK itself in it. QuArK may
  73. erase the whole directory and its sub-dirs at any time ! It does so, for example,
  74. when you click on the "GO!" button that tells it to extract all entries and run
  75. Quake. A misadventure happened to someone how had all his work erased this way.
  76. Since then, I have coded securities in QuArK to prevent it from erasing
  77. something else than its temporary directory, and to prevent you from saving files
  78. in this directory.
  79.  
  80.  
  81.  *** QuArK Explorer ***
  82.  
  83. QuakeMap 2.0 - QuArK is based on QuakeMap 3.beta4 -
  84. had numerous changes.  One of the most significant
  85. is the new file format, .qme, which is the format used by QuArK
  86. Explorer.  The advantage of this format is that it allows
  87. you to save many different types of data in one file.  In
  88. addition to holding the .map file, a .qme file can contain the
  89. text description file, Quake C patches and even .bsp's with
  90. textures removed.  In this way, QuArK can also be used as
  91. a front-end to Quake, managing multiple patches for you.
  92. Keep in mind, if you wish to distribute your files this way, the
  93. user HAS to use QuArK to run it.  However, A DOS run-time
  94. version of QuArK is available (30kb), which make it easier to
  95. distribute files in this format. All you have to distribute with
  96. your .qme files is a URL at which users may download this small
  97. add-one. And these 30kb are well worth the possibilities of
  98. QuArK ! Even if your .qme contains a single compiled .bsp, the
  99. 30kb to download will be smaller than the kb won by the absence
  100. of textures in the .qme.
  101.  
  102. Let's take a closer look at the possibilities of the .qme format.
  103. It allows us to associate QuakeC patches with particular levels.
  104. With this, we are able to build level-specific programs, like we 
  105. did in Hexen. For example, we could do something like Hexen's
  106. first level, where there are walls that make a half turn, fire a 
  107. few fireballs on you, and then rotate back in place. This could 
  108. be done in a standard QuakeC patch, but associating this patch 
  109. with the level make it far easier to use, and prevent oneself from 
  110. playing the level without the patch or vice-versa.
  111.                
  112. It also provides a consistent way of assigning actions with new
  113. keys - you know, "impulse" commands. You'll be shown a list of
  114. new actions the installed patches provides, and you'll have to
  115. choose a key for each of them. QuArK will then automatically
  116. remap impulse numbers as needed (useful for several patches from
  117. serveral sources) and write the "autoexec.cfg" to bind them with
  118. the keys you have choosen.
  119.  
  120.  
  121.  *** SHAREWARE ***
  122.  
  123. QuArK is Shareware.
  124.  
  125. Please see file REGISTER.TXT.
  126.  
  127.  
  128.  ***
  129.  
  130. Any comment, suggestion or bug report is welcome.
  131.  
  132. Thanks: to Derrick McKay for his QuArK Home Page and for all his comments and helps
  133.             (http://www.planetquake.com/quark)
  134.         to Mike Melzer for writing and updating a large part of the documentation;
  135.         to Steve ("sturm") for having provided the previous home page for QuakeMap;
  136.         to Christophe Weibel for having organized textures into groups;
  137.         to everybody who wrote me comments and bug reports;
  138.         and of course to id Software for Quake !
  139.  
  140. As usually, I won't assume any responsability for whatever might occur by
  141. using my program, either directly or indirectly. No warraties !
  142.  
  143.  
  144.  *** Legal stuff ***
  145.  
  146. You may distribute this program on any support, as far as you don't make anybody
  147. pay for it. You may charge shipping and handling costs on users, but not more.
  148. You may by *no* mean make profit from solding, leasing, or anything else with
  149. this program. You may, however, do whatever you like with whatever you made with
  150. this program. The author reserves the right to forbid at any time a web site or
  151. person to distribute this program, and to remove some web site or person all the
  152. rights mentioned above.
  153.  
  154. id Softare does NOT support this program at all. The author of QuArK is by
  155. no way related to id Software. DO NOT ask id Software anything about QuArK.
  156.  
  157. "QuArK" is a unofficial short name for "Quake Army Knife" and is by no way
  158. related to "Quark, Inc.".
  159.  
  160. Quake is (TM) (C) by id Software, Inc. All rights reserved.
  161. The Quake logo is (C) by id Software.
  162.  
  163.  
  164. Armin Rigo.                             (arigo@alphanet.ch)
  165.                    (no file attachments nor mailing lists at this address !!!)
  166.