Env global

This entity is also available as [[{{{1}}}|{{{1}}}]] for the Half-Life Engine.

Template:Base point It controls game-specific global states, such as whether the gravity gun should become the super gravity gun in HL2.

Global states persist across level transitions, regardless of their status. Use the dump_globals console command to list all stored global states.

Note:Global states are not stored until an env_global receives any commands that modify the state, such as turning it on or off or changing the counter. Use the Set Initial State flag for the global to be added on spawn.

To remove a global from the table entirely, set its state to "Dead" using the Remove input. It will remove itself on the next level transition. ^[confirm]

Globals and their current state (in integer form) are added to all entites' response data for use in the Response System.

Keyvalues

Global State to Set ([todo internal name (i)]) <choices>

Game-specific global state that this entity sets. In practice all of Valve's FGDs include the HL2 states regardless of whether the game understands them.

• Gordon pre-criminal
• Antlions are player allies
• Suit sprint function not yet enabled
• Super phys gun is enabled
  Note:Doesn't work in HL2:DM.

• Friendly encounter sequence (lower weapons, etc.)
• Gordon is invulnerable
• Don't spawn seagulls on the jeep
• Episode 2: Alyx injured
• Episodic: Alyx darkness mode
• Ep2 Counter: Hunters to run over before they dodge

Tip:Global states are not exclusive to these choices, and may be any text.

EnvGlobal:

Initial State ([todo internal name (i)]) <choices>

Used by Set Initial State to determine what the global state should be set to when the map starts.

• Off
• On
• Dead

Counter ([todo internal name (i)]) <integer> (in all games since )

An integer counter value associated with this global.

Bug:There is an aliasing problem for this keyvalue. To make it work, simply change its name in the source code DEFINE_OUTPUT declaration.  [todo tested in ?]

Name (targetname) <string>[ Edit ]

The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.

See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Flags

• Set Initial State: Whether this entity defines the global state when the map starts.

Inputs

EnvGlobal:

TurnOn / TurnOff

Sets the global's state.

Toggle

Toggles state of global between ON and OFF.

Remove

Set state of global to DEAD.

AddToCounter <integerRedirectInput/integer> (in all games since )

Adds the specified amount to the counter.

SetCounter <integerRedirectInput/integer> (in all games since )

Sets the value of the counter.

GetCounter  (in all games since )

Fires this entity's Counter output.

Outputs

EnvGlobal:

counter <integerRedirectInput/integer> (in all games since )

Outputs the integer value of this entity. May depend on global state.