Quagents: Building the System

This document describes how to obtain the source code for the Quagents system and then build and install it.

Prerequisites for Quake II

You must obtain the contents of the baseq2 directory which contains the game's graphical resources (pak files). We are not able to distribute these. Please see Prerequisites for Running the System for details.

Getting the Code

A tarball of the latest stable code is avilable at: HTTP

CVS access is currently only available for URCS local developers:
```
    cvs -d /p/quake/cvs checkout src
```

Experimental Windows Platform Version

      This is an experimental (not currently supported nor very tested) version
      of quagents that runs on the Windows platform.  It was briefly
      experimented with on Windows XP Professional and was compiled with Visual
      Studio .NET 2003.  Your milage may vary.  See README_WINDOWS_BUILD.txt inside the src zip file 
      for tips on setting things up and compiling.
      There is no current development ongoing on this version but we provide it
      here as someone might find it a useful starting point of reference 
      for running the program in a Windows environment, the game's original target platform.

      Quagents Windows Source Code: 
      win32quake2ur_src.zip

      Quangents Windows Version pre-compiled binary: 
      win32-quake2ur_bin.zip 
           If you will just be writing quagent client code this allows for the server
           to be run on a Windows machine.

Building the Code

Quagents uses the standard GNU configure script:
```
    ./configure
```
For a full list of configuration options, type
```
    ./configure --help
```
In particular, the following options are often useful when building the Quagents system:
- --prefix: Set the destination for installation of the system. The default is /usr/local. You will probably want to put it somewhere else. One possibility is `pwd`/...
- --with-baseq2: Set the location of the directory containing the Quake resource bundle (among other things). The default is /usr/local/quake2/baseq2, but this will only be correct if you installed the Quake II resource directory (baseq2) into /usr/local/quake2. For more details, please see Prerequisites for Running the System for details. For local developers, configure will automatically locate the baseq2 directory on URCS local filesystems.

Compile the quake engine and the Quagents mod:
```
    make
```

Install the engine and mod:
```
    make install
```

Compile the examples of various quagent controllers:
```
    make examples
```

Now you're ready to run the Quagents system.

Last change 22 Oct 2004 by ferguson