config

(info) Most of the information here is for Warzone 3.1 and above.

config

The "config" file stored in the user folder defines a number of user-specific game settings.

 

File format

The file is a text file that uses the same formatting as Windows .ini files.

An example is shown below:

[General] voicevol=68 fxvol=37 cdvol=0 music_enabled=true width=1152

There is just one section in the file, called "[General]".

The various settings are then listed as key=value pairs, where "key" is the name of a setting and "value" is the value for that setting.

Properties

There are many properties that can be used in the file (see: original wz docs). They have been grouped in to rough categories below for ease of navigation.

Audio Playback

Related modding guides: Audio (Sound)

Setting

Menu / Screen

Default

Notes

Game ver

cdvol

Audio Options Menu 

50

Sets the music volume, ranging from:

  • 0 – No music (Mute), to

  • 100 – Loudest

 

fxvol

Audio Options Menu

100

Sets the FX volume, ranging from:

  • 0 – No sound (Mute), to

  • 100 – Loudest

 

music_enabled

 

true

Is music enabled?

  • false – Disabled

  • true – Enabled

 

playaudiocds

 

1

Automatically play audio CD if present?

  • 0 – No

  • 1 – Yes, play audio CD if present

 

sound

 

1

Should sound be played?

  • 0 – No (Mute)

  • 1 -- Yes, play sounds

 

voicevtol

 Audio Options Menu

100

Sets voice volume, between:

  • 0 – No sound (Mute)

  • 100 – Loudest

Not sure if this setting applies in recent versions.

 

Campaign

Setting

Menu / Screen

Default

Notes

Game ver

colour

Game Options Menu

0

Sets player colour for the single-player Campaign mode:

  • 0 – Green

  • 4 – Red

  • 5 – Blue

  • 6 – Pink

  • 7 – Cyan

 

difficulty

Game Options Menu

1

Sets the difficulty level for single-player Campaign mode:

  • 0 – Easy

  • 1 – Medium

  • 2 – Hard

This value is not changed by difficulty-cheats.

 

Engine (3D Graphics)

Setting

Menu / Screen

Default

Notes

Game ver

fog

 

1

Chooses fog type:

  • 0 – Distance fog

  • 1 – Fog of war

Does not appear to work (tested on Warzone 3.1 Beta 10)

 

framerate

 

60

Sets the frame rate limit.

 

shadows

Graphic Options Menu

1

Should shadows be displayed?

  • 0 – No

  • 1 – Yes, show shadows

Older graphics cards may be unable to render the game at an acceptable speed while using shadows.

This value can be changed by config parameters "--shadows" (1) and "--noshadows" (0).

 

shake

Graphic Options Menu

0

Should the camera shake when buildings are destroyed?

  • 0 – Off

  • 1 – On

This option is not affected by the shakey-cheat (whatever that is?)

 

showFPS

 

0

Should FPS (Frames Per Second) be displayed?

  • 0 – No

  • 1 – Yes, show FPS

 

textureSize

Video Options Menu

128

Sets the texture size of terrain tiles in pixels:

  • 128 – Small

  • 256

  • 512 – Medium

  • 1024

  • 2048 – Large

Lower values can increase the game's performance.

 

visfog

 

0

What should unexplored tiles look like?

  • 0 – Dimmed tiles

  • 1 – Black tiles

Does not appear to have any effect (tested on Warzone 3.1 Beta 10)

 

Fonts

These settings determine which font is used for menus, etc.

Related forums discussion: Changing font.

Setting

Menu / Screen

Default

Notes

Game ver

fontname

 

 

Defines the name of the font that will be used for menus and other in-game text.

 

fontfacebold

 

 

Should the font be bold?

  • bold – yes, make the font bold

  • ???

 

fontface

 

 

???

 

type

 

12?

What size should the font be?

 

Graphics Card

Setting

Menu / Screen

Default

Notes

Game ver

bpp

 

32

Sets the colour depth in bpp = bits per pixel.

 

FSAA

Video Options Menu

See also: Spatial anti-aliasing (wikipedia)

 

gamma

 

