Springsettings.cfg: Difference between revisions

From Spring
Jump to navigationJump to search
Line 2,252: Line 2,252:


==WindowPosX==
==WindowPosX==
=== Description ===
Sets the horizontal position of the game window, if Fullscreen is 0. When WindowBorderless is set, this should usually be 0.


==== Values ====  
==== Values ====  
Line 2,257: Line 2,259:


<code>type</code>: int
<code>type</code>: int


==WindowPosY==
==WindowPosY==

Revision as of 08:24, 24 February 2013

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

Values

defaultValue: 0

type: bool


AtiHacks

Values

defaultValue: -1

type: int


AtiSwapRBFix

Values

defaultValue: 0

type: bool


AutoAddBuiltUnitsToFactoryGroup

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

Values

defaultValue: 0

type: bool


DualScreenMode

Values

defaultValue: 0

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

Values

defaultValue: fonts/FreeSansBold.otf

type: std::string


FontOutlineWeight

Values

defaultValue: 25

type: float


FontOutlineWidth

Values

defaultValue: 3

type: int


FontSize

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

Values

defaultValue: 0.8

type: float


HangTimeout

Description

Number of seconds that if spent in the same code segment indicate a hang; -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

Values

defaultValue: No map selected

type: std::string


LastSelectedMod

Values

defaultValue: No game selected

type: std::string


LastSelectedScript

Values

defaultValue: No script selected

type: std::string


LastSelectedSetting

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

readOnly: 1

Values

defaultValue: 0

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. 1=VBO mode 2=DL mode 3=VA 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 valid values are \always\ (default in debug builds) and ever\ (default in release builds).

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

Values

defaultValue: 2048

minimumValue: 1

type: int


ShadowProjectionMode

Values

defaultValue: 1

type: int


Shadows

Values

defaultValue: 0

type: int


ShowClock

Values

defaultValue: 1

type: bool


ShowFPS

Values

defaultValue: 0

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

Smooth lines. 0: off 1: fastest 2: don't care 3: nicest

Values

defaultValue: 2

minimumValue: 0

maximumValue: 3

safemodeValue: 0

type: int


SmoothPoints

Description

Smooth points. 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

readOnly: 1

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 update render frames in monitor's refresh rate. <=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

Values

defaultValue: 32

type: int


WindowState

Values

defaultValue: 0

type: int


WindowedEdgeMove

Values

defaultValue: 1

type: bool


XResolution

Values

defaultValue: 0

type: int


YResolution

Values

defaultValue: 0

type: int


address

Values

defaultValue:

type: std::string


name

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