From Valve Developer Community
Jump to: navigation, search

<Counter-Strike: Global Offensive> weapon_breachcharge is a point entity available in Counter-Strike: Global Offensive.

Entity Description

It's one of many new entities added with the Danger Zone update.

The primary attack (+attack) throws a breachcharge_projectile. It sticks to solid brushes, func_physboxes, props and players and plays a unique sound when doing so.
The secondary attack (+attack2) lets all projectiles that have landed emit a beeping sound and detonates them after a fuse time. The bigger the distance between a breachcharge projectile and the triggering player, the longer the delay between triggering and explosion. Projectiles in mid-air will behave as if they will be triggered immediately after landing.

Every projectile can be picked up again with +use by the player with the corresponding breachcharge item, even if already triggered or still in mid-air. If a player has a breachcharge equipped, he can identify the corresponding projectiles in a certain range by a yellow-black skull shown at their positions (also through walls).

Related Console Commands

Command Desecription
ammo_grenade_limit_breachcharge Default value is 3.
Confirm:No effect. Such ConVars usually affect the reserve ammo, but breachcharge doesn't use that (max reserve ammo seems to be 0).
mp_death_drop_breachcharge Whether or not players drop their breachcharge on death. Default value is 1.
sv_breachcharge_arm_delay Default value is 0. To do: Doesn't affect anything?
sv_breachcharge_delay_max Default value is 0.8. To do: Doesn't affect anything?
sv_breachcharge_delay_min Default value is 0. To do: Doesn't affect anything?
sv_breachcharge_distance_max Default value is 1200. To do: Doesn't affect anything?
sv_breachcharge_distance_min Default value is 600. To do: Doesn't affect anything?
sv_breachcharge_fuse_max Default value is 1.0. To do: Doesn't affect anything?
sv_breachcharge_fuse_min Default value is 0.7. To do: Doesn't affect anything?


Is this weapon allowed to be picked up? (CanBePickedUp) <boolean>
Determines if players are able to pick up the weapon.


Name (targetname) <string>
The targetname that other entities refer to this entity by.
Entity Scripts (vscripts) <scriptlist> (in all games since <Left 4 Dead 2>)
Space delimited list of VScript files (without file extension) that are executed after all entities have spawned. The scripts are all executed in the same script scope, later ones overwriting any identical variables and functions.
Script think function (thinkfunction) <string> (in all games since <Left 4 Dead 2>)
Name of a function in this entity's script which will be called automatically every 100 milliseconds (ten times a second) for the duration of the script. It can be used to create timers or to simulate autonomous behavior. The return value (if present) will set the time until the next call.
Note.png Note: Try to avoid expensive operations in this function, as it may cause performance problems.


Pitch Yaw Roll (Y Z X) (angles) <angle>
This entity's orientation in the world. Pitch is rotation around the Y axis, yaw is the rotation around the Z axis, roll is the rotation around the X axis.


  • 1 : Start Constrained
Prevents the model from moving.


SetAmmoAmount <integer>
Sets the (primary) ammo which is usually the number of bullets in the active magazine. Every value behaves like its congruent value in the range 0-255 in modulus 256 (e.g. -255 and 257 behave like 1 etc.). When set to 0, a player holding this weapon will reload automatically, if possible. Other values congruent to 0 (-256, 256, 512, ...) might cause undefined behavior. Values congruent to -1 (mod 256) make the ammo numbers disappear. If set to a value outside the weapon's clip size, reloading might deliver unexpected results.
SetReserveAmmoAmount <integer>
Sets the reserve (secondary) ammo which is usually the number of bullets in reserve for reloading. Values that are greater than the weapon's reserve ammo limit are clamped to it (e.g. 90 for the weapon_ak47). Negative values make the ammo display disappear and reloading is impossible.
ToggleCanBePickedUp <boolean>
Toggles if the weapon can be picked up by players. Visually, nothing changes and there is no event if picking up fails. Hover texts like "[E] Swap for AK-47" remain in both cases.
Hides the viewmodel of this weapon for the player having it deployed until it is deployed again.


skin <integer>
Selects a skin from the model's index, starting with 0.
SetBodyGroup <integer>
Sets the the active $bodygroup.
Makes the entity catch on fire indefinitely.
IgniteLifetime <float>
Makes the entity catch on fire for a given amount of time.
IgniteNumHitboxFires <integer> (removed in <Left 4 Dead 2>)
Makes the entity catch on fire with a given number of hitbox fire particles. Does not function correctly in <Left 4 Dead 2> onward.
IgniteHitboxFireScale <float> (removed in <Left 4 Dead 2>)
Makes the entity catch on fire with a given scale for hitbox fire particles. Does not function correctly in <Left 4 Dead 2> onward.
Kills the entity and creates a client-side ragdoll from the model. Input is only passed if the model contains $collisionjoints, for other models phys_convert can be used instead.
SetLightingOrigin <targetname>
Sets the entity's lighting origin to use this entity's position.
SetLightingOriginHack <targetname> (removed in <Left 4 Dead>) <Obsolete>
Deprecated. Offsets the entity's lighting origin by their distance from an info_lighting_relative. Use SetLightingOrigin instead.
fademindist <float>
Sets distance at which the entity starts fading. If <0, the entity will disappear instantly when end fade is hit. The value will scale appropriately if the entity is in a 3D Skybox.
fademaxdist <float>
Sets distance at which the entity ends fading. If <0, the entity won't disappear at all. The value will scale appropriately if the entity is in a 3D Skybox.
SetModelScale <vector> (only in <Source><Source>)
Multiplies the size of the model. Does not alter the physics collisions in most cases. Can take two values separated by a space, in which case the first value would be the target model scale and the second value would be the number of seconds the change in scale will be spread over. If there is no second value, the model will scale instantly.
Tip.png Tip: The modelscale keyvalue can be AddOutputed as a workaround for other games with this input missing.
Warning.png Warning: Negative or extremely high values can cause crashes!
Alpha <integer>
Sets the entity's transparency to a number from 0 (invisible) to 255 (fully visible). Requires the entity to have its Render Mode (rendermode) set to a number other than 0.
AlternativeSorting <boolean>
Swaps the rendering order of the entity. Used to attempt to fix sorting problems when rendering, for example an object rendering in front of translucent materials.
Color <color255>
Sets an RGB color for the entity.
SetDamageFilter <targetname>
Sets a filter for this entity for when it receives damage.
Allows the entity to be pushed by damage done to it (usually force amount correlates with the damage done).
Prevents the entity from being pushed by damage done to it.
Allows the entity to draw a render target shadow.
Prevents the entity from drawing a render target shadow.


Removes this entity from the world.
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.



Fires when a player +uses this weapon but does not pick it up, e.g. during the pickup cooldown immediately after dropping it or if CanBePickedUp is false (activator is the player).
Fires when a player picks this weapon up (activator is the player).
OnCacheInteraction  !FGD
Fires when a player picks this weapon up (activator is the player). Also fires rapidly when a player touches the weapon but automatic pickup fails, e.g. if he already has a weapon in that slot. Does not fire if CanBePickedUp is false.
OnNPCPickup  !FGD
Fires when an NPC picks up this weapon (activator is the NPC). However, bots in <Counter-Strike: Global Offensive> are considered players, so this output has no functionality.


Fired when the entity catches fire, such as from an env_entity_igniter or the Ignite inputs.


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.