View source for Func bomb target

[[File:Func_bomb_target_de_dust2_css.jpg|thumb|right|384px|{{css}} The use of func_bomb_target on ''de_dust2''.]]
{{CD|CBombTarget|file1=cstrike/func_bomb_target.cpp|file2=cstrike15/func_bomb_target.cpp|base=CBaseTrigger}}
{{subpage|[[Creating a Bomb Defusal Map]]}}
{{this is a|brush entity|name=func_bomb_target|series=Counter-Strike}}
It is the area inside which players can plant the bomb.
The existence of this entity makes a map a [[Bomb Defusal]] scenario.
{{Tip|This entity enherits functionalities from CBaseTrigger that are {{not in FGD}} but they can be used, such as the <code>StartDisabled</code> keyvalue and the <code>Enable/Disable/Toggle</code> inputs. To use this entity's inherited trigger I/O (<code>OnStartTouch</code>, ...), set its <code>spawnflags</code> keyvalue appropriately (default is 4097). To add all of this in [[Hammer]], see [[#FGD Code|below]].}}
{{preservedEnt|func_bomb_target}}

==Entity Description==

[[Player]]s can plant a [[weapon_c4|bomb]] if they touch this entity.
:{{csgo}} But at most once: Doing so "consumes" a <tt>func_bomb_target</tt>, meaning that it allows no more planting inside it. The input <tt>BombPlanted</tt> consumes it, too.

The outputs <tt>BombPlanted</tt>, <tt>BombDefused</tt> and/or <tt>BombExplode</tt> are fired either in conjunction with a C4 entity that was planted inside it, or in response to the inputs of the same name.
:{{csgo}} When planting outside any <tt>func_bomb_target</tt> with {{ent|mp_plant_c4_anywhere|1}}, there is still a <tt>func_bomb_target</tt> chosen that is consumed and that fires outputs, even if all existing <tt>func_bomb_target</tt>s are already consumed.
{{Bug|The <tt>BombDefused</tt> output is '''not''' fired when a bomb is defused.}}

[[Bot]]s read the bomb plant locations from the [[Nav Mesh]] and not from the actual position of <tt>func_bomb_target</tt>s in the world. Since this information is set in the analysis phase of the nav mesh generation, there is no way that bots recognize the position of a <tt>func_bomb_target</tt> if it has moved. <sup>[https://www.youtube.com/watch?v&#61;urlvnXlRmoI&t&#61;94s video]</sup>.

=== Bombsite A and B ===
Generally, the game assigns the label '''A''' to the <tt>func_bomb_target</tt> with the lowest [[entity index]] and '''B''' to the highest. This, however, is overridden if the closest [[Nav Mesh|nav area]] to a <tt>func_bomb_target</tt> has a [[Nav_Mesh_Editing#Place_names_.28callouts.29|place name]]: If that place name is one of <tt>Bombsite</tt> or <tt>BombsiteA</tt>, it will be '''A'''; Any other place name yields '''B'''.<sup>[https://github.com/perilouswithadollarsign/cstrike15_src/blob/f82112a2388b841d72cb62ca48ab1846dfcc11c8/game/server/cstrike15/cs_player_resource.cpp#L316-L339 code]</sup>

Therefore, the mapper can set the labelling either by adding appropriate place names to crucial areas in-game, or &ndash; if no place names interfere! &ndash; by ordering their entity IDs in the [[VMF]] (and thus the entity index in-game) using Hammer: Move all <tt>func_bomb_target</tt>s to the world using {{key|Ctrl|shift|W}} and then tie them to an entity with {{key|Ctrl|T}} in the desired order.

When a map loads, the game creates at most one <tt>info_bomb_target_hint_A</tt> and at most one <tt>info_bomb_target_hint_B</tt> entity near the center of the corresponding <tt>func_bomb_target</tt>, if any. These [[s_PreserveEnts|preserved]] entities are used for the radar. It can happen that a label is missing, which is when two bombsites would get the same label due to inappropriate place names. There ''will'' be at most two labels and it can only be '''A''' or '''B''' even though there is the place name {{code|BombsiteC}} and radio voicelines naming "bombsite C". Still, any number of bombsites should work technically but there may be minor bugs such as missing text since the game is programmed to assume that there are at most two.

==Keyvalues==
{{KV Targetname}}
{{KV|Heist Mode bomb Target|bool|intn=heistbomb|Marks the bomb target as designated for the heist game mode. {{Note|Support for heist mode was never fully implemented, so this KV should usually be set to false.}}
}}
{{KV|Bomb Mount Target|targetname|intn=bomb_mount_target|Optionally, have the bomb be forced to a specific position and orientation after being planted. The position and angles are determined by the ones of a specified {{ent|info_target}}. {{Bug | In [[Hammer]], this value's type is a string by default. See [[#FGD Code|below]] for a fix.}} }}
{{KV BaseTrigger}}

==Inputs==
{{IO|BombExplode|nofgd=1|Fires the <code>BombExplode</code> output.}}
{{IO|BombDefused|nofgd=1|Fires the <code>BombDefused</code> output.}}
{{IO|BombPlanted|nofgd=1|Fires the <code>BombPlanted</code> output and removes this entity's volume from the planting zones until next round.}}
{{I BaseTrigger|notf2=1}}

==Outputs==
{{IO|BombExplode|Fires when the bomb explodes or if the <code>BombExplode</code> input is received.}}
{{IO|BombDefused|Fires when the bomb is defused or if the <code>BombDefused</code> input is received. {{Bug | Is not fired by normal gameplay, only with the '''<code>BombDefused</code>''' input.}} }}
{{IO|BombPlanted|Fires when the bomb is planted or if the <code>BombPlanted</code> input is received.}}
{{O BaseTrigger}}

==[[FGD]] Code==
Replace the corresponding lines of {{ent|cstrike.fgd}} or {{ent|csgo.fgd}} near <code>func_bomb_target</code> with this.
This code
* replaces its base classes with <code>Trigger</code> which effectively adds trigger properties such as the keyvalue <code>StartDisabled</code>, the inputs <code>Enable/Disable/Toggle/OnStartTouch/...</code> and the [[Trigger_once#Flags|trigger flags]] (1: Clients, ...).
* adds the input <code>TouchTest</code> and the outputs <code>OnTouching/OnNotTouching</code> as seen in <code>trigger_multiple</code> of [[base.fgd]].
* adds the inputs <code>BombExplode/BombDefused/BombPlanted</code> with the above description.
* corrects the type of <code>bomb_mount_target</code> from <code>string</code> to <code>target_destination</code>.
{{pre|
@SolidClass base(Trigger) {{=}} func_bomb_target:  
	"Bomb Target. The terrorists can place C4 explosives while standing in this zone.\n\n" +
	"When the bomb is planted and explodes inside this area, the BombExplode outputs are fired. The game handles " +
	"all of the bomb planting and scoring logic – the BombExplode outputs are provided to add visual and damage effects."
[
	input TouchTest(void) : "Tests if the trigger is being touched and fires an output based on whether the value is true or false." 
	input BombExplode(void): "Fires the BombExplode output"
	input BombPlanted(void): "Fires the BombPlanted output and removes this entity's volume from the planting zones until next round"
	input BombDefused(void): "Fires the BombDefused output"
	
	output OnTouching(void) : "Fired when the TestTouch input is true (something is touching the trigger.)"
	output OnNotTouching(void) : "Fired when the TestTouch input is not true (nothing is touching the trigger.)"
	output BombExplode(void): "Fires when C4 explodes or if the BombExplode input is received"
	output BombPlanted(void): "Fires when a C4 is planted or if the BombPlanted input is received"
	output BombDefused(void): "Fires when a C4 is defused or if the BombDefused input is received; Bug: Is not fired by normal gameplay, only with the BombDefused input."

	heistbomb(boolean) : "Heist Mode bomb target" : 0 : "This is a Bomb Target designed for the Heist game mode."

	bomb_mount_target(target_destination) : "Bomb Mount Target" 
]
}}