news forum live chat wiki


Check out and build from git


  • SDL version 2 is required, Linux users need development packages if they want to compile the game.
  • OpenAL is optionally disable-able. Apple Mac OS X 10.4 and up include OpenAL.
  • Git is used for acquiring our modified version of the id source code..
  • Apple Mac OS X users need X Code installed for gcc, and git and other interesting things.

This part assumes Windows users are using Cygwin. If you aren’t, Github has a good client.

  1. Change into a directory that you want the tree to be kept in.
  2. Check out the source tree:
    git clone git://
  3. Windows users check-out our git project using the same url:
  4. Read the README
    file. Really. Do it.
  5. Compile and install ioquake3:
    • Linux and friends

      We all can compile it ourselves:

      1. Agree to the EULA and grab the
        updated pk3 files
        . Extract it to some place like
      2. Change into the top level directory (it contains the ui and code directories.)
      3. Run make.
      4. Set $COPYDIR to the directory you installed Quake 3 to and make the copyfiles target. Make sure you are changed to the owner of this path (probably root). COPYDIR="/opt/quake3" make copyfiles
    • Mac OS X (intel and/or ppc)

      1. Install MacOSX SDK packages from XCode. For maximum compatibility, install MacOSX10.4u.sdk and MacOSX10.3.9.sdk, and MacOSX10.2.8.sdk.
      2. Change into the top level directory (it contains the ui and code directories.)
      3. Run ./
      4. Copy the resulting in /build/release-darwin-ub to your
        /Applications/ioquake3 folder.
      5. You need to copy your pak0.pk3 from your Quake 3 CD-ROM’s baseq3 directory to your /Applications/ioquake3/baseq3 directory.
      6. Ditto for the Team Arena mission pack, though you would be substituting baseq3 in the above example for missionpack.

      After you’ve done all of that, you can double click on the .app file, or change to the /Applications/ioquake3/ directory in a terminal and run the binary.

    • Windows

      Building on Windows is slightly complicated. You can either use MinGW. Although you may find some in the repository, we don’t have up-to-date Microsoft Visual Studio project files.  The MinGW build method is described in the

  6. If everything has gone well, you should have a binary that works! If not, seek help.