Get started

System requirements

If you've played Cube and Cube can run fine, then AssaultCube should too.

Minimum specs:

If you can run the neccesary libraries/drivers and are able to compile the source by yourself, you may be able to port AssaultCube onto other platforms. Please note: Other platforms may not be officially supported.

The above specifications are the bare minimums, so you may need a lot of adjustment to get AssaultCube to run. We recommend that you run AssaultCube on better hardware than this. If you have troubles with AssaultCube, make sure that the drivers for your graphics card are up-to-date.

Recommended GFX settings for low/medium end machines:

Pre/post install

Linux

Make sure you have these libraries installed:

Also, make sure the appropriate OpenGL drivers are installed, if they're not already.

Note: Settings for AssaultCube will be saved in the .assaultcube folder in your home directory.

Windows 98/ME

You may find that you need to rename the file DbgHelp_RemoveThisPartIfOnWin98.DLL in your bin_win32 folder to DbgHelp.DLL for AssaultCube to work.

Windows Vista

Make sure you have full permissions to the AssaultCube folder so that your files (such as configs, screenshots and maps) may write there. To do this right-click the AssaultCube folder and then click properties. Click the security tab. Find your user name in the list under Groups or user names and click on it. Press edit and check the Full control box. You will need to press OK on the UAC also.

More help for installing AssaultCube on different Operating Systems can be found on the wiki here.

Installing AssaultCube

Windows Download the executable from sourceforge. Execute it and follow the instructions.
Linux Download the tarball from sourceforge. Extract it somewhere where you have permissions to read/write.
Mac OS X Download the diskimage from sourceforge. Drag the contents to your Applications folder.

Display settings

When you first start AssaultCube, you will be prompted to change some fundamental settings from their defaults to how you would like them. Some display settings can be changed here.

To change more display settings, press ESCAPE and then navigate to: Settings ⇒ Video Settings.

If you are having technical problems and need to change settings in a way that doesn't start the game to do it, you can modify the batch/shell script by adding parameters into it. How to edit the batch/shell and the different parameters can be found in command-line arguments. You can also add commands to config/autoexec.cfg so they automatically execute on startup.

Running AssaultCube

Windows Use the shortcut provided. Or execute the AssaultCube.bat file in your AssaultCube folder.
Linux In a console, change your location (cd) to the main AssaultCube directory and then execute AssaultCube.sh.
Mac OS X Open the applications folder. Click on AssaultCube. Select the options you want to use to run AssaultCube and then press play.

Note: Thanks to Harps for explaining the permissions of Windows Vista and KanslozeClown for explaining the process for using AC on Mac OS X.