20

Sets the gamma value Warzone 2100 will use.

This will have an effect on the whole screen, so do not be surprised to see your whole screen getting brighter/darker when playing in windowed mode.

Minimum value is 10 and stands for 0.5 times the normal screen intensity, maximum value is 200 and stands for 10 times the normal screen intensity.

Does not appear to work (tested in Warzone 3.1 Beta 10 on a Mac - could see no noticeable difference between 10 and 200)

 

vsync

Video Options Menu

Vertical sync

 

Mouse

Setting

Menu / Screen

Default

Notes

Game ver

ColouredCursor

 

0 on Windows/Linux,
1 on Mac OS X

Use coloured mouse cursor?

  • 0 - Use (faster) hardware accelerated monochrome cursors

  • 1 – Use (slower) coloured cursors

 

MiddleClickRotate

Mouse Options Menu

0

 

mouseflip

Mouse Options Menu

1

Sets behaviour of camera movement when holding down right mouse button and moving mouse up/down:

  • 0 – Tilt in same direction as mouse movement

  • 1 – Tilt in opposite direction of mouse movement

 

nomousewarp

 

0

 

RightClickOrders

Mouse Options Menu

0

Which mouse button to use for ordering units to attack, move, etc?

  • 0 – Left click

  • 1 – Right click

Right click is how most other RTS games work, such as StarCraft and WarCraft.

 

reopenBuild

 

1

Should build menu re-open?

  • 0 – No

  • 1 – Yes, re-open it

No idea what this means!

 

scroll

Game Options Menu

1000

Defines the maximum scroll speed and scroll speed acceleration, between:

  • 1 – unbearably slow, to

  • 4000 – rather fast

Sane values range from 200 (slow) to 4000 (rather fast). If you specify 0, the game will default to 100.

The setting on the Game Options Menu ranges from 100 to 1600.

 

trapCursor

Mouse Options Menu

0

Should the mouse cursor be trapped in the game window?

  • 0 – No

  • 1 – Yes, trap the cursor

Only applies when in windowed mode. It prevents accidentally clicking off the game window.

 

New Game (Skirmish & Multiplayer)

These options are set when you start a Skirmish or Multiplayer game, and are then saved to the config file.

Setting

Menu / Screen

Default

Notes

Game ver

alliance

Skirmish Setup Screen

0

Stores alliance mode for Skirmish and Multiplayer games:

See also: alliancesType and allianceExistsBetween().

 

base

Skirmish Setup Screen

1

Stores the base type for Skirmish and Multiplayer games:

See also: baseType. The base type effects are applied via rules.js.

 

colourMP

 

What faction colour is preferred for Skirmish and Multiplayer games?

<need to add list of values>

Note that this colour cannot be guaranteed in multiplayer games as someone else might have already taken it.

3.1

gameName

Host Game Setup Screen

My Game

Sets the game name for Multiplayer games.

Limited to 79 bytes, so beware when using multi-byte characters such as German umlaute or Japanese kanji.

 

mapName

Skirmish Game Setup Screen

Host Game Setup Screen

Sk-Rush

Sets the default map name of the map Warzone 2100 will use when starting skirmish or multi player games.

Does not appear to work on single-player Skirmish games (tested in Warzone 3.1 Beta 10)

See also: mapName.

 

maxPlayers

 

 

power

Skirmish Game Setup Screen

Host Game Setup Screen

400

Sets the default power level to use:

  • 100 – Low power

  • 400 – Medium power

  • 700 – High power

If you specify any other number, Warzone will default to the Medium Power setting.

See also: powerType

These values might be wrong (see powerType for what the JS API is reporting).

 

Network / Router

Setting

Menu / Screen

Default

Notes

Game ver

gameserver_port

Host Game Setup Screen

9999

Sets the port Warzone 2100 will listen to when hosting games.

Make sure that you can communicate on the specified port.

 

masterserver_name

 

lobby.wz2100.net

Sets the lobby server Warzone 2100 will use when entering the lobby and for showing your hosted multiplayer games.

 

masterserver_port

 

9997

