Springsettings.cfg
SpringSettings \ Springrc
Below is a comprehensive list of all the values available for use in springsettings. This page is an attempt to thoroughly document them all.
Here is a raw springsettings file (cleaned but without values) http://paste.springfiles.com/view/648280bc
3DTrees
Description
Defines whether or not the trees generated by the engine (Default trees) will be shown as 3d or as cross sectioned ( + ) flat sides.
Values
defaultValue: 1
safemodeValue: 0
type: bool
AI_UnpauseAfterInit
Values
defaultValue: 1
type: bool
AdvMapShading
Description
Determines whether specular highlights and other lighting effects are rendered for terrain
Values
defaultValue: 1
safemodeValue: 0
minimumValue: 0
maximumValue: 1
type: bool
AdvSky
Values
defaultValue: 0
type: bool
AdvUnitShading
Description
Determines whether specular highlights and other lighting effects are rendered for units
Values
defaultValue: 1
safemodeValue: 0
minimumValue: 0
maximumValue: 1
type: bool
AllowAdditionalPlayers
Description
Necessary in order to allow players to "midgame join" (Connect in midgame) to the computer that is hosting the game. AllowAdditionalPlayers is linked with "ReconnectTimeout" in such a way that if ReconnectTimeout is 0, midgame join will not be possible.
Values
defaultValue: 0
type: bool
AtiHacks
Description
Enables graphics drivers workarounds for users with ATI video cards.
Values
defaultValue: -1
type: int
AtiSwapRBFix
Values
defaultValue: 0
type: bool
AutoAddBuiltUnitsToFactoryGroup
Description
Controls whether or not units built by factories will inherit that factory's unit group.
Values
defaultValue: 0
type: bool
AutoAddBuiltUnitsToSelectedGroup
Values
defaultValue: 0
type: bool
AutohostIP
Values
defaultValue: 127.0.0.1
type: std::string
AutohostPort
Values
defaultValue: 0
type: int
BuildIconsFirst
Values
defaultValue: 0
type: bool
BumpWaterAnisotropy
Values
defaultValue: 0
type: float
BumpWaterBlurReflection
Values
defaultValue: 0
type: bool
BumpWaterDepthBits
Values
defaultValue: 24
type: int
BumpWaterDynamicWaves
Values
defaultValue: 1
type: bool
BumpWaterEndlessOcean
Description
Sets whether Bumpmapped water will be drawn beyond the map edge.
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
BumpWaterOcclusionQuery
Values
defaultValue: 1
type: bool
BumpWaterReflection
Description
Determines the amount of objects reflected in Bumpmapped water.
Options are:
0 = Reflect nothing
1 = Reflect units and features
2 = Reflect everything
Values
defaultValue: 1
minimumValue: 0
maximumValue: 2
type: int
BumpWaterRefraction
Description
Determines the method of refraction with Bumpmapped water.
Options are:
0 = No Refraction
1 = Refraction by screencopy
May refract objects hovering above water
2 = Refraction gets its own draw pass
Only objects below water are refracted
Values
defaultValue: 1
minimumValue: 0
maximumValue: 2
type: int
BumpWaterShoreWaves
Description
Sets whether special waves for shores are generated with Bumpmapped water
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
BumpWaterTexSizeReflection
Description
Sets the size of the framebuffer texture used to store the reflection in Bumpmapped water.
Values
defaultValue: 512
type: int
BumpWaterUseDepthTexture
Values
defaultValue: 1
type: bool
BumpWaterUseUniforms
Values
defaultValue: 0
type: bool
CamFreeAngVelTime
Values
defaultValue: 1
type: float
CamFreeAutoTilt
Values
defaultValue: 150
type: float
CamFreeEnabled
Values
defaultValue: 0
type: bool
CamFreeFOV
Values
defaultValue: 45
type: float
CamFreeGoForward
Values
defaultValue: 0
type: bool
CamFreeGravity
Values
defaultValue: -500
type: float
CamFreeGroundOffset
Values
defaultValue: 16
type: float
CamFreeInvertAlt
Values
defaultValue: 0
type: bool
CamFreeScrollSpeed
Values
defaultValue: 500
type: float
CamFreeSlide
Values
defaultValue: 0.5
type: float
CamFreeTiltSpeed
Values
defaultValue: 150
type: float
CamFreeVelTime
Values
defaultValue: 1.5
type: float
CamMode
Description
Defines the used camera.
Options are:
0 = FPS
1 = Overhead
2 = TotalWar
3 = RotOverhead
4 = Free
5 = SmoothOverhead
6 = Orbit
7 = Overview
Values
defaultValue: 5
minimumValue: 0
maximumValue: 7
type: int
CamModeName
Values
defaultValue:
type: std::string
CamTimeExponent
Values
defaultValue: 4
minimumValue: 0
type: float
CamTimeFactor
Values
defaultValue: 1
minimumValue: 0
type: float
CatchAIExceptions
Values
defaultValue: 1
type: int
ColorElev
Values
defaultValue: 1
type: bool
CompressTextures
Values
defaultValue: 0
safemodeValue: 1
type: bool
CrossAlpha
Values
defaultValue: 0.5
type: float
CrossMoveScale
Values
defaultValue: 1
type: float
CrossSize
Values
defaultValue: 12
type: float
CubeTexSizeReflection
Values
defaultValue: 128
minimumValue: 1
type: int
CubeTexSizeSpecular
Values
defaultValue: 128
minimumValue: 1
type: int
DemoFromDemo
Values
defaultValue: 0
type: bool
DepthBufferBits
Values
defaultValue: 24
type: int
DisableCrappyGPUWarning
Values
defaultValue: 0
type: bool
DoubleClickTime
Values
defaultValue: 200
type: float
DualScreenMiniMapOnLeft
Description
When set, will make the left half of the screen the minimap when DualScreenMode is set.
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
DualScreenMode
Description
Sets whether to split the screen in half, with one half for minimap and one for main screen. Right side is for minimap unless DualScreenMinimapOnLeft is set. Does not work with LuaUI.
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
DynamicSky
Description
Sets whether the clouds in the sky will be procedurally generated and moved
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
DynamicSun
Description
Sets whether the sun will move around the sky throughout the game. The sun's movement has a period of about 20 minutes.
The sun will always stay above DynamicSunMinElevation
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
DynamicSunMinElevation
Description
Sets the minimum elevation of the dynamic sun. If less than 0.0, the sun can disappear under the map completely as it moves.
Values
defaultValue: 0.1
type: float
EnableDrawCallIns
Values
defaultValue: 1
type: bool
ExtraTextureUpdateRate
Values
defaultValue: 45
type: int
FPSEnabled
Values
defaultValue: 1
type: bool
FPSFOV
Values
defaultValue: 45
type: float
FPSMouseScale
Values
defaultValue: 0.01
type: float
FPSScrollSpeed
Values
defaultValue: 10
type: int
FSAALevel
Values
defaultValue: 0
type: int
FeatureDrawDistance
Values
defaultValue: 6000
minimumValue: 0
type: float
FeatureFadeDistance
Values
defaultValue: 4500
minimumValue: 0
type: float
FixAltTab
Values
defaultValue: 0
type: bool
FontFile
Description
Sets the font of Spring engine text.
Values
defaultValue: fonts/FreeSansBold.otf
type: std::string
FontOutlineWeight
Sets the opacity of Spring engine text, such as the title screen version number, clock, and basic UI. Does not affect LuaUI elements.
Values
defaultValue: 25
type: float
FontOutlineWidth
Description
Sets the width of the black outline around Spring engine text, such as the title screen version number, clock, and basic UI. Does not affect LuaUI elements.
Values
defaultValue: 3
type: int
FontSize
Description
Sets the font size (in pixels) of the Spring.exe main menu.
Values
defaultValue: 23
type: int
Fullscreen
Description
Sets whether the game will run in fullscreen, as opposed to a window. For Windowed Fullscreen of Borderless Window, set this to 0, WindowBorderless to 1, and WindowPosX and WindowPosY to 0.
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
FullscreenEdgeMove
Description
Sets whether moving the mouse cursor to the screen edge will move the camera across the map
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
GrassDetail
Values
defaultValue: 3
type: int
GroundDecals
Values
defaultValue: 1
type: int
GroundDetail
Values
defaultValue: 60
type: int
GroundLODScaleReflection
Values
defaultValue: 1
type: float
GroundLODScaleRefraction
Values
defaultValue: 1
type: float
GroundLODScaleUnitReflection
Values
defaultValue: 1
type: float
GroundNormalTextureHighPrecision
Values
defaultValue: 0
type: bool
GroundScarAlphaFade
Values
defaultValue: 0
type: int
GuiOpacity
Description
Sets the opacity of the built-in Spring UI. Generally has no effect on LuaUI widgets. Can be set in-game using shift+, to decrease and shift+. to increase.
Values
defaultValue: 0.8
minimumValue: 0.0
maximumValue: 1.0
type: float
HangTimeout
Description
Number of seconds that if spent in the same code segment indicate a hang. Set to -1 to disable.
Values
defaultValue: 10
minimumValue: -1
maximumValue: 600
type: int
HardwareCursor
Values
defaultValue: 0
type: bool
HardwareThreadCount
Values
defaultValue: 0
safemodeValue: 1
type: int
HeightMapTexture
Values
defaultValue: 1
type: bool
HighResLos
Values
defaultValue: 0
type: bool
InfoConsoleGeometry
Values
defaultValue: 0.26 0.96 0.41 0.205
type: std::string
InfoMessageTime
Values
defaultValue: 400
type: int
InitialNetworkTimeout
Values
defaultValue: 30
minimumValue: 10
type: int
InputTextGeo
Values
defaultValue:
type: std::string
InvertMouse
Values
defaultValue: 0
type: bool
InvertQueueKey
Values
defaultValue: 0
type: bool
JoystickEnabled
Values
defaultValue: 1
type: bool
JoystickUse
Values
defaultValue: 0
type: int
LODScale
Values
defaultValue: 1
type: float
LODScaleReflection
Values
defaultValue: 1
type: float
LODScaleRefraction
Values
defaultValue: 1
type: float
LODScaleShadow
Values
defaultValue: 1
type: float
LastSelectedMap
Description
Stores the previously played map.
Values
defaultValue: No map selected
type: std::string
LastSelectedMod
Description
Stores the previously played game.
Values
defaultValue: No game selected
type: std::string
LastSelectedScript
Description
Stores the previously played AI.
Values
defaultValue: No script selected
type: std::string
LastSelectedSetting
Description
Stores the previously selected setting, when editing settings within the Spring main menu.
Values
defaultValue:
type: std::string
LinkIncomingMaxPacketRate
Values
defaultValue: 64
minimumValue: 0
type: int
LinkIncomingMaxWaitingPackets
Values
defaultValue: 512
minimumValue: 0
type: int
LinkIncomingPeakBandwidth
Values
defaultValue: 32768
minimumValue: 0
type: int
LinkIncomingSustainedBandwidth
Values
defaultValue: 2048
minimumValue: 0
type: int
LinkOutgoingBandwidth
Values
defaultValue: 65536
minimumValue: 0
type: int
LoadingMT
Values
defaultValue: -1
safemodeValue: 0
type: int
LobbyServer
Values
defaultValue: lobby.springrts.com
type: std::string
LogFlush
Description
Instantly write to the logfile use only for debugging as it will cause a slowdown
Values
defaultValue: 0
type: bool
LogSections
Description
Comma seperated list of enabled logsections see infolog.txt / console output for possible values
Values
defaultValue:
type: std::string
LuaModUICtrl
Values
defaultValue: 1
type: bool
LuaShaders
Values
defaultValue: 1
safemodeValue: 0
type: bool
LuaSocketEnabled
Description
Enable LuaSocket support allows a lua-widget to make TCP/UDP Connections.
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
MTInfoThreshold
Values
defaultValue: 1
type: float
MaxDynamicMapLights
Values
defaultValue: 1
minimumValue: 0
type: int
MaxDynamicModelLights
Values
defaultValue: 1
minimumValue: 0
type: int
MaxNanoParticles
Values
defaultValue: 2500
type: int
MaxParticles
Values
defaultValue: 1000
type: int
MaxPathCostsMemoryFootPrint
Values
defaultValue: 536870912
type: int
MaxSounds
Values
defaultValue: 128
type: int
MaximumTransmissionUnit
Values
defaultValue: 1400
minimumValue: 400
type: int
MetalMapPalette
Values
defaultValue: 0
type: bool
MiddleClickScrollSpeed
Values
defaultValue: 0.01
type: float
MiniMapButtonSize
Values
defaultValue: 16
type: int
MiniMapCursorScale
Values
defaultValue: -0.5
type: float
MiniMapDrawCommands
Values
defaultValue: 1
minimumValue: 0
type: int
MiniMapDrawProjectiles
Values
defaultValue: 1
type: bool
MiniMapFullProxy
Values
defaultValue: 1
type: bool
MiniMapGeometry
Values
defaultValue: 2 2 200 200
type: std::string
MiniMapIcons
Values
defaultValue: 1
type: bool
MiniMapMarker
Values
defaultValue: 1
type: bool
MiniMapUnitExp
Values
defaultValue: 0.25
type: float
MiniMapUnitSize
Values
defaultValue: 2.5
minimumValue: 0
type: float
MouseDragScrollThreshold
Values
defaultValue: 0.3
type: float
MultiThreadDrawUnit
Values
defaultValue: 1
type: bool
MultiThreadDrawUnitShadow
Values
defaultValue: 1
type: bool
MultiThreadLua
Values
defaultValue: 0
minimumValue: 0
maximumValue: 6
type: int
NetworkLossFactor
Values
defaultValue: 0
minimumValue: 0
maximumValue: 2
type: int
NetworkTimeout
Values
defaultValue: 120
minimumValue: 0
type: int
NoHelperAIs
Values
defaultValue: 0
type: bool
NoSound
Values
defaultValue: 0
type: bool
OrbitControllerEnabled
Values
defaultValue: 1
type: bool
OrbitControllerOrbitSpeed
Values
defaultValue: 0.25
minimumValue: 0.1
maximumValue: 10
type: float
OrbitControllerPanSpeed
Values
defaultValue: 2
minimumValue: 0.1
maximumValue: 10
type: float
OrbitControllerZoomSpeed
Values
defaultValue: 5
minimumValue: 0.1
maximumValue: 10
type: float
OscStatsSenderDestinationAddress
Values
defaultValue: 127.0.0.1
type: std::string
OscStatsSenderDestinationPort
Values
defaultValue: 6447
minimumValue: 0
maximumValue: 65535
type: int
OscStatsSenderEnabled
Values
defaultValue: 0
type: bool
OverheadEnabled
Values
defaultValue: 1
type: bool
OverheadFOV
Values
defaultValue: 45
type: float
OverheadScrollSpeed
Values
defaultValue: 10
type: int
OverheadTiltSpeed
Values
defaultValue: 1
type: float
PitchAdjust
Values
defaultValue: 0
type: bool
ROAM
Description
Use ROAM for terrain mesh rendering.
Options are:
1: Vertex Buffer Object mode
2: Display List mode (compatibility)
3: Vertex Array mode
Values
defaultValue: 1
safemodeValue: 2
type: int
ReconnectTimeout
Values
defaultValue: 15
minimumValue: 0
type: int
ReflectiveWater
Description
Defines the type of water rendering. Can be set in game.
Options are:
0 = Basic water
1 = Reflective water
2 = Reflective and Refractive water
3 = Dynamic water
4 = Bumpmapped water
Values
defaultValue: 1
safemodeValue: 0
minimumValue: 0
maximumValue: 4
type: int
RotOverheadEnabled
Values
defaultValue: 1
type: bool
RotOverheadFOV
Values
defaultValue: 45
type: float
RotOverheadMouseScale
Values
defaultValue: 0.01
type: float
RotOverheadScrollSpeed
Values
defaultValue: 10
type: int
RotateLogFiles
Description
Rotate logfiles.
Options are:
always (default in debug builds)
never (default in release builds)
auto
Values
defaultValue: auto
type: std::string
SM3ForceFallbackTex
Values
defaultValue: 0
type: bool
SM3MaxTextureStages
Values
defaultValue: 10
type: int
SM3TerrainDetail
Values
defaultValue: 200
type: int
SMFTexAniso
Values
defaultValue: 0
type: float
ScreenshotCounter
Values
defaultValue: 0
type: int
ScrollWheelSpeed
Values
defaultValue: 25
minimumValue: -255
maximumValue: 255
type: float
SetCoreAffinity
Description
Defines a bitmask indicating which CPU cores the main-thread should use.
Values
defaultValue: 0
safemodeValue: 1
type: unsigned
ShadowMapSize
Description
Sets the resolution of shadows. Higher numbers increase quality at the cost of performance.
Values
defaultValue: 2048
minimumValue: 1
type: int
ShadowProjectionMode
Values
defaultValue: 1
type: int
Shadows
Sets whether shadows are rendered.
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: int
ShowClock
Description
Displays a clock on the top-right corner of the screen showing the elapsed time of the current game.
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
ShowFPS
Description
Displays current framerate.
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
ShowHealthBars
Values
defaultValue: 1
type: bool
ShowMTInfo
Values
defaultValue: 1
type: bool
ShowPlayerInfo
Values
defaultValue: 1
type: int
ShowRezBars
Values
defaultValue: 1
type: bool
ShowSpeed
Values
defaultValue: 0
type: bool
SimpleMiniMapColors
Values
defaultValue: 0
type: bool
SmallFontFile
Values
defaultValue: fonts/FreeSansBold.otf
type: std::string
SmallFontOutlineWeight
Values
defaultValue: 10
type: float
SmallFontOutlineWidth
Values
defaultValue: 2
type: int
SmallFontSize
Values
defaultValue: 14
type: int
SmoothEnabled
Values
defaultValue: 1
type: bool
SmoothFOV
Values
defaultValue: 45
type: float
SmoothLines
Description
Make lines display smoothly.
Options Are:
0: off
1: fastest
2: don't care
3: nicest
Values
defaultValue: 2
minimumValue: 0
maximumValue: 3
safemodeValue: 0
type: int
SmoothPoints
Description
Makes points display smoothly.
0: off
1: fastest
2: don't care
3: nicest
Values
defaultValue: 2
minimumValue: 0
maximumValue: 3
safemodeValue: 0
type: int
SmoothScrollSpeed
Values
defaultValue: 10
type: int
SmoothTiltSpeed
Values
defaultValue: 1
type: float
SourcePort
Values
defaultValue: 0
type: int
SpeedControl
Values
defaultValue: 0
type: int
SpringData
Description
List of addidional data-directories separated by ';' on windows ':' on other OSs.
Options are:
readOnly
Values
defaultValue:
type: std::string
StencilBufferBits
Values
defaultValue: 8
type: int
TCPAllowConnect
readOnly: 1
Values
defaultValue:
type: std::string
TCPAllowListen
readOnly: 1
Values
defaultValue:
type: std::string
TWEnabled
Values
defaultValue: 1
type: bool
TWFOV
Values
defaultValue: 45
type: float
TWScrollSpeed
Values
defaultValue: 10
type: int
TeamHighlight
Values
defaultValue: 1
minimumValue: 0
maximumValue: 2
type: int
TeamNanoSpray
Values
defaultValue: 1
type: bool
TextureLODBias
Values
defaultValue: 0
type: float
TooltipGeometry
Values
defaultValue: 0.0 0.0 0.41 0.1
type: std::string
TooltipOutlineFont
Values
defaultValue: 1
type: bool
TreeRadius
Values
defaultValue: 1408
minimumValue: 0
type: int
UDPAllowConnect
readOnly: 1
Values
defaultValue:
type: std::string
UDPAllowListen
readOnly: 1
Values
defaultValue:
type: std::string
UnitIconDist
Values
defaultValue: 10000
type: int
UnitLodDist
Values
defaultValue: 1000
type: int
UnitTransparency
Values
defaultValue: 0.7
type: float
UseDistToGroundForIcons
Values
defaultValue: 0.95
type: float
UseEFX
Values
defaultValue: 1
safemodeValue: 0
type: bool
UsePBO
Values
defaultValue: 1
safemodeValue: 0
type: bool
VSync
Description
Vertical synchronization. Force render frames to update with monitor refresh. Stops tearing artifacts from framerates greater than monitor refresh rate, but can cause framerate drops when framerates are less than monitor refresh rate. Typical monitor refresh rates are 60Hz in North America and 50Hz in Europe.
Options are:
0: off
1: enabled
x: render with monitor-Hz/x FPS
Values
defaultValue: 0
minimumValue: 0
type: int
WhiteListAdditionalPlayers
Values
defaultValue: 1
type: bool
WindowBorderless
Description
When set and Fullscreen is 0, will put the game in Borderless Window mode, also known as Windowed Fullscreen. When using this, it is generally best to also set WindowPosX and WindowPosY to 0
Values
defaultValue: 0
minimumValue: 0
maximumValue: 1
type: bool
WindowPosX
Description
Sets the horizontal position of the game window, if Fullscreen is 0. When WindowBorderless is set, this should usually be 0.
Values
defaultValue: 32
type: int
WindowPosY
Sets the horizontal position of the game window, if Fullscreen is 0. When WindowBorderless is set, this should usually be 0.
Values
defaultValue: 32
type: int
WindowState
Values
defaultValue: 0
type: int
WindowedEdgeMove
Description
Sets whether moving the mouse cursor to the edge of the game window will move the camera across the map.
Values
defaultValue: 1
minimumValue: 0
maximumValue: 1
type: bool
XResolution
Description
Sets the width of the game screen. Setting this or YResolution to 0 will make the game screen match the current resolution of your desktop. Will change your desktop resolution if Fullscreen is set.
Values
defaultValue: 0
type: int
YResolution
Description
Sets the height of the game screen. Setting this or XResolution to 0 will make the game screen match the current resolution of your desktop. Will change your desktop resolution if Fullscreen is set.
Values
defaultValue: 0
type: int
address
Values
defaultValue:
type: std::string
name
Description
Sets your name in the game. Since this is overridden by lobbies with your lobby username when playing, it usually only comes up when viewing replays or starting the engine directly for testing purposes.
Values
defaultValue: UnnamedPlayer
type: std::string
snd_airAbsorption
Values
defaultValue: 0.1
type: float
snd_device
Values
defaultValue:
type: std::string
snd_volbattle
Values
defaultValue: 100
type: int
snd_volgeneral
Values
defaultValue: 100
type: int
snd_volmaster
Values
defaultValue: 60
type: int
snd_volmusic
Values
defaultValue: 100
type: int
snd_volui
Values
defaultValue: 100
type: int
snd_volunitreply
Values
defaultValue: 100
type: int
