The Worldspawn Entity

The worldspawn entity is the core of the `.map` file structure. All world brushes appear within the context of the worldspawn entity. *Quetoo* adds several new properties to the worldspawn entity which impact everything from atmospheric weather to gameplay modes to lightmap resolution.

Runtime Variables
—-
The following worldspawn keys are resolved at runtime, and may be overridden at the server operator’s discretion via `maps.lst`.

message
: The map title string, e.g. `^2S^7tress ^2F^7ractures by ^2J^7ester`. Color escape sequences are supported. Avoid newline characters.

sky
: The skybox prefix, e.g. `unit1_`, `thundersky_`, etc..

weather
: Atmospheric weather type for the level. Valid values are none, rain, snow. You may also append fog, and optionally a fog color specified as rgb floating point numbers, e.g. `rain fog 1.0 0.9 0.8`. A fourth fog component will modify the dog density, e.g. `rain fog 1.0 0.9 0.8 0.7`.

gravity
: The world gravity constant for the level, defaults to `800`.

gameplay
: The default gameplay type for the level. One of deathmatch, instagib, or rocket arena.

teams
: Controls teams play. `0` is off, `1` is on, and `2` tries to enforce balanced teams.

ctf
: Controls capture the flag. `0` is off, `1` is on, and `2` tries to enforce balanced teams.

match
: Controls match mode, where players must ready-up for a match to begin. `0` is off, `1` is on.

frag_limit
: Specifies maximum score a player may reach before an intermission.

round_limit
: Specifies the maximum rounds played before an intermission. Usually used in conjunction with rocket arena gameplay.

capture_limit
: Specifies the maximum captures to transpire before an intermission. Only useful for ctf levels.

time_limit
: Specifies maximum time, in minutes, that will transpire before an intermission.

give
: A comma-delimited items list which each player will receive upon respawn, e.g. `rocket launcher, super shotgun`.

Compile-time Variables
—-
The following worldspawn keys are resolved at compile time, and must be set before BSP compilation.

ambient_light
: Specifies ambient light, or the minimum global lighting value for all light samples, as an rgb color, e.g. `0.07 0.06 0.06`. A small ambient factor is recommended for most levels.

brightness
: Controls light scale. This is used to uniformly brighten or darken your level. `1.0` is default, all positive floating point values are valid.

contrast
: Controls light contrast. This can be used to create darker dark areas and lighter light areas. The default value is `1.0`. Values significantly higher than `1.0` are not recommended.

lightmap_scale
: Controls lightmap resolution, which is relative to texture size. Default is `.0625` (1/16). A value of `0.125` will produce sharper lightmaps, but will lengthen your static lighting compile times and increase the size of your BSP. For `0.25` scale diffuse textures, the default `lightmap_scale` is recommended.

saturation
: Controls light saturation, or color influence. This can be used to make a level look more colorful, or more pale. The default value is `1.0`. Values from `0.5` to `3.0` are most useful.

subdivide
: Controls maximum surface size for the bsp stage of the compile. Generally, the default value `1024` is recommended. Lower values may reduce artifacts, while higher values may reduce `r_speeds`.

sun_angles
: Controls sunlight direction, specified as pitch and yaw in degrees, e.g. `-80 220`.

sun_color
: Controls sunlight color, specified as rgb floating point values, e.g. `1.0 0.9 0.8`.

sun_light
: Controls sunlight intensity. Values from `0` to `255` are valid, `40` to `150` typically produce best looking results.