Sets the port used to communicate with the lobby server specified in 'masterserver_name'.

 

UPnP

 

1

Should UPnP (Universal Plug n Play) be enabled?

  • 0 – No

  • 1 – Yes, enable UPnP

When enabled, Warzone will try to automatically configure the port forwarding in your router, if your router supports UPnP.

 

 

Player

Setting

Menu / Screen

Default

Notes

Game ver

language

 

<system locale>

What language (locale) should the game use?

 

playerName

 

Player

Sets your name used in skirmish and multi player games.

There is a profile for every playername you ever played with in your warzone directory.

 

Radar / Mini-map / Sensors

Setting

Menu / Screen

Default

Notes

Game ver

radarObjectMode

 

0

Show friend vs. foe colours on the mini map?

  • 0 – No, show player colours

  • 1 – Yes, limit colours to friend or foe

Note: The value is not affected by using Ctrl+Tab.

 

radarTerrainMode

 

0

How should terrain be rendered on the mini map?

  • 0 or 1 – Terrain only

  • 2 – Heightmap only

  • 3 – Terrain and heightmap combined

  • 4 – Terrain and no heightmap

Any other value will default to Terrain only mode.

Looks like the above might be wrong (tested on Warzone 3.1 Beta 10 - see screenshots below, 0 = first, 4 = last).

 

rotateRadar

Graphic Options Menu

true

Should radars/sensors rotate?

  • false – Stationery

  • true – Rotating

See also: Change direction of sensor spin? (wz forums)

 

Video Playback

Related modding guides: Video (Cinematics)

Setting

Menu / Screen

Default

Notes

Game ver

allowSubtitles

 

0

Determines whether subtitles are shown for videos:

  • 0 – No subtitles

  • 1 – Show subtitles

No idea how this relates to the 'subtitles' option below!

 

subtitles

Graphic Options Menu

1

Should subtitles be shown during video playback?

  • 0 – No

  • 1 – Yes, show subtitles

Note: If enabled, subtitles will be shown even if the video does not exist.

 

FMVmode

Graphic Options Menu

0

Sets playback size for FMVs (full motion videos):

  • 0 – Full screen, stretching video

  • 1 – Normal size

  • 2 – 2 x Normal size

  • 3 – Full screen, preserving video's aspect ratio

 

sequences

 

0

Should video sequences be played?

  • 0 – No

  • 1 – Yes, play videos

The default value is likely to be changed in future releases as the videos have been liberated.

 

Warzone (screen size, etc)

Setting

Menu / Screen

Default

Notes

Game ver

debugmode

 

0

Start in "debug mode" (aka "Cheat mode"):

  • 0 – Normal mode

  • 1 – Debug mode

The command line parameter "--cheat" sets this to 1. In order to unset to 0 the file has be to edited by hand.

 

fullscreen

Video Options Menu

1

Start the game in full screen mode?

  • 0 – Windowed

  • 1 – Full screen

In Warzone 3.1 and above the permitted values are:

  • false – Windowed

  • true – Full screen

 

height

Video Options Menu

480

Sets the height of the screen resolution Warzone 2100 will use.

Equivalent to the height value of command line parameter "--resolution".

 

PauseOnFocusLoss

 

false

Should the game automatically pause if it loses focus?

  • false – No

  • true – Yes, pause the game

 

width

Video Options Menu

640

Sets the width of the screen resolution Warzone 2100 will use.

Equivalent to the width value of command line parameter "--resolution".

 

Other settings

Setting

Menu / Screen

Default

Notes

phrase0

phrase1

phrase2

phrase3

phrase4

 

 

Sets five predefinable messages used for multi player mode to throw at your opponent.

Enter chat mode and then press F1 (phrase0) to F5 (phrase4) to send the corresponding phrase.

It is not recommended to use these as it may not always work as expected.

These are limited to 79 bytes, so beware if you are using multi-byte characters such as German umlaute or Japanese kanji.

reopenBuild

 

1

Should build menu re-open?

  • 0 – No

  • 1 – Yes, re-open it

scanlines

Graphic Options Menu

2