worldspawn Last edited 3 months ago2024-08-31 13:49:07 UTC

worldspawn - Brush Entity

A special entity that controls several global properties. Every map has exactly one and only one worldspawn. Its properties is accessed in Hammer under "Map > Map Properties". Note that different games/mods may read different sets of values from worldspawn and their entity guides or FGD docs should be consulted.

Attributes

• Map Description/Title (message) - Used to show the map's title/description in the old WON interface.
• Environment Map (skyname) - Name of the skybox for the map. See also: list of default Half-Life skies.
• CD track to play (sounds) - 0 or 1 = None. CD track to play when the level begins. See also: trigger_cdaudio and target_cdaudio.
• Default light level (light)
• Default Wave Height (WaveHeight) - Set the default wave height here (can be overridden by the properties in func_water).
• Max viewable distance (MaxRange) - Maximum distance the player can see in Hammer grid units; same as sv_zmax. This is measured from one end of a cube to the other with the player in the center, so from the player's POV the effective value is halved. Double the value for desired max distance from player's POV.
• Chapter title message (chaptertitle) - Text displayed when entering the level. See also: game_text and env_message.
• Level Fade-in (startdark) - 0 = No, 1 = Yes. If Yes, then the level will start black and fade into normal light. See also: env_fade.
  • Not available in Deathmatch Classic.
• Display game title (gametitle) - 0 = No, 1 = Yes. If Yes, then "Half-Life" will be displayed after the map loads.
• New Level Unit (newunit) - 0 = No, 1 = Yes. If Yes, all previous global state variables will be removed. See also: env_global.
• Map team List (mapteams) - This will be copied into the mp_teamlist while your map is running if the server allows maps to override the team list.
• Default Team (defaultteam) - 0 = Fewest Players, 1 = First Team (team index 0). See also: game_player_team, game_team_set and game_team_master.

Ricochet-only properties:

• Players per Team (playersperteam) - Number of players per team in Arena mode.
• No Arena (no_arena) - If enabled, this map is not an Arena map.

Notes

• Every world brush (that is not a brush entity) is part of worldspawn.
• chaptertitle is only shown in single-player maps.
• The exported .map (and the compiled .bsp) stores the list of wads the map needs in the wad property of worldspawn.
• Ricochet: If the "players per team" value is less than one, the value of the rc_playersperteam console variable (CVAR) is used instead.