Logic script

Class hierarchy
CLogicScript ↳CPointEntity ↳CBaseEntity

logic_script is a point entity available in all Source games since Left 4 Dead 2. It is also available in Team Fortress 2 and Mapbase and it is the container for VScripts. In Left 4 Dead 2, for example, this entity is used extensively for the logic in "carnival games" found in the Dark Carnival campaign, such as Peanut Gallery, Strongman Contest, Whack-a-Stach, etc.

KeyValues

start ([todo internal name (i)])

Group00 ([todo internal name (i)]) <targetname>

EntityGroup[0]

vscripts ([todo internal name (i)]) <scriptlist> (in all games since )

Entity Scripts

thinkfunction ([todo internal name (i)]) <string> (in all games since )

Think function

end ([todo internal name (i)])

Inputs

RunScriptFile <scriptRedirectInput/string> (in all games since ) (also in )

Execute a VScript file from disk, without file extension. The script contents are merged with the script scope of the receiving entity.

RunScriptCode <stringRedirectInput/string> (in all games since ) (also in )

Execute a string of VScript source code in the scope of the entity receiving the input. String quotation may be needed when fired via console.

Bug:In Hammer, using string arguments will corrupt the VMF file's structure, making the file unviewable for the next Hammer session.

Fix:Remove the string argument manually with a text editor.

  [todo tested in ?]

Note: Backtick characters ` are replaced with quotation marks at runtime, allowing quotation marks to be used when normally not possible.

CallScriptFunction <stringRedirectInput/string> (in all games since ) (also in ) !FGD

Calls a VScript function defined in the scope of the receiving entity.

TerminateScriptScope  (only in ) !FGD

Destroys the script scope of the receving entity.

See also

• L4D2 Vscripts
• Left 4 Dead 2 Tool Updates
• trigger_finale

External links

• It's the vscript'ing documentation FAQ! (Steam Forums)
• Scripting for Left 4 Dead 2 (Leeland.net) - Example uses of logic_script