func_tank

From Valve Developer Community

Contents 1 Entity Description 2 Availability 3 Keyvalues 4 Flags 5 Inputs 6 Outputs

Entity Description

A brush entity that functions as a gun turret.

Availability

This brush-based entity is available in: HL2. In code it is represented by class CFuncTank, defined in hl2_dll\func_tank.cpp.

Keyvalues

• Targetname:

• Parentname:

• Origin:

• Angles:

• RenderFields:

• Global:

• Shadow:

• control_volume

<target_destination> Name of a trigger the specifies the volume in which a player must be to control this tank.

• master

<target_destination> (Team) Master.

• yawrange

<float> Yaw range.

• yawtolerance

<float> Yaw tolerance.

• pitchrate

<float> Pitch rate.

• pitchrange

<float> Pitch range.

• pitchtolerance

<float> Pitch tolerance.

• barrel

<float> Barrel Length.

• barrely

<float> Barrel Horizontal.

• barrelz

<float> Barrel Vertical.

• spritesmoke

<sprite> Smoke Sprite.

• spriteflash

<sprite> Flash Sprite.

• spritescale

<float> Sprite scale.

• rotatestartsound

<sound> Rotate Start Sound.

• rotatesound

<sound> Rotate Loop Sound.

• rotatestopsound

<sound> Rotate Stop Sound.

• firerate

<float> Rate of Fire. Number of bullets fired before the tank pauses.

• bullet_damage

<integer> If set to 0, it'll use the base weapon bullet's damage.

• bullet_damage_vs_player

<integer> If set to 0, it'll use the Damage Per Bullet value.

• persistence

<float> (Seconds) How long to keep firing at last known position after lose sight of target.

• persistence2

<float> (Seconds) After lost enemy and persistence time has passed, how long to occasionally fire at enemy's last known position.

• firespread

<choices> Bullet accuracy.

Literal value	Description
0	Perfect Shot
1	Small cone
2	Medium cone
3	Large cone
4	Extra-large cone

• minRange

<float> Minmum target range.

• maxRange

<float> Maximum target range.

• _minlight

<integer> Minimum light level.

• gun_barrel_attach

<string> If Parent is specified, this is the attachment point on the parent to fire from. If you specify this, you'll want to specify the Gun Base Attachment too.

• gun_yaw_pose_param

<string> If Parent + the Gun Pitch Pose Param is specified, then the gun itself will be invisible and the func_tank will steer a gun on the parent using the pose parameters.

• gun_yaw_pose_center

<float> The center yaw pose parameter of the gun on the parent.

• gun_pitch_pose_param

<string> If Parent + the Gun Yaw Pose Param is specified, then the gun itself will be invisible and the func_tank will steer a gun on the parent using the pose parameters.

• gun_pitch_pose_center

<float> The center pitch pose parameter of the gun on the parent.

• ammo_count

<integer> Only applies to player use. -1 = unlimited ammo.

• LeadTarget

<choices> Lead Target.

Literal value	Description
0	No
1	Yes

• npc_man_point

<target_destination> Point where NPC must stand to man this func_tank.

• playergraceperiod

<float> If specified, NPC's manning this func tank won't fire at the player, after firing at a non-player, for this amount of time.

• ignoregraceupto

<float> The player grace period is ignored if the player's under this distance from the func_tank.

• playerlocktimebeforefire

<float> The tank must have the player as a target for this amount of time before it's allowed to fire.

• effecthandling

<choices> Effect Handling.

Literal value	Description
0	Use Individual Settings.
1	AR2
2	Combine Cannon

• bullet

<choices> Bullets. Obsolete. If you are mapping for HL2, and don't see this keyvalue, it's probably because you updated hammer for Episode 1. Simply add it in manually without SmartEdit. This keyvalue must be used with HL2.

Literal value	Description
0	None
1	Pistol
2	SMG1
3	AR2
4	Laser

• ammotype

<choices> Ammo type. Cannot be used with HL2 (see above).

Literal Value	Description
	None
Pistol	Pistol
SMG1	SMG1
AR2	AR2
CombineHeavyCannon	Combine Heavy Cannon

Flags

• 1 : Active
• 16 : Only Direct
• 32 : Controllable
• 64 : Damage Kick
• 1024 : NPC Controllable
• 2048 : NPC Set Controller
• 4096 : Allow friendlies to hit player
• 32768 : Non-solid.
• 131072 : Cheat when shooting player

Every third shot is direct hit

• 8192 : Ignore range when making viewcone checks
• 256 : Aiming Assistance (Player Only)

Inputs

• Targetname:

• Parentname:

• Shadow:

• Activate

Turn the tank on

• Deactivate

Turn the tank off (go dormant)

• SetFireRate <string>

How fast to fire (0 = don't fire)

• SetDamage <string>

Set the Damage Per Bullet

• SetTargetPosition <string>

World position that I should aim at

• SetTargetDir <vector>

Direction to aim at.

• SetTargetEntityName <target_destination>

Name of entity I should follow/attack

• SetTargetEntity <targetname>

Entity I should follow/attack (output from other entity only To do: really?)

• ClearTargetEntity

Clear the entity I should be attacking.

• FindNPCToManTank <string>

Find a nearby NPC to man this func_tank.

• StartFindingNPCs

Start searching for NPCs to man this func_tank.

• StopFindingNPCs

Stop searching for NPCs to man this func_tank.

• ForceNPCOff

Force the NPC manning this func_tank (if any) to leave.

• SetMaxRange <float>

Set the max range of the func_tank.

Outputs

• Targetname:

• OnFire

Fires when the tank fires its bullets

• OnAquireTarget

Fires when target is newly in range and can be shot

• OnLoseTarget

Fires when when target goes out of range

• OnAmmoDepleted

Fires when tank runs out of ammo

• OnGotController

Fires when an NPC starts to control this tank. Players do NOT fire this input.

• OnLostController

Fires when the NPC controller of the tank stops controlling it. Players do NOT fire this input.

• OnGotPlayerController

Fires when a Player starts to control this tank. NPCs do NOT fire this input.

• OnLostPlayerController

Fires when the Player controller of the tank stops controlling it. NPCs do NOT fire this input.

• OnReadyToFire

Fires once when the tank is done waiting to fire between rounds