Settings

This documentation displays annotated settings with default values and description. Please do not edit it directly, but add new [Desc("String")] tags to the source code. This file has been automatically generated for version {DEV_VERSION} of OpenRA.

All settings can be changed by starting the game via a command-line parameter like Game.Mod=ra.

Location

• Windows: My Documents\OpenRA\settings.yaml
• Mac OS X: ~/Library/Application Support/OpenRA/settings.yaml
• Linux ~/.openra/settings.yaml

If you create the folder Support relative to the OpenRA main directory, everything including settings gets stored there to aid portable installations.

Debug

LongTickThresholdMs

Amount of time required for triggering perf.log output.

Default Value: 1

Debug: 
	LongTickThresholdMs: 1

IgnoreVersionMismatch

Show incompatible games in server browser.

Default Value: False

Debug: 
	IgnoreVersionMismatch: False

CheckVersion

Check whether a newer version is available online.

Default Value: True

Debug: 
	CheckVersion: True

SendSystemInformation

Allow the collection of anonymous data such as Operating System, .NET runtime, OpenGL version and language settings.

Default Value: True

Debug: 
	SendSystemInformation: True

Game

AuthProfile

Filename of the authentication profile to use.

Default Value: player.oraid

Game: 
	AuthProfile: player.oraid

Graphics

Mode

This can be set to Windowed, Fullscreen or PseudoFullscreen.

Default Value: PseudoFullscreen

Graphics: 
	Mode: PseudoFullscreen

FullscreenSize

Screen resolution in fullscreen mode.

Default Value: 0,0

Graphics: 
	FullscreenSize: 0,0

WindowedSize

Screen resolution in windowed mode.

Default Value: 1024,768

Graphics: 
	WindowedSize: 1024,768

CapFramerate

Add a frame rate limiter. It is recommended to not disable this.

Default Value: True

Graphics: 
	CapFramerate: True

MaxFramerate

At which frames per second to cap the framerate.

Default Value: 60

Graphics: 
	MaxFramerate: 60

DisableWindowsDPIScaling

Disable high resolution DPI scaling on Windows operating systems.

Default Value: True

Graphics: 
	DisableWindowsDPIScaling: True

DisableWindowsRenderThread

Disable separate OpenGL render thread on Windows operating systems.

Default Value: True

Graphics: 
	DisableWindowsRenderThread: True

Player

Name

Sets the player nickname for in-game and IRC chat.

Default Value: Newbie

Player: 
	Name: Newbie

Server

Name

Sets the server name.

Default Value: OpenRA Game

Server: 
	Name: OpenRA Game

ListenPort

Sets the internal port.

Default Value: 1234

Server: 
	ListenPort: 1234

AdvertiseOnline

Reports the game to the master server list.

Default Value: True

Server: 
	AdvertiseOnline: True

Password

Locks the game with a password.

Default Value:

Server: 
	Password: 

DiscoverNatDevices

Allow users to enable NAT discovery for external IP detection and automatic port forwarding.

Default Value: False

Server: 
	DiscoverNatDevices: False

NatDiscoveryTimeout

Time in milliseconds to search for UPnP enabled NAT devices.

Default Value: 1000

Server: 
	NatDiscoveryTimeout: 1000

Map

Starts the game with a default map. Input as hash that can be obtained by the utility.

Ban

Takes a comma separated list of IP addresses that are not allowed to join.

RequireAuthentication

For dedicated servers only, allow anonymous clients to join.

Default Value: False

Server: 
	RequireAuthentication: False

ProfileIDWhitelist

For dedicated servers only, if non-empty, only allow authenticated players with these profile IDs to join.

ProfileIDBlacklist

For dedicated servers only, if non-empty, always reject players with these user IDs from joining.

EnableSingleplayer

For dedicated servers only, controls whether a game can be started with just one human player in the lobby.

Default Value: False

Server: 
	EnableSingleplayer: False

QueryMapRepository

Query map information from the Resource Center if they are not available locally.

Default Value: True

Server: 
	QueryMapRepository: True