back to the main page

Introduction to QuArK


Welcome ! This is the program Quake Army Knife 5.5, also known as

QuArK

QuArK is an all-purpose editor for the game Quake, by id Software, and derived games Hexen II, Quake 2, Heretic II, Half-Life, and Sin. QuArK focuses on map editing, but is not limited to it.

QuArK version 5.1 is a major rewrite of the old QuArK 4.07. Their main common point is the famously easy-to-use interface of the map editor.


Free Software


QuArK is free software, WHICH DOESN'T MEAN IT IS GRATIS : "free" is in the sense of freedom, not price. For defails, please read the file COPYING.TXT.

If you downloaded this from PlanetQuake, and if you use the software regularly, you should pay me a small fee. See "Status of QuArK" for more information.

In all cases, you are welcome to redistribute it under the conditions stated in COPYING.TXT.


Web site / Download


http://www.planetquake.com/quark

What you will need to make maps and play them is :

  • first, Win95/98 or NT, and one of the original games (Quake, Hexen II, Quake 2, or Heretic II), of course.
  • you need QuArK itself, but I guess you already have it if you are reading this.
  • you need a Python interpreter to run QuArK. Download the "Mini Python Pack" from the web site.
  • to run your maps in the game, you need some utilities that will translate QuArK's output into an optimized file that the game can load. Download one of the "Build Packs" from the web site.

The site always contains the most up-to-date versions of QuArK, and its download page has all the required utilities. See below for installation instructions.


Supported games


Officially, Quake, Hexen II, Quake 2, Heretic II and Half-Life are supported. Sin support is present but untested. Unofficial support for other games may be created by anybody in the form of a QuArK add-on. I have also been asked to design QuArK for another company planning to use it to design the maps of a new game based of Quake 2.


Installation


Before you can install QuArK, you must install a "Python" interpreter on your system. Be sure you downloaded and installed the "Mini Python Pack" from the QuArK web site. You must install it before you can proceed with the installation of QuArK, because the installer of QuArK itself is written in Python.

Once you downloaded and installed Python and QuArK, you can use QuArK. When QuArK will need to load data from the game, for example to display the list of textures, it will prompt you for the path where the game is installed.

When you have made a first map and want to try it in the game, you will need to "compile" the map first. This is done by the utilities you downloaded in the "Build Pack", but QuArK can call these programs for you, so that all you have to do is unzip the "Build Pack" somewhere and tell QuArK where you unzipped them. You will also be automatically prompted for this when required.


Overview


QuArK is divided in several modules, and each of them can edit a particular type of Quake file. The central module, the "QuArK Explorer", lets you group and organize several files into a single one. Files creates by the Explorer have the extension ".qrk" and can contain absolutely any other file, organized in group and sub- groups.

The file type you are likely to use the most often is "Quake map". A map is a level for the game that you design in 3D space by assembling polyhedrons and positionning entities between them. For a general overview about how to make Quake maps, there are a lot of good sources at http://www.planetquake.com.

To learn more about map building, see the documentation about the map editor.


Python


QuArK 5.1 is based on Python, which is a macro programming language. You will see all the behaviours of the map editor in the files *.py found in the folders "quarkpy" and "plugins". All the features of the map editor are found there, and can be changed. New features can be added a plug-ins. If you know the basics of programming, you can have a look there. There is a forum on the QuArK web site devoted to Python programming in QuArK. For more information about Python itself, see the Python web site at http://www.python.org.


No Warranties


NO WARRANTY

BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


Thanks


I am the author of QuArK, but QuArK would certainly never have been what it is today without the continued support and feedback of hundreds of users. I would like to thank them all here. The complete list would be quite long, and I must admit I didn't wrote and updated such a list... so please excuse me if I forgot you on the small list below. I would like to give special thanks to, in no particular order :

Christophe Weibel
An old friend, the only Quake friend I visually know.
Derrick McKay
for the web site and comments and help for QuArK the former QuakeMap, up to versions 4.xx, when he had to left the Quake community.
Decker (Bent P. Svendsen)
He supported QuArK by releasing a lot of add-ons, such as new monsters. He helped a lot in the old times of QuArK. More recently, he also sorted Quake 2 textures and made all the Half-Life support.
SpaceDog (Kasper Kystol Andersen)
for Quake 1 & 2 entities and textures for QuArK 5.
Brian Wagener
helped reviewing the Quake 1 entities and textures.
Akuma
Lots of help. He gave me a valuable support. He also worked for Quake 2 support. He enters the list of people that have been helping for QuArK for a very long time.
Paniq (Leonard Ritter)
The #1 source for tips and good ideas. A special thanks to him. He actively debugged QuArK 5.1. He's the person to thank for lots of old and new features in QuArK. He's also the designer of the new look; he made most icons in 5.1 and the splash screen.
Chen Ken
for his freeware Delphi component "MarsCaption", offering QuArK its colorful caption bars.
Jordan Russell
for his freeware component suite Toolbar97. The docking toolbars are done with his code.
Gryphon (Dudley Bryan Jr.)
He is the web site manager now. He gave the whole site a very nice design. He also designed icons for QuArK : mainly, all icons that represent file types.
Tiglari
A great Hexen II fan. Thank to him, you have good Hexen II support in QuArK. All entities and textures are from him. The Hexen II master ! Now reconverted in Heretic II support.
Robert
for completing Hexen II support with .mdl file names, so that models can be displayed in the 3D views. Robert and Tiglari did this almost at the same time ! Sorry Tiglari, I finally chose Robert's version.
Scott
for additionnal help on Hexen II textures.
Richard Hatch
for his review of Quake 2 entities.
Taufik Purnomosidi
Taufik has always been in the vicinity of QuArK.
Patrick Steele
Help for the recent developments of QuArK. Patrick, Paniq and Tim beta-tested QuArK 5.1.
Eoghan Murray
Tons of suggestions.
Dariusz Emilianowicz
The polnish QuArK antenna. He made a lot of comments. He also did H2 textures sorting.
Denis Dratov
He made the Compass, VBar and ZoomBar images for 5.0.c4.
`eNtiTy
He prefers QuArK 4.07 than 5, but I don't give up : I will continue to fight to make QuArK 5 always better !
Tim Smith
Tim gave me incredible help for QuArK 5. He is a programmer, and without even having access to the source code, he located many many bugs ! He fixed tons of Python problems and designed several complete plug-ins.

Armin Rigo

top
back to the main page