env_player_blocker

From Valve Developer Community
Jump to: navigation, search

Left 4 Dead Left 4 Dead 2 env_player_blocker is a point entity available in the Left 4 Dead series. It blocks any PC/NPC from entering of the specified type.
Examples of its use can be found in L4D1 Authoring Tools SDK content, such as the l4d_airport03_garage.vmf crescendo event.
It has also been used a lot in L4D2's _Commentary files in the maps folder. Those have been used to block areas where survivors could remain unharmed by infected. Or in the case of C4M2_Sugarmill_a, where Survivors are blocked from jumping onto a set of pipes to gain higher ground prematurely.

This entity is a very useful option for clips that must be toggled on and off during gameplay.

Keyvalues

Mins (boxmins) <vector>
Maxs (boxmaxs) <vector>

An outlined box is displayed in Hammer when Mins/Maxs are specified.

Initial State (initialstate) <choices>
Initial state of the blocker
  • 0 : Disabled
  • 1 : Enabled
Blocks (BlockType) <choices>
What should be blocked
  • 0 : Everyone
  • 1 : Survivors
  • 2 : Player Infected
  • 3 : All Special Infected (Player and AI)

Targetname:
Name (targetname) <string>
The targetname that other entities refer to this entity by.

Inputs

Enable
Enables the Blocker
Disable
Disables the Blocker

Targetname:
Kill
Removes this entity from the world.
KillHierarchy
Removes this entity and its children from the world.
Note.png Note: Entities already remove orphaned children upon being removed, but this input removes all children on the same frame, being marginally faster than Kill.
AddOutput <string>
Adds a keyvalue/output to this entity. It can be potentially very dangerous, use with care.
KV Format: <key> <value>
I/O Format: <output name> <targetname>:<inputname>:<parameter>:<delay>:<max times to fire, -1 means infinite>
FireUser1 to FireUser4
Fire the OnUser outputs; see User Inputs and Outputs.
Use  !FGD
Same as a player invoking +use; may not do anything depending on the entity. Can also be invoked by firing an output that does not specify an input.
RunScriptFile <script> (in all games since Left 4 Dead 2)
Execute a VScript file from disk, without file extension. The script contents are merged with the script scope of the receiving entity.
RunScriptCode <string> (in all games since Left 4 Dead 2)
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.png Bug: In Left 4 Dead 2, the code is executed in the script scope of the entity that fires the output, not the one receiving the input.
Warning.png Warning: Never try to pass string parameters to a script function with this input. It will corrupt the VMF structure because of the nested quotation marks, which then must be removed manually with a text editor.
CallScriptFunction <string> (in all games since Left 4 Dead 2) !FGD
Execute a VScript function in the scope of the receiving entity.
SetLocalOrigin <coordinates> (in all games since Alien Swarm) !FGD
Send this entity to a spot in the map. If the entity is parented to something, it will be offset from the parent by this amount.
SetLocalAngles <angles> (in all games since Alien Swarm) !FGD
Set this entity's angles.

Outputs


Targetname:
OnUser1 to OnUser4
These outputs each fire in response to the firing of the like-numbered FireUser1 to FireUser4 Input; see User Inputs and Outputs.
OnKilled  (only in Left 4 Dead Left 4 Dead 2)
This output fires when the entity is killed and removed from the game.