From TDN

Introduction

QuArK (Quake Army Knife) is an open-source map editing tool released for free. QuArK now supports a large number of Quake-style map formats/mods and has also been enhanced to support Torque map/dif development.

QuArK Homepage

QuArk community

QuArk Setup Files

For windows : Get the latest version of QuArk (The Quark site has now moved to http://quark.sourceforge.net/index.php)

For linux : Sourceforge QuArk

QuArk Setup Instructions

The QuArK Installer greatly simplifies the installation process. Here are some simple instructions for running the installer:

WINDOWS : Setting up Quark with the Installer

1. Once the QuArK Installer has been downloaded, unzip the quark_setup.zip file.
2. Run the Setup.exe found within.
3. Go through the installer dialog. It is recommended that you use the default settings.

LINUX : Setting up Quark

1. Install winehq. In order to know which version of winehq to install with your linux distribution have a look on this this page.
2. Once the QuArK file has been downloaded, unzip the quark-win32-xxx...xxx.zip file into your home directory.
3. in a shell windows cd "the quark directory installation", and launch quark : wine quark.exe.
4. Go through the installer dialog. Change the directory in function of the linux installation.

Warning
If you change the installation directory, you will have to manually adjust the directories that QuArK searches for the Map2Dif utility in the QuArK Configuration panel.

Now Quark is set up and ready to use. The QuArK application (QuArK.exe) can be accessed either through the Start menu, or on your hard-drive in the C:\QuArK 6.3 folder.

Knowing the Directories
The installer created a number of new directories, and you will need to know where to look to find you maps once they are compiled.

The most important directory in the structure is C:\QuArK 6.3\torque\tmpQuark\maps. This is where your compiled interiors will be placed. In order to view your interiors in game, you will need to copy them from this location to the data/interiors folder in your game's directory.

When you copy your compiled maps into your game folder, you will also need to copy any textures that they use to either data/interiors or the same location as the interior files.

I find it helpful to create a set of links in my start menu to Quark and its related directories. A link to Quark, as well as one to C:\QuArK 6.3\torque\tmpQuark\maps and my data/interiors directory can prove quite handy when I am doing heavy QuArK work.

There are many other configuration options to fine tune your map-making operations; but the defaults work very well from the start. Once you are more comfortable with Quark, feel free to explore! If you want more information on Advanced Quark configuration.

Filepack Details
Download the Torque wrapper
This section covers the specifics of the installer's setup in the Torque Installer. It is intended for those users who wish to manually upgrade to a newer version of Torque, or otherwise customize their configuration. If you are using the default setup described in the previous chapter, you may skip this section and continue on to the Using Quark section.

Detailed structure of important files in TorqueQuark directory:

C:\Quark6.3--|
         |--QuArK.exe (QuArK executable file)
         |
         |--Setup.qrk
         |
         |--/addons-----|
         |              |--Defaults.qrk
         |              |
         |              |--/Torque----|
         |                            |--DataTorque.qrk
         |                            |--UserData Torque.qrk
         |
         |--/torque-----|
                        |---/base/textures/common (location of example textures)
                        |
                        |---/tmpQuArK--|
                                       |--map2dif_DEBUG.exe
                                       |--/maps (location of .map and .dif files after export)
                                       |--/textures (empty except after "Prepare Used Textures")

The DataTorque.qrk and UserData Torque.qrk are add-on files that describe Torque entities and controls to the QuArK menus. These can be modified as new Torque features become available.

Different exporter versions can be placed in the root of the tmpQuark folder.

The /textures folder within /tmpQuark will not be searched for textures by the game engine. Before loading any of your dif files in-game, ensure that copies of you textures have been placed in the root /interiors folder. This means that you should place your maps textures in the same file as your .dif files.

Torque will search the root interiors folder, as well as the folder in which the interior is placed, for used textures.

Advanced users may want to relocate /tmpQuark inside the /interiors folder of their game, this would allow you to load maps from it directly in the Torque mission editor. This is a great way to do quick tests of the levels. This requires a lot of customization of the QuArK configuration, however, and is only recommended for experienced users.