func_nav_blocker

Class hierarchy
CFuncNavBlocker ↳CBaseEntity
nav_entities.cpp

func_nav_blocker is an e2 available in all Source games since Left 4 Dead. and also in . It blocks nav areas touching its AABB to restrict NPCs / Bots from crossing over it.

Bug:In , Ifprop_door_rotating, func_physbox, func_door, etc resides on the same areas, send anUnblockNavinput along aBlockNavinput. Else the console reports "Area navsquare#[ID] already blocked by a different team ID." Confirm edit: Bug is real, however fix appears to be ineffective  [todo tested in ?]

Bug:In , this entity appears to be broken^[1], however the other func_nav_* entities appear to work in MvM at the very least.  [todo tested in ?]

Note:The entity won't block nav areas automatically on spawn (except in ). It is best practice to have eitherBlockNavorUnblockNavinputs sent withOnMapSpawn.

Warning:Entity's AABB is used for blocking nav areas, so clipping or rotating brushes does not change a brush's size as one expects.

Diagonal walls will always be ignored, as it will take the furthest out corners of the diagonal walls and create one huge box around all of it. That box will be your brush entity.

If you need a large diagonal brush, you must create multiple small square entities aligned diagonally.

Keyvalues

Team(s) to block (teamToBlock) <choices>

Team this entity should block.

• -1 : Everyone
  Warning: for everyone either edit FGD and use value -2 or turn off smart edit and set that, -1 is not valid and the nav blocker will not work
• 2 : Red , Survivors , Terrorists
• 3 : Blue , Infected , Counter-Terrorists

Note: teamToBlock non-functional, always blocks either for both teams or for no team.

Affects Flow? (affectsFlow) <boolean> (only in )

Does this Nav Blocker block flow in the level? Only Nav Blocker with this enabled will cause flow recomputation on blocking/unblocking.

Important:When this is true don't block the only path to the level's goal with it or the flow won't be computed properly

Start Disabled (StartDisabled) <boolean> (not in )

If set to false nav areas will be blocked right after spawning.

Inputs

BlockNav

Starts blocking nav areas.

UnblockNav

Stops blocking nav areas.

See also

• script_nav_blocker - VScript catered version of func_nav_blocker.

References

1. https://github.com/ValveSoftware/Source-1-Games/issues/5269