This article's documentation is for anything that uses the Source engine. Click here for more information.

Func nav blocker: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
 
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{lang|title=func_nav_blocker}}
{{LanguageBar}}{{ent not in fgd}}
{{CD|CFuncNavBlocker|file1=nav_entities.cpp}}
{{CD|CFuncNavBlocker|file1=nav_entities.cpp}}
[[File:Toolstrigger.gif|left]]
[[File:Toolstrigger.gif|left]]
{{entity|func_nav_blocker|type=e2|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.
{{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.
{{ModernBug|In {{l4d2}}, If{{ent|prop_door_rotating}}, {{ent|func_physbox}}, {{ent|func_door}}, etc 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 edit: Bug is real, however fix appears to be ineffective}}
{{note|In {{l4ds}} doesn't block nav areas automatically on spawn.}}
{{ModernBug|In {{tf2}}, this entity appears to be broken{{ref|1}}, however the other <code>func_nav_*</code> entities appear to work in MvM at the very least.}}
{{AABBwarning}}
{{ModernNote|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|OnMapSpawn]]</code>.}}
__NOTOC__
{{ModernWarning|Entity's [[AABB]] is used for blocking nav areas, so clipping or rotating brushes does not change a brush's size as one expects.<br>
 
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.<br>
If you need a large diagonal brush, you must create multiple small square entities aligned diagonally.}}
== Keyvalues ==
== Keyvalues ==
{{KV Targetname}}
{{KV NavBlocker}}
{{KV NavBlocker}}
{{KV|Start Disabled|not={{l4ds}}|intn=StartDisabled|bool|If set to false nav areas will be blocked right after spawning.}}
{{KV|Start Disabled|not={{l4ds}}|intn=StartDisabled|bool|If set to false nav areas will be blocked right after spawning.|nofgd=1}}


== Inputs ==
== Inputs ==
{{I NavBlocker}}
{{I NavBlocker}}
{{I|Kill|Will unblock nav areas before [[kill]]ing the nav blocker}}
== FGD Code ==
{{expand|title={{hl2dm|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"
2 : "Combine"
3 : "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."


== See Also ==
teamToBlock(choices) : "Team(s) to block" : -1 : "Block the nav for bots on this team" =
* {{l4d2}} [[script_nav_blocker]] - VScript catered version of func_nav_blocker.
[
-1 : "Everyone"
2 : "Terrorists"
3 : "Counter-terrorists"
]
]</source>}}


== References ==
== See also ==
# https://github.com/ValveSoftware/Source-1-Games/issues/5269
* {{l4d2}} {{ent|script_nav_blocker}} - VScript catered version of func_nav_blocker.

Latest revision as of 10:16, 4 April 2025

English (en)中文 (zh)Translate (Translate)
Icon-NotInFGD.png
This entity is not in the Counter-Strike: SourceHalf-Life 2: DeathmatchAlien SwarmPortal 2 FGD by default.
See below for instructions on making it available.
C++ Class hierarchy
CFuncNavBlocker
↳CBaseEntity
C++ nav_entities.cpp
Toolstrigger.gif

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

Note.pngNote:In Left 4 Dead seriesLeft 4 Dead series doesn't block nav areas automatically on spawn.
Warning.pngWarning: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.pngWarning:Team Fortress 2 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 Team Fortress 2, Survivors Left 4 Dead seriesLeft 4 Dead series, Terrorists Counter-Strike: Source Counter-Strike: Global Offensive
  • 3 : Blue Team Fortress 2, Infected Left 4 Dead seriesLeft 4 Dead series, Counter-Terrorists Counter-Strike: Source Counter-Strike: Global Offensive
Note.pngNote:Counter-Strike: Global Offensive teamToBlock non-functional, always blocks either for both teams or for no team.
Affects Flow? (affectsFlow) <boolean> (only in Left 4 Dead 2)
Does this Nav Blocker block flow in the level? Only Nav Blocker with this enabled will cause flow recomputation on blocking/unblocking.
Icon-Important.pngImportant: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 Left 4 Dead seriesLeft 4 Dead series) !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 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 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"
	]
	
]

See also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Func_nav_blocker&oldid=469558"