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 release-20200503 of OpenRA.

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

Location

• Windows: %APPDATA%\OpenRA\settings.yaml
• Mac OS X: ~/Library/Application Support/OpenRA/settings.yaml
• Linux ~/.config/openra/settings.yaml

Older releases (before playtest-20190825) used different locations, which newer versions may continue to use in some circumstances:

• Windows: %USERPROFILE%\Documents\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

PerfText

Display average FPS and tick/render times

Default Value: False

Debug: 
	PerfText: False

PerfGraph

Display a graph with various profiling traces

Default Value: False

Debug: 
	PerfGraph: False

Samples

Numer of samples to average over when calculating tick and render times.

Default Value: 25

Debug: 
	Samples: 25

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

SystemInformationVersionPrompt

Version of sysinfo that the player last opted in or out of.

Default Value: 0

Debug: 
	SystemInformationVersionPrompt: 0

UUID

Sysinfo anonymous user identifier.

Default Value: 1d585e98-883c-4ad2-94ee-e0346736d1a1

Debug: 
	UUID: 1d585e98-883c-4ad2-94ee-e0346736d1a1

DisplayDeveloperSettings

Enable hidden developer settings in the Advanced settings tab.

Default Value: False

Debug: 
	DisplayDeveloperSettings: False

BotDebug

Display bot debug messages in the game chat.

Default Value: False

Debug: 
	BotDebug: False

LuaDebug

Display Lua debug messages in the game chat.

Default Value: False

Debug: 
	LuaDebug: False

EnableDebugCommandsInReplays

Enable the chat field during replays to allow use of console commands.

Default Value: False

Debug: 
	EnableDebugCommandsInReplays: False

LongTickThresholdMs

Amount of time required for triggering perf.log output.

Default Value: 1

Debug: 
	LongTickThresholdMs: 1

SyncCheckUnsyncedCode

Throw an exception if the world sync hash changes while evaluating user input.

Default Value: False

Debug: 
	SyncCheckUnsyncedCode: False

SyncCheckBotModuleCode

Throw an exception if the world sync hash changes while evaluating BotModules.

Default Value: False

Debug: 
	SyncCheckBotModuleCode: False

Game

AuthProfile

Filename of the authentication profile to use.

Default Value: player.oraid

Game: 
	AuthProfile: player.oraid

IntroductionPromptVersion

Version of introduction prompt that the player last viewed.

Default Value: 0

Game: 
	IntroductionPromptVersion: 0

Graphics

Mode

This can be set to Windowed, Fullscreen or PseudoFullscreen.

Default Value: PseudoFullscreen

Graphics: 
	Mode: PseudoFullscreen

VSync

Enable VSync.

Default Value: True

Graphics: 
	VSync: True

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.

Default Value: False

Graphics: 
	CapFramerate: False

MaxFramerate

At which frames per second to cap the framerate.

Default Value: 60

Graphics: 
	MaxFramerate: 60

DisableWindowsRenderThread

Disable separate OpenGL render thread on Windows operating systems.

Default Value: True

Graphics: 
	DisableWindowsRenderThread: True

DisableGLDebugMessageCallback

Disable the OpenGL debug message callback feature.

Default Value: False

Graphics: 
	DisableGLDebugMessageCallback: False

DisableHardwareCursors

Disable operating-system provided cursor rendering.

Default Value: False

Graphics: 
	DisableHardwareCursors: False

DisableLegacyGL

Disable legacy OpenGL 2.1 support.

Default value: False

Graphics:
	DisableLegacyGL: False

VideoDisplay

Display index to use in a multi-monitor fullscreen setup.

Default Value: 0

Graphics: 
	VideoDisplay: 0

GLProfile

Preferred OpenGL profile to use.

Modern: OpenGL Core Profile 3.2 or greater.

Embedded: OpenGL ES 3.0 or greater.

Legacy: OpenGL 2.1 with framebuffer_object extension (requires DisableLegacyGL: False).

Default Value: Modern

Graphics: 
	GLProfile: Modern

Player

Name

Sets the player nickname.

Default Value: Commander

Player: 
	Name: Commander

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

EnableSyncReports

Enable client-side report generation to help debug desync errors.

Default Value: False

Server: 
	EnableSyncReports: False

TimestampFormat

Sets the timestamp format. Defaults to the ISO 8601 standard.

Default Value: yyyy-MM-ddTHH:mm:ss

Server: 
	TimestampFormat: yyyy-MM-ddTHH:mm:ss

ShareAnonymizedIPs

Allow clients to see anonymised IPs for other clients.

Default Value: True

Server: 
	ShareAnonymizedIPs: True

EnableGeoIP

Allow clients to see the country of other clients.

Default Value: True

Server: 
	EnableGeoIP: True