Microsoft Windows

The Windows Logo.

This page describes Windows specific information for AssaultCube.

Configuration files

There are two seperate directories you need to distinguish when talking about your AssaultCube installation. The installation directory (C:/Program Files/AssaultCube_vx.x/config) and your personal game-home directory (if you chose that (highly recommended) option during the install process) in My Documents (default). You should always change things inside your game-home, because then you only need to move that directory or (re-)move specific parts from it to return to a vanilla-flavoured version of the game (read: the original). AC puts its configuration files in ./conf/. Your current settings reside in saved.cfg and any startup calls should be put into autoexec.cfg. If you need to override exisiting files, just copy them from the installation-folder to your game-home and edit them there. As an example: copy over config/keymap.cfg if you want to add new keycodes for using them in-game. Another example: if you want to add some more maps to your maps-menu, just copy over config/menus.cfg and edit the appropriate alias(es) (like defaultmaps).

Changing launch-parameters

The launcher is assaultcube.bat, by default Windows will hide the .bat-extension though - the Filetype column (in the view Details) will show it though with it's long name "Windows Batchfile"; the symbol is a window-icon with a cog overlay. If in doubt use search on the installation-folder, the installation-disk (probably C:\) or even your entire set of harddrives. It is also recommended to turn off the hiding of the extensions. Once you've found your file you can right-click it and select Edit, this will open it in Notepad - do not use Microsoft Word or even MFC Write as they may not save in plain-text format! The default contents is:

start bin_win32\ac_client.exe --init %1 %2 %3 %4 %5

If you want to add arguments - as always keep a backup of the original - you should put them before the %1 and after the --init, like - for example - so:

start bin_win32\ac_client.exe --init -w1024 -h768 -a0 -b32 -z24 -t %1 %2 %3 %4 %5

What parameters you choose depends on what you want to do, read the manual for options available - please check your local manual though, as it's definitely the proper one for your version!

You could also simply create a shortcut to the batchfile and pass the arguments via that shortcut - that's what all those %N bits are all about.

Adding custom stuff

Custom player models

You can add custom player models like this:

1. open your game-home folder.
2. open the "packages" folder
3. open the "models" folder
4. open the "playermodels" folder
5. open the "custom" folder
6. drag/copy your downloaded player skins here

Custom maps

1. Follow steps 1 and 2 of "custom player models"
2. open the "maps" folder
3. drag/copy your downloaded maps here

Custom mods

1. Follow steps 1 and 2 of "custom player models"
2. open the "mods" folder
3. add necessary commandline options (--mod=path)
4. drag/copy your downloaded mod there

Keybindings

You can bind keys to tasks and commands. You can do that in game, for example by using the unused ' and \ keys:

bind QUOTE "conskip -1000; toggleconsole"
bind BACKSLASH [ screenshot; sleep 3 [ echo "Screenshot created." ] ]

You can add the commands above to your autoexec.cfg in your config dir, or type them in game by prepending them with a slash (/). Of course, the keys chosen are just examples which were picked because they have no function by default.

Issues and errors

Most errors, such as "Win32 exception" errors are caused by bad drivers. Search on the hardware or computer manufacturer's website for the latest driver, or consider reverting to an older version if that worked before.

For newer operating systems, make sure AssaultCube can write (and read) to the directories (folders) it needs. This includes "C:\Program Files\AssaultCube..." and your game-home directory. To set permissions, right click on the folder, click "Properties" and navigate to the "Security" tab.

On Windows-7 you will not have permission to edit inside the installation directory as the user, you need to claim Administrator privileges! Ärkefiende posted on the forum the following way to manage this: Open the windows menu, type "Notepad" (without quotation marks), right click the entry and open as administrator, navigate to the file you want to edit and you´re done.