Installation & Maintenance

Quake2World follows a rolling release development model. You should ensure that your copy of Quake2World is up to date on a regular basis. Quake2World is in BETA. There are bugs, but the game is playable and should work for you as long as your system meets the System Requirements.

Jump to:

Windows

Download the latest Windows 32 bit installer or the latest Windows 64 bit installer.

Extract it to a path owned by your user account, on Windows Vista and Windows 7, we recommend extracting the package to your Desktop.

Run the included Update.exe. This may take a few minutes the first time you run it, but it will take significantly less time on subsequent runs. You should run Update.exe often.

When Update.exe finishes, you can hit enter and then run quake2world.exe.

Mac

Download the latest Mac installer, open it, and drag the Quake2World folder onto the Applications shortcut.

Then, from your Applications folder, click the Quake2World folder and run Update.app. This may take a few minutes the first time you run it, but it will take significantly less time on subsequent runs. You should run Update.app often.

When Update.app finishes, you can close the Terminal window and then run Quake2World.app.

GNU/Linux

First, install libsdl-image, libsdl-mixer, and curl through your package manager. Then download the latest Linux installer (64 bit only), and extract it to a location of your choosing (e.g. ~/quake2world, /opt/quake2world, etc).

Run bin/q2wupdate in the Terminal to install the latest game data and binaries.

When bin/q2wupdate finishes, you can close the Terminal and run bin/quake2world.

Compiling from source

If you prefer to compile your own copy of Quake2World, you can do so fairly easily on Linux and Mac OS X Snow Leopard / Lion. The build uses GNU Autotools, and follows the standard ./configure; make; make install process. Some platform-specific instructions are listed below.

Obtaining the code and dependencies

Installing the game for the first time requires that you a working copy the source code from our Subversion repository. You should checkout the source code to a directory you don't mind leaving around, as you'll want to keep this copy and updated it from time to time:

All platforms

  • mkdir ~/Coding

  • svn co svn://quake2world.net/quake2world/trunk ~/Coding/quake2world

GNU/Linux

  • Ensure you have the following dependencies:

    subversion, gcc, autoconf, automake, libcurl, libsdl, libsdl-image, libsdl-mixer, libtool

  • On Ubuntu 11.04, simply run:

    sudo apt-get install subversion autoconf automake libtool libcurl4-openssl-dev libsdl-image1.2-dev libsdl-mixer1.2-dev

Mac OS X

  • Install MacPorts by downloading the latest .dmg file from the MacPorts site. Prerequisites for MacPorts include XCode and X11, and you should have both before proceeding.

  • Install Autotools, libsdl_image, and libsdl_mixer through ports:

    sudo port -d selfupdate

    sudo port install autoconf automake libtool libsdl_image libsdl_mixer

Compiling and installing

With the dependencies installed, compiling Quake2World is actually very easy. If you've compiled anything that uses Autotools, this will look familiar to you:

All platforms

  • Compile the source code and install the binaries:

    autoreconf -i

    ./configure

    make -j3 && sudo make install

  • Install the game data:

    sudo make rsync-data

  • Run quake2world

Troubleshooting

Problems compiling? Ask for help in #quetoo on irc.freenode.net.