![]() |
Go to:
|
Introduction to QuArK |
Welcome! This is the program Quake Army Knife, also known as QuArK, made by Armin Rigo.
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.x 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.
General: | Ref. pages: | Misc: Old docs.: |
Free Software |
QuArK is Free Software, as stated by the GNU General Public Licence. Be careful! This expression has the following meaning:
All this means that free software may be commercial as well, with technical support, etc. (there is an Ada compiler in this case.) On the other hand, there is gratis software that is not "free": most "freeware" or promotional software. QuArK is "free" but not "gratis".
What the "free" status adds, is that anyone who received or bought the program has access to the source code as well. Anyone may modify the program, or make something else using my code and sell it, and so on, as long as the resulting program is also "free", in the same sense.
Once again, "free" does not means "gratis"! It is about freedom!
So what's the price? |
Previous versions of QuArK were Shareware, with a modest registration fee of 20$. In this "free" version, 20$ is the fee for downloading the software from my web page: download QuArK, and if you use it, please pay me. Of course, this is legally less strict as "shareware": if you can get QuArK from a friend instead of from Planetquake, you don't owe me anything. But anyway, who pays the shareware registrations? Fans! And if you are so enthusiast and want to send me 20$, you are welcome!
In summary: if you download QuArK from the PlanetQuake web site, and if you use it regularly, you are required to pay me 20$. Please -- QuArK represents a lot of work for me.
Registering |
I call this fee a "registration", mainly to show the analogy with Shareware, and because people who register will be added to my official list. Of course, people who registered the Shareware QuArK should not register again !
I tell people who register how they can remove the flashing text about "free software" that cause delay when QuArK starts up. Note to programmers: the GNU General Public Licence prevents you from distributing modified versions of the program that don't display this text!
I don't live in the U.S. But it might be a bit complicated to make international cheques for such a small sum. So I think the easiest for you is to mail me a $20 bank note under cover (in a letter) along with your name and your e-mail address, if any. If you don't live in the U.S, just send me the equivalent sum in your currency.
Put $20 in a letter (shipping is $0.60 from the U.S.) and post it to:
Armin Rigo La Cure CH-1854 Leysin Switzerland
A single registration is valid for all current and future versions of QuArK.
Web site / Download |
The official QuArK web site: http://www.planetquake.com/quark.
What you will need to make maps and play them, is:
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, or you can configure it in this window.
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.x 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 to... |
I, Armin Rigo, 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: