logic_script
Jump to navigation
Jump to search
 Class hierarchy
|
|---|
| CLogicScript |
| logicentities.cpp
|
logic_script is a logical entity available in all 
Source games since 
Left 4 Dead 2. It is also available in the 
Team Fortress 2 branch and 
Mapbase.
This entity functions as a container for VScripts. In Left 4 Dead 2, for example, it 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.
Note:This entity counts as an edict, not a logical entity as one would expect.键值
- Name (targetname) <string>[ Edit ]
- The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g.
parentnameortarget).
Also displayed in Hammer's 2D views and Entity Report.See also: Generic Keyvalues, Inputs and Outputs available to all entities
- EntityGroup[0] (Group00) to EntityGroup[15] (Group15) <targetname>
- 指定实体的目标名称（Targetnames），使其在Squirrel代码中可访问。该实体生成时，将搜索所有指定的实体名称，并将它们的脚本句柄添加到此
logic_script的脚本作用域中： EntityGroup：一个数组，其中EntityGroup[0]是名为EntityGroup[0]键值所指定实体的句柄，以此类推。如果存在多个同名实体，则使用找到的第一个句柄。数组长度为最高非空EntityGroup索引加一，因此在Squirrel代码中，若长度不确定，请勿硬编码索引。若键值EntityGroup[i]为空字符串（i < EntityGroup.len()），则EntityGroup[i]为null。MyEntityGroup(not in
)：一个表（table），其中键为名称，值为句柄。例如，若EntityGroup[2]键值设为sound.start，则MyEntityGroup["sound.start"] == EntityGroup[2]。MyEntityGroupArray(not in)：一个与EntityGroup相同的数组。
内部运行的VScript实现此功能 以下VScript在
logic_script生成时在其作用域中运行，随后以Group00-Group15键值指定的每个名称调用__AppendToScriptGroup。EntityGroup <- []; MyEntityGroup <- {}; MyEntityGroupArray <- EntityGroup; function __AppendToScriptGroup( name ) { if ( name.len() == 0 ) { EntityGroup.append( null ); } else { local ent = Entities.FindByName( null, name ); EntityGroup.append( ent ); if ( ent != null ) { ent.ValidateScriptScope(); MyEntityGroup[name] <- ent; ent.GetScriptScope().EntityGroup <- EntityGroup; } } }
Note:For other VScript keyvalues notable for this entity like vscripts, thinkfunction and inputs like RunScriptCode, CallScriptFunction see Generic Keyvalues, Inputs and Outputs See also
External links
- It's the VScripting documentation FAQ! (Steam Forums)
- Scripting for Left 4 Dead 2 (Leeland.net) - Example uses of logic_script