Func nav blocker: Difference between revisions

Latest revision as of 11:16, 4 April 2025

This entity is not in the

FGD by default.
See below for instructions on making it available.

Class hierarchy
CFuncNavBlocker ↳CBaseEntity
`nav_entities.cpp`

func_nav_blocker is a brush entity available in all Source games since Left 4 Dead. It is also in Half-Life 2: Deathmatch, Counter-Strike: Source, Team Fortress 2, and Black Mesa. It blocks nav areas touching its AABB to restrict NPCs / Bots from crossing over it.

Note:In

doesn't block nav areas automatically on spawn.

Warning:This entity applies its effect based on its AABB instead of its brush model. [ Edit ]

Keyvalues

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

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 ) !FGD: If set to false nav areas will be blocked right after spawning.

Inputs

BlockNav: Starts blocking nav areas.

UnblockNav: Stops blocking nav areas.

Kill: Will unblock nav areas before killing the nav blocker

FGD Code

Half-Life 2: Deathmatch

@SolidClass base(Targetname) = func_nav_blocker : "A brush entity that can block nav areas touching its AABB." 
[
	input BlockNav(void) : "Starts blocking nav areas."
	input UnblockNav(void) : "Stops blocking nav areas."

	teamToBlock(choices) : "Team(s) to block" : -1 : "Block the nav for bots on this team" =
	[
		-1 : "Everyone"
		2 : "Combine"
		3 : "Rebels"
	]
	
]

Counter-Strike: Source

@SolidClass base(Targetname) = func_nav_blocker : "A brush entity that can block nav areas touching its AABB." 
[
	input BlockNav(void) : "Starts blocking nav areas."
	input UnblockNav(void) : "Stops blocking nav areas."

	teamToBlock(choices) : "Team(s) to block" : -1 : "Block the nav for bots on this team" =
	[
		-1 : "Everyone"
		2 : "Terrorists"
		3 : "Counter-terrorists"
	]
	
]

@@ Line 1: / Line 1: @@
-{{brush ent|since=Left 4 Dead}} and also in {{tf2}}. It blocks [[Navigation Meshes|nav areas]] touching its [[Bounding volume|AABB]] to restrict NPCs / Bots from crossing over it.
+{{LanguageBar}}{{ent not in fgd}}
-{{bug|In {{l4d2}}, If{{ent|prop_door_rotating}}or{{ent|func_physbox}}resides on the same areas, send an<code>UnblockNav</code>input along a<code>BlockNav</code>input. Else the console reports "Area navsquare#[ID] already blocked by a different team ID.{{confirm}}}}
+{{CD|CFuncNavBlocker|file1=nav_entities.cpp}}
-{{note|The entity won't block nav areas automatically on spawn (except in {{csgo}}). It is best practice to have either<code>BlockNav</code>or<code>UnblockNav</code>inputs sent with<code>[[logic auto|OnMultiNewRound]]</code>.}}
+[[File:Toolstrigger.gif|left]]
-{{note|This entity blocks navigation areas using its [[bounding box]]! Complex brush models will not work.}}
+{{this is a|brush entity|name=func_nav_blocker|since=Left 4 Dead}} It is also in {{hl2dm|4}}, {{css|4}}, {{tf2|4}}, and {{bms|4}}. It blocks [[Navigation Meshes|nav areas]] touching its [[Bounding volume|AABB]] to restrict NPCs / Bots from crossing over it.
+{{note|In {{l4ds}} doesn't block nav areas automatically on spawn.}}
+{{AABBwarning}}
+__NOTOC__
 == Keyvalues ==
+{{KV Targetname}}
 {{KV NavBlocker}}
-{{KV BaseEntity|brush=1}}
+{{KV|Start Disabled|not={{l4ds}}|intn=StartDisabled|bool|If set to false nav areas will be blocked right after spawning.|nofgd=1}}
-{{KV EnableDisable|navblock=1}}
 == Inputs ==
 {{I NavBlocker}}
-{{I BaseEntity}}
+{{I|Kill|Will unblock nav areas before [[kill]]ing the nav blocker}}
-{{I EnableDisable}}
-== Outputs ==
+== FGD Code ==
-{{O BaseEntity|l4d=1}}
-== See Also ==
+{{expand|title={{hl2dm|2}}|1=<source lang=cpp>
-* {{l4d2}} [[script_nav_blocker]] - VScript catered version of func_nav_blocker.
+@SolidClass base(Targetname) = func_nav_blocker : "A brush entity that can block nav areas touching its AABB."
+[
+	input BlockNav(void) : "Starts blocking nav areas."
+	input UnblockNav(void) : "Stops blocking nav areas."
+	teamToBlock(choices) : "Team(s) to block" : -1 : "Block the nav for bots on this team" =
+	[
+		-1 : "Everyone"
+: "Combine"
+: "Rebels"
+	]
+]</source>}}
+{{expand|title={{css|2}}|1=<source lang=cpp>
+@SolidClass base(Targetname) = func_nav_blocker : "A brush entity that can block nav areas touching its AABB."
+[
+	input BlockNav(void) : "Starts blocking nav areas."
+	input UnblockNav(void) : "Stops blocking nav areas."
+	teamToBlock(choices) : "Team(s) to block" : -1 : "Block the nav for bots on this team" =
+	[
+		-1 : "Everyone"
+: "Terrorists"
+: "Counter-terrorists"
+	]
+]</source>}}
+== See also ==
+* {{l4d2}} {{ent|script_nav_blocker}} - VScript catered version of func_nav_blocker.

Func nav blocker: Difference between revisions

Latest revision as of 11:16, 4 April 2025

Keyvalues

Inputs

FGD Code

See also

Navigation menu

Search