# Readme

### From Q4MAX

# Quake 4 Maximizer - Q4MAX

## Standard Installation

Unzip this archive in the root Quake4/ directory, with folders enabled. You should have a newly created directory named "q4max" with these files:

    readme.htm - this file
    changelog.txt - a very terse list of additions, changes, and bugfixes
    it is however BY FAR the most important of the docs, so READ IT!
    description.txt - the entry for the mods menu
    zz-q4max-game-075.pk4
    zz-q4max-media-075.pk4

    docs/Cvars.htm
    docs/Commands.htm
    docs/Client.htm
    docs/Server.htm
    docs/Modes.htm
    docs/Faq.htm
    and a few standard configuration dirs (modes, cfg)

Make sure you read the docs. More up to date information will often be available on our wiki though.

## If you're updating from a previous version of Q4Max

Delete ALL old .pk4 files in your server's q4max/ directory. Dedicated servers should only have the most recent zz-q4max-*.pk4 files in the /q4max directory to prevent unnecessary .pk4 downloads and confusion (especially on Linux/BSD-based servers).

## Running the mod

We recommend you do not load Q4Max from the "Mods" menu. Instead you should run Quake 4 with the following command line parameter :

    +set fs_game q4max

This makes sure the mod can initialize properly. This is good practice with any mod.

## Running Servers

Listen servers are quite broken and we have chosen not to support them for now : we therefore recommend you ALWAYS use dedicated servers.

On Windows :

1. Make a shortcut to quake4ded.exe, right-click it and select Properties.
2. In the properties window, select the shortcut tab.
3. In the Target field, add command line options after the path and .exe name

i.e

    Quake4Ded.exe +set fs_game q4max +exec server.cfg

If you are going to run multiple dedicated servers on a single machine, you will have to add a different +fs_savepath "<path for this instance>" to the commandline of each instance. i.e.

  Server1:

      Quake4Ded.exe +set fs_game q4max +set fs_savepath "d:/server1"

  Server2:

      Quake4Ded.exe +set fs_game q4max +set fs_savepath "d:/server2"

and so on.

If you want to run a dedicated server and a client on your machine, you need to start the server with a fs_savepath as shown higher up.

More information about running servers in the /docs.