SigMod - User contributions [en-gb]

List of custom attributes

2026-07-23T15:47:22Z

ABadHaiku: Make some descriptions more descriptive

== Preface: Type Hierarchy ==
All weapons and entities inherit from other things in the code, and as such can use any attributes from anything they inherit from.

* '''BaseEntity''' (All weapons and cosmetics)
** '''Wearable'''
*** Cosmetics
*** Demo Shields
*** Wearable Weapons (Boots, Booties, Sniperbacks)
** '''WeaponBase''' (All weapons)
*** '''BaseMelee''' (All melee weapons)
**** Swords
**** Banners
***** BASE Jumper (Parachute comes from attribute not weapon)
**** Thermal Thruster
*** '''Flamethrower'''
**** Dragon's Fury
*** Lunchbox items
*** Invis watches
*** Builders
**** '''Sapper'''
*** '''BaseGun''' (Anything that has projectiles/bullets)
**** '''Minigun'''
**** '''Revolver'''
**** '''SyringeGun'''
**** '''Medigun'''
**** Shotgun
***** Scattergun
***** Frontier Justice
**** Stock Pistol
***** Scout-specific pistols
**** Rocket Launchers
***** '''Crossbow''' (Crusader's Crossbow)
***** Righteous Bison + Pomson
**** Flare Guns
**** '''Sniper Rifles'''
**** Grenade Launchers
**** Stickybomb Launchers
***** '''CompoundBow''' (Huntsman/Fortified Compound)
**** Jars + Throwables
***** Halloween Spells
**** The Wrangler

* '''Entity''' (In the "Hammer" sense. Anything in the world with "state".)
** '''Player'''
*** '''MvMBot'''
** All other NPCs, buildings, etc

* BaseProjectile
** BaseRocket
** Flare
** Grenades + Cannonballs
** Bison + Pomson
** Arrows
** Stickies

== Unused Vanilla Attributes Made Accessible ==
These attributes exist in the base game's code, but since there's no "named attribute" for them in the item schema, there was no way to trigger them without a mod.

Since these are part of the base game, they're only checked for on certain weapon/entity types.

===== Types: =====

* <code>0/1</code>: A true or false value: either <code>0</code> or <code>1</code>.
* <code>Int</code>: A number without a decimal point. (e.g. <code>42</code>)
* <code>Float</code>: A number that may have a decimal point. (e.g. <code>6.7</code>)

{| class="wikitable sortable"
!Attribute Name
!Description
!Type
!Applicable To
|-
| parachute disabled
|If set to 1, the user cannot deploy parachutes, but can still retract them.
| 0/1
|Entity
|-
|fires milk bolt
|Alt-Fire fires a bolt that Mad-Milks enemies.
|0/1
|Crossbow
|-
|melee cleave attack
|Melee weapon hits all entities the raycast intersects with instead of just the first one.
|0/1
|BaseMelee
|-
|extra damage on hit
|Adds this number of heads on hitting an enemy.
On the Revolver specifically, increases damage dealt by 1% per head collected.
|Int
|WeaponBase/Revolver
|-
| extra damage on hit penalty
|Reduces your head count by this amount every time a shot is fired.
|Int
|Revolver
|-
|mod teleporter speed boost
|Grants the players speed buff for 4 seconds after leaving teleporter
|0/1
|Entity
|-
| can breathe under water
|If set to 1, the player can breathe underwater
|0/1
|Player
|-
| cannot swim
|If set to 1, the player cannot swim
|0/1
|Player
|-
|swimming mastery
|If set to 1, the player is not slowed down by 20% in water.
|0/1
|Player
|-
|scoreboard minigame
|Players with this attribute are granted more points for kills, but lose points after death.
Specifically, adds <code>kills + captures + defenses + buildingsdestroyed - (3 * deaths)</code> to the player's score, on top of the default scoring algorithm.
|0/1
|Player
|-
|wet immunity
|Makes the player immune to wet statuses, like Jarate and Mad Milk
|0/1
|Player
|-
|ability master sniper
|Unused Sniper upgrade with two levels. Multipliers are applied multiplicatively on top of other buffs.
On Sniper Rifles: Applies 0.6x/0.3x multiplier to zoom/unzoom delay, and multiplies charge rate by 1.5x/3x.
On Bows: Applies 0.6x/0.3x multiplier to reload time. Notably, does not stack with the Haste powerup.
|Int (0-2)
|SniperRifle/CompoundBow
|-
|last shot crits
|Become crit-boosted when only one shot is left in your clip.
|0/1
|WeaponBase
|-
|keep disguise on attack
|If 1, spies will keep their disguise when attacking with this weapon.
|0/1
|BaseGun
|-
|add give health to teammate on hit
| On hit ally: heal your teammate for x health, draining your own health.
|Int
|BaseMelee
|-
|mod minigun can holster while spinning
|Can switch to other weapons while aiming (revved-up) with the minigun.
|0/1
|Minigun
|-
|sapper deploy time
|Unimplemented. Makes the sapper take this amount of time to place on a building/robot.
|Float
|Sapper
|-
|kill combo fire rate boost
|On kill: gives x% fire rate bonus, stacks up to 3 times. Killing a different class clears the combo.
|Float
|WeaponBase
|-
|mult dispenser rate
|Multiplier for health, ammo, and metal dispenser rate. Queried on the builder.
| Float
|Entity
|-
| mvm sentry ammo
|Sentry max ammo multiplier. Queried on the builder.
|Float
|Entity
|-
| build small sentries
|Sentry is 20% smaller with 33% less health, and requires 25% less metal to upgrade. Queried on the builder.
|0/1
|Entity
|-
|mult teleporter recharge rate
|Teleporter recharge duration multiplier. Queried on the builder.
|Float
|Entity
|-
| disguise as dispenser on crouch
|As spy, disguise as a dispenser when crouching.
|0/1
|Player
|-
|ubercharge ammo
| Uses this much ubercharge % per shot instead of normal ammunition.
|Float
|SyringeGun
|-
|ubercharge transfer
|If <code>ubercharge_ammo</code> is set, hitting any other medic with the weapon will transfer this much ubercharge % to them.
|Float
|WeaponBase
|-
|teleport instead of die
| On receiving fatal damage: x% chance of being immediately revived at spawn with 1 health.
|Float
|Player
|-
|mult dmg vs same class
|Damage vs same class multiplier
|Float
|WeaponBase
|-
|uber on damage taken
|On taking damage: x% chance of being ubercharged for 3 seconds
| Float
|Player
|-
|mult dmgtaken from melee
|Damage taken from melee multiplier
| Float
|Player
|-
| mult crit when health is below percent
|Gain crit boost when below this proportion of health. (e.g. 0.6 = 60%)
|Float
|BaseEntity
|-
|penetration damage penalty
|Multiplier applied to a bullet's damage after each successive player it penetrates. Can also be used as a damage bonus applied exponentially per player penetrated.
| Float
|WeaponBase
|-
| firing forward pull
|On all weapons, pulls the user forward with x velocity while firing the weapon. Limited by ground move speed cap.
Additionally on the flamethrower: applies "speed boost" condition while firing.
|Float
|WeaponBase/Flamethrower
|-
|mod soldier buff range
| Multiplier for Soldier's banner buff range. Base is 450 HU.
|Float
|Player
|-
|mult rocketjump deploy time
|Deploy speed bonus when rocket jumping
|Float
|WeaponBase
|-
|mul nonrocketjump attackrate
|Fire rate multiplier when not rocket jumping.
|Float
|BaseGun
|-
|aoe heal chance
|On hit: refire time * (x/60) % chance for aoe heal for 1s (24 hp healed total). use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
| crits on damage
| On hit: refire time * (x/60) % chance for crit boost for 3s. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
|stun on damage
|On hit: refire time * (x/60) % chance for stun for 3s. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
| Float
|WeaponBase
|-
|aoe blast on damage
| On hit: refire time * (x/60) % chance for 100 hu blast that stuns players for 2 seconds and applies bleed. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
| mult dmg with reduced health
| Multiplier applied to damage proportion that is multiplied by "player maximum health" / "player current health".
|Float
|BaseMelee
|-
|mult airblast refire time
|Multiplier applied to the cooldown after airblasting before you can either fire or alt-fire again.
|Float
|Flamethrower
|-
|mult airblast primary refire time
|Multiplier of how fast primary fire specifically can be used after airblasting.
Primary attack delay = this * refire_time * base
| Float
|Flamethrower
|-
|mod flamethrower spinup time
|Spin up time for flamethrowers in seconds, like the delay between starting to rev up a minigun and being able to fire.
|Float
|Flamethrower
|-
| mult airblast cone scale
|Scales the cone used to push players by this amount.
|Float
|Flamethrower
|-
|airblast functionality flags
|Combination of flamethrower flags, used to limit airblast functionality. You have to add those numbers to enable specific functions (by default all are enabled):
1 - If airblast should push players

2 - If airblast can put out afterburn

4 - If airblast can reflect projectiles

8 - If airblast can stun players

16 - If airblast disrupts player aim
|Int
|Flamethrower
|-
|reverse airblast
|If the airblast can push players (see "airblast functionality flags"), airblast pushes players towards the pyro.
|0/1
|Flamethrower
|-
|airblast dashes
|Airblast pushes the pyro instead of enemies. Affected by airblast push force.
Flamethrowers with this attribute cannot reflect projectiles.
|0/1
|Flamethrower
|-
|mult sniper charge per sec with enemy under crosshair
|Sniper rifle charge rate when looking at the enemy. Still subject to the 200% charge rate limit
|Float
|SniperRifle
|-
|sniper beep with enemy under crosshair
|Plays <code>doomsday.warhead</code> sound when an enemy appears under your crosshair.
|0/1
|SniperRifle
|-
|medic machinery beam
|If set to 1, enables healing buildings as medic. increases building healing rate by 10% for each point
|Int
|Medigun
|-
|force distribute currency on death
|Bots with this attribute distribute their currency on death, like with sniper kills (red money)
|0/1
|MvMBot
|}

== Custom Attributes ==
These attributes are fully custom, implemented with modded logic.

{| class="wikitable sortable"
!Attribute Name
!Description
!Example Value
|-
|set turn to ice
|Turns the victim ragdoll to ice
|1
|-
|arrow mastery
|Lets the Huntsman shoot 2 additional arrows per level, 25 base damage each. Can headshot.
|1
|-
|ability doubletap teleport
|If set to 1, the player can move teleporters with double tapped movement keys. Does not work
|1
|-
|mod ignore resists absorbs
| A worse version of damage piercing since it only ignores the Battalion's Backup's 35% damage reduction. Does not work?
|1
|-
|mod projectile heat seek power
| The weapon's homing seek power, in degrees per second.
This attribute is '''required''' for the other "mod projectile heat" attributes to work!
|360
|-
| mod projectile heat aim error
|The weapon's max error in aim in degrees. If no target is within this degree, the projectile will not home.
|90
|-
|mod projectile heat aim time
|Time in seconds that the projectile is homing for
|1.75
|-
|mod projectile heat no predict target speed
|Disables movement prediction for homing projectiles. Might be useful for very slow projectiles.
|1
|-
|mod projectile heat follow crosshair
|Homing projectiles will follow the crosshair instead of enemies.
|1
|-
|mod projectile heat aim start time
|Time in seconds before the projectile starts homing.
|3
|-
|disable buildings on hit
|On building hit: Disable for x seconds
|4
|-
| regenerate stickbomb
|Regenerates Ullapool Caber after a hit.
| 1
|-
|mult smack time
|Melee "smack time" multiplier; time between pressing the fire button and the attack being dealt (0.2s default)
|4
|-
|custom item model
|Custom item model name
|models/model.mdl
|-
|custom weapon fire sound
| Custom weapon fire sound. Does not work for the weapon owner
|
|-
|explosive bullets
| Bullets explode in x radius on hit (147 is rocket launcher radius)
|100
|-
|mult projectile scale
| Projectile model scale multipier
|2
|-
| mult projectile count
|Fire x projectiles at once. Add "ignores other projectiles" 1 to Rocket Launchers so that rockets don't collide with each other.
|4
|-
| projectile trail particle
|Projectile trail particle name. Prefix the particle name with ~ to remove the original particle.
|
|-
|explosion particle
|Explosion particle name
|
|-
|radius sleeper
|Restores the Sydney Sleeper's old "Jarate explosion" on headshot and fully-charged bodyshot.
|1
|-
|cannot be sapped
|Bots with this attribute cannot be affected by the Sapper
|1
|-
|item color rgb
|Item tint color
|223424
|-
| is invisible
|Turns item invisible
| 1
|-
| cannot taunt
|If set to 1, cannot taunt
|1
|-
|projectile acceleration
|Projectile acceleration in hu/s^2
|500
|-
|projectile acceleration time
|TIme in seconds that the projectile should accelerate for
|2.55
|-
|projectile acceleration start time
|Time before projectile starts accelerating
|1
|-
|is miniboss
|The player is counted as a miniboss. Sappers will not fully stun, backstabs deal set damage, will not receive bomb buffs.
|1
|-
|model scale
| Player's model scale. 1.75 is used for giant bots.
|1
|-
|cannot upgrade
|If set to 1, the player cannot use upgrade stations
|1
|-
|min respawn time
|Minimal respawn time in seconds
|4
|-
|always crit
|Weapon always crits. Less reliable with higher ping.
|1
|-
|mult firerocket rate
|Level 3 Sentry rocket fire rate
| 1
|-
|building max level
|Building max level limit
|1
|-
|sentry rapid fire
|Allows for faster sentry fire rate, up to 66 shots per second. Effectively fixes sentry fire rate upgrades by not simulating it every 3 ticks, but every tick.
| 1
|-
|dont count damage towards crit rate
| Dealing damage with weapon does not increase crit rate
|1
|-
|reduced damage rampup
|Sets the weapon's maximum damage rampup to 20% (similar to Stickybomb Launchers)
|1
|-
|no reduced damage rampup
|Sets the weapon's maximum damage rampup to 50% (similar to Shotguns)
|1
|-
|force damage falloff
|Forces the weapon to have damage rampup and falloff
|1
|-
|can headshot
|Weapon can headshot. Hitscan only; inconsistent on multi-pellet weapons such as Shotguns.
|1
|-
|building color rgb
|Building tint color
|23424
|-
|building scale
|Building scale. Values above 1.17 make it difficult for players to build on uneven ground
|1.54
|-
|mult stun resistance
|Stun and slow multiplier. 0 to be fully stun/slow immune
| 0
|-
|allow friendly fire
| If set to 1, the player can deal friendly fire damage
|1
|-
|receive friendly fire
| If set to 1, the player can receive friendly fire from teammates
|1
|-
|mult dmg friendly fire
|Damage dealt to teammates multiplier. '''Requires''' "allow friendly fire" to be set to 1.
|0.4
|-
|cannot headshot
|Weapon cannot headshot
|1
|-
|mult crit dmg
|Crit damage multiplier
|1.54
|-
| cannot be headshot
|If set to 1, the player cannot be headshot. Only blocks hitscan headshots
|1
|-
|attachment name
| Use this model attachment instead of bonemerging. If the name is empty, it will follow player origin instead.
Common attachments for robot models: head, eye_1, flag. Some bot models also have eye_2, partyhat. Demo & Soldier additionally contain foot_L and foot_R

Common attachments for player models: head, eyes, flag, partyhat, bread_face, bread_head, effect_hand_L, effect_hand_R, bread_hand_r, bread_hand_l, bread_butt, bread_heel_l, foot_L, foot_R

This attribute is '''required''' to make other "attachment" attributes work!
|head
|-
|attachment offset
| Item offset from the attachment origin
|4 2 44
|-
|attachment angles
|Rotation for attached items
|25 25 0
|-
| attachment scale
|Model scale for attached items
|1.5
|-
|projectile gravity
|Projectile gravity in hu/s^2
|600
|-
| grenade explode on impact
|Grenades explode on impact with the world, similar to rockets
| 1
|-
|
projectile lifetime
|Projectile lifetime in seconds; deletes projectiles, does not cause explosions for explosive projectiles.
| 52
|-
|not solid to players
| The player is not solid to other players
|1
|-
|is suicide counter
|If set, the player takes this amount of damage per second, ignores uber, does not apply damage force
|1
|-
|always allow taunt
|Always allow the player to continue taunting, even midair. The player cannot start a taunt in midair, but their taunts will not be interrupted by being launched or falling off a bot.
|1
|-
|mult reflect velocity
| Reflected projectile speed multiplier
| 1
|-
|custom kill icon
|Use custom kill icon. Icons are defined in scripts/mod_textures.txt in tf_misc_dir.vpk
|armageddon
|-
| cannot be upgraded
|If set to 1, the weapon cannot be upgraded, but the player can still use the upgrade station
|1
|-
|projectile no deflect
|Projectile cannot be deflected (such as by miniguns) or reflected (such as by flamethrowers). Short Circuit orb will still delete the projectile.
| 1
|-
| player gravity ballon head
|Player gravity multiplier when affected by the balloon head condition (TF_COND_BALLOON_HEAD). 0 is for regular gravity
|12
|-
| mult dmg vs giants
|Damage multiplier vs giants
|2.5
|-
| mult dmg vs tanks
| Damage multiplier vs tanks
|2.5
|-
| mult dmg vs npc
|Damage multiplier vs npc - including Halloween bosses and tanks, excluding player bots
| 2.5
|-
| custom hit sound
|Custom sound played when an enemy is hit with the weapon
|fdfdf
|-
| custom impact sound
|Custom sound played when a rocket / projectile / bullet hits something
|fdfdf
|-
|custom weapon reload sound
|Custom weapon reload sound
|fdfdf
|-
|no explosion particles
| No explosion particles and sounds
|1
|-
| override projectile type extra
|Special version of override projectile type that adds more projectile types:
{| class="wikitable sortable mw-collapsible mw-collapsed" style="margin: 0 auto; width: 100%; padding: 0;"
! colspan="1" |Possible values
|-
|
* "mechanicalarmorb" - Short circuit orb

* "stunball" - Sandman ball

* "ornament" - Wrap Assassin projectile
*"jarate"
*"madmilk"
*"cleaver"
*"gas"
*"brick" - Uses bread model. Deals 40 damage on hit.
*"repel"
*"breadmonster"
*"spellfireball" - Fireball spell. ''Only this spells will trigger ShootTemplate blocks; others will not!''
*"spelllightningorb"
*"spellkartorb" - Explosive KGB Glove from the Carnival of Carnage kart minigames.
*"spellbats"
*"spellmirv" - Pumpkin bombs, only works if the owner has spellbook equipped
*"spelltransposeteleport"
*"spellmeteorshower"
*"spellspawnboss" - Summons spectral MONOCULUS.
*"spellspawnhorde" - Summon skeletons, only works if the owner has spellbook equipped
|}
|mechanicalarmorb
|-
|dmg current health
|Deal additional damage; x * target's current health.
|0.34
|-
|dmg max health
|Deal additional damage; x * target's max health
|0.34
|-
|dmg missing health
|Deal additional damage; x * target's missing health
|0.34
|-
| cannot be teleported
|If set to 1, the player cannot be teleported
|1
|-
| mult medigun range
|Medigun range multiplier
|1.5
|-
|projectile penetration limit
|Penetration limit for projectiles
|3
|-
| max aoe targets
|Max targets affected by explosives and flamethrowers
|4
|-
|effect cond override
|Effect condition override on drinks, jars, medigun ubercharges, and many other effect-causing weapons
| 24
|-
|add cond on hit
|Adds condition to the target on hit. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536.
|56
|-
|add cond on hit duration
|Add condtion on hit duration
|4
|-
| remove cond on hit
|Remove condtion from target on hit. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536.
| 57
|-
| self add cond on hit
|Adds condition to self when hitting a target
|54
|-
|self add cond on hit duration
| Duration of the condition added to self when hitting a target. Requires "self add cond on hit".
|3
|-
|add cond on kill
|Adds condition to self when killing a target
|57
|-
|add cond on kill duration
|Duration of the condition added to self when killing a target. Requires "add cond on kill".
|10
|-
|add cond when active
|Add condition when weapon is active. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536
|11
|-
|add damage type
|Add damage type to the attack. See [https://developer.valvesoftware.com/wiki/Half-Life_2/Damage_types here] for a list of damage types.
|1
|-
|remove damage type
|Remove damage type from the attack
|1
|-
|special damage type
| Sets a special damage type to a range from 1-3, to interact with the attributes listed below. Has no effect otherwise.
|1
|-
|dmg taken mult from special damage type 1
|
Damage taken multiplier from weapons with special damage type 1
|4
|-
|dmg taken mult from special damage type 2
|Damage taken multiplier from weapons with special damage type 2
|4
|-
|dmg taken mult from special damage type 3
|Damage taken multiplier from weapons with special damage type 3
|4
|-
|mult effect duration
|Effect duration multiplier on drinks and jars (Crit-a-Cola, Jarate, etc.)
|3
|-
|special item description
|Shows text as an attribute if the weapon is inspected or shown as a custom weapon.

|item description
|-
|mult flag carrier move speed
|Flag carrier move speed multiplier
|0.66
|-
|overheal from heal on kill
|If set to 1 and the weapon heals on kill, it can provide overheal
|1
|-
| fire input on hit
|Fire an input on hit targets. The player with the attribute is considered the !activator, the target hit is considered the !self. The format is <target>^<input>^<param>. If omitted, default param is damage received
|!self^SetHealth^0
|-
|fire input on hit name restrict
|Restrict input on hit to the specified targetname or classname. Wildcards are allowed.
|player
|-
|grenade bounce speed
|Grenades bounce off walls, retaining x% of speed after each bounce. Also works on arrows.
| 0.8
|-
|grenade bounce speed xy
|Grenade bounce speed in xy direction multiplier
|2
|-
|grenade bounce damage
|Grenades explode on direct hits even if the grenade already touched a wall, dealing x% additional damage. Values below 1 will make the grenade deal less damage.
|0.3
|-
|reset arrow hits on bounce
|If set to 1 on the Huntsman, when the arrow bounces, allow it to hit the same target again. Requires "grenade bounce speed" or "arrow target bounce speed"
|1
|-
|arrow target bounce speed
|Proj+ectiles bounce off hit targets, retaining x% of speed after each bounce.
|1
|-
|projectile gravity native
|
Gravity for arrows and flares. 0 is default gravity. For grenades and stickybombs, any value will disable gravity
|0.4
|-
|grenade no drag
|No drag for grenades and stickybombs, slightly changes projectile arc.
|
1
|-
|stickybomb stick to enemies
|Stickybombs can stick to enemies on hit. If already stuck to the world, they will not get stuck on players.
|1
|-
|stickybomb no stick
|Stickybombs do not stick to ground
|1
|-
|collect currency on kill
|Bots killed by the weapon distribute their currency, like with sniper kills (red money)
|1
|-
|stomp player damage
|Damage applied to enemies when touching them
|100
|-
|stomp player time
|Time between each instance of stomp damage and push. By default, it happens every tick
|0.1
|-
|stomp player force
|Force applied to enemies when touching them. 260 is the minimum amount to knock players up.
|270
|-
|stomp building damage
|Damage dealt to enemy buildings on touch
|125
|-
|reflect keep team
|Projectiles reflected by this weapon keep their original team

|1
|-
| custom wind up sound
|Custom minigun wind up sound. Does not override default sound
|sound.wav
|-
| custom wind down sound
|Custom minigun wind down sound. Does not override default sound
|sound.wav
|-
|custom minigun spin sound
|Custom minigun spin sound. The sound will not loop unless its made to loop
|sound.wav
|-
|reflect magnet
|If set to 1, reflected projectiles aim towards the reflector
|1
|-
|stay after regenerate
|If set to 1, the weapon will stay after touching a resupply cabinet or upgrading, if the weapon in the inventory in the slot is different
|1
|-
|arrow hit kill time
|If set to any value other than 0, sets custom arrow kill time after hitting something
|0.3
|-
|custom projectile size
|Custom projectile hitbox size
|30
|-
|mod sentry cost
|Sentry cost multiplier
|1.25
|-
| mod dispenser cost
| Dispenser cost multiplier
|1.25
|-
|penetrate teammates
|Bullets and projectiles penetrate teammates, like sniper rifles.
| 1
|-
|mult step height
|Step height multiplier (x * 18hu); allows the player to not need to jump for greater heights
|10
|-
|ignore player clip
|Ignore player clip brushes
|1
|-
|allow bunny hop
|Allow bunny hopping. 1 - auto bhop. 2 - manual bhop
|1
|-
|fire input on kill
| Fire input on killed targets. The player with the attribute is considered the !activator, the target killed is considered the !self. The format is <target>^<input>^<param>. If omitted, default param is damage received. !projectile is the projectile entity
|!self^SetHealth^0
|-
|fire input on kill name restrict
|Restrict input on kill to specified targetname. Wildcards are allowed

|player
|-
|fire full clip at once
|Fire the weapon's entire clip at once
|1
|-
|reload full clip at once
|Reload full clip at once, like pistols
|1
|-
|force fire full clip
| Automatically fire full clip, one shot at a time. Not to be confused with "fire full clip at once".
|1
|-
|projectile sound
| Sound played when the projectile is fired
|sound.wav
|-
|burst fire count
|Fire this many rounds in a burst. If negative, forces to fire this many rounds even if attack button is only pressed once
|3
|-
|burst fire rate mult
|Fire rate multiplier between bursts. Regular fire rate is used for the time between shots in a burst.
|2
|-
|continous accuracy mult
|Accuracy multiplier, continous attacking increases/decreases accuracy up to specified value over the duration of "continous accuracy time" attribute. Overwrites "spread penalty" attribute
|3
|-
|continous accuracy time
|How long in seconds should the weapon be fired continously to reach full "continous accuracy mult" value
|1
|-
|duck accuracy mult
|Accuracy multiplier when ducking. Overwrites "spread penalty" attribute
|0.5
|-
|move accuracy mult
|Accuracy multiplier when moving. Overwrites "spread penalty" attribute
|2
|-
|special item description 2
|Additional item description line
|description
|-
|special item description 3
|Additional item description line
|description
|-
|special item description 4
|Additional item description line
|description
|-
|allowed build types
| Allowed building types, add values together to allow multiple buildings:
1 - dispenser

2 - teleporter

4 - sentry gun

8 - sapper
|6
|-
|max bullet range
|Max bullet range in hu
|10
|-
|effect add attributes
|Make weapons that apply addcond effects, such as banners, jars, etc., also apply attributes to the affected player
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|medigun passive attributes
|Attributes added passively to the patient being healed
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|medigun passive attributes owner
|Attributes added passively to the healing medic
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|mult dmg vs airborne
|Damage multiplier vs airborne players
|3
|-
|revive rate
|Medigun revive speed multiplier
|10
|-
|taunt attack after end
|Taunt attack happens even after taunt ends or is interrupted
|1
|-
|taunt attack time mult
|Taunt attack time multiplier, making it happen earlier/later
|2
|-
|damage returns as health
|Returns x * damage dealt as health
|0.5
|-
|no resupply
|Cannot resupply from cabinets
|1
|-
|no damage view flinch
|No view flinch from taking damage
|1
|-
|disable wrangler shield
|If set to 1, the Wrangler's sentry shield is disabled
|1
|-
|parachute redeploy
|Allow infinite mid-air parachute redeploying
|1
|-
|mult duck speed
|Ducking speed multiplier. 3 is for walking speed. Cannot be faster than walking speed
|3
|-
|particle color rgb
|RGB color for projectile particles that support it (Bison, Pomson)
|765776
|-
|particle color rainbow
|Cycles colors for the projectile particle. Higher values cycle faster
|100
|-
|ignored by enemy sentries
|If set to 1, enemy sentries ignore the player
|1
|-
|melee airblast
|If set to 1 on a melee weapon, its attacks will reflect projectiles
|1
|-
|passive reload
|Automatically reloads the weapon while not active. Since the reload speed is tied to animations this will make weapons reload faster than usual
|1
|-
|kb fall min velocity
|Knockback, stun and damage nearby enemies when landing. The value specifies the minimum fall velocity before applying knockback. This attribute is '''required''' for the other "kb fall" attributes to work!
|300
|-
|kb fall radius
|The radius of the fall knockback. 230 by default
|230
|-
|kb fall stun time
|Small robot stun time of the fall knockback. 5 by default
|5
|-
|kb fall force
|Fall knockback force. 300 by default
|300
|-
|kb fall damage
|Fall knockback damage. 50 by default
|50
|-
|melee grants protection
|Melee attacks grant protection from attacks for x seconds
|0.6
|-
|arrow snap to next target radius
|If set on the Huntsman, snaps the arrow to the next closest available target within range
|1000
|-
|mult credit collect range
|Credit collection radius multiplier. Scouts have a 4x bigger collection radius
|2
|-
|health from credits
|Additional health gained from collecting credits. Scouts usually gain 50 health on collecting credits
|50
|-
|mult bleeding delay
|Delay between bleeding damage multiplier. Lower values causes bleed damage to happen more times per second.
|2
|-
|mult bleeding dmg
|Bleeding damage multiplier
|2
|-
|not solid
|If set to 1, the player can phase though walls
|1
|-
|dmg taken from self reduced
|Self damage multiplier for the player
|0.5
|-
|ignored by bots
|If set to 1, the player is ignored by bots.
|1
|-
|add attributes on hit
|<nowiki>Apply attributes to victim on hit with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|self add attributes on hit
|<nowiki>Apply attributes to self on hit with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|add attributes on kill
|<nowiki>Apply attributes to self on kill with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|move speed as health decreases
|Multiply move speed up to x with decreasing health
|2
|-
|no self effect
|If set to 1, the weapon cannot ignite or cause bleeding to the wielder
|1
|-
|cannot pickup spells
|Cannot pickup spells
|1
|-
|mult max health
|Max health multiplier
|2
|-
|add spread
|Bullet spread additive. Does not affect clientside effects
|1
|-
|projectile spread angle mult
|Projectile spread angle multiplier
|3
|-
|always allow disguise
|Always allow the spy to disguise
|1
|-
|always allow cloak
|Always allow the spy to cloak
|1
|-
|always allow teleport
|Always allow the player to teleport
|1
|-
|destroy buildings on death
|Destroy owned buildings on death
|1
|-
|sentry bullet weapon
|Sentry bullet weapon name. Can be a custom weapon name
|TF_WEAPON_ROCKETLAUNCHER
|-
|sentry rocket weapon
|Sentry rocket weapon name. Can be a custom weapon name
|TF_WEAPON_ROCKETLAUNCHER
|-
|custom sentry model
|Custom sentry model file name or prefix
|models/buildables/sentry
|-
|custom dispenser model
|Custom dispenser model file name or prefix
|models/buildables/dispenser
|-
|custom teleporter model
|Custom teleporter model file name or prefix
|models/buildables/teleporter
|-
|mult sentry rocket ammo
|Sentry rocket ammo multiplier
|3
|-
|midair accuracy mult
|Midair accuracy multiplier
|2
|-
|add damage per target
|Damage bonus for every target hit by explosion
|0.5
|-
|projectile detonate time
|Projectile self detonation time in seconds
|0.5
|-
|mult afterburn delay
|Multiplier for the delay between afterburn damage ticks, similar to "mult bleeding delay". Lower values result in more damage per second.
|2
|-
|custom view model
|Custom view model. This typically affects first person hands and their animations
|models/model.mdl
|-
|mult dmg while midair
|Damage multiplier while midair
|0.5
|-
|hidden string attribute 1
|Attribute for storing hidden text in items. 1-4 numbers are available
|abc
|-
|medigun keep charged effect
|Keep custom medigun uber effect after the beam is disconnected until the uber meter runs out
|1
|-
|ignores other projectiles
|Don't collide with other projectiles
|1
|-
|weapon always gib
|This weapon always gibs killed enemies
|1
|-
|weapon never gib
|This weapon never gibs killed enemies
|1
|-
|always gib
|Always gib on death
|1
|-
|never gib
|Never gib on death
|1
|-
|sapper sap allies
|Sap ally players instead of enemies
|1
|-
|custom sapper model
|Custom sapper model; accept either a prefix or full model path
|models/buildables/sd_sapper
|-
|custom sapper sound
|Custom sapper sound. See example value.
|Weapon_Sapper.Timer
|-
|no clip
|Give noclip. 1 for regular player speed, use any other value to override
|1
|-
|arrow ignite
|If set to 1 on the Huntsman, automatically ignites arrows
|1
|-
|use original class weapon animations
|Use weapon animations of the weapon's original class if the weapon is given to an unintended class
|1
|-
|mult dmg before distance
|Deals up to x damage depending on distance (2048 hu by default)
|2
|-
|mult dmg before distance specify
|Custom distance for "mult dmg before distance"
|1000
|-
|minigun full movement
|Can move while ducking when shooting. Bots can also jump
|1
|-
|use original class player animations
|Use player animations of the weapon's original class if the weapon is given to an unintended class
|1
|-
|mult sentry rocket projectile speed
|Sentry rocket projectile speed multiplier
|2
|-
|crit on cond
|Critical hit when the enemy has specified cond
|13
|-
|minicrit on cond
|Mini crit hit when the enemy has specified cond
|13
|-
|add attributes when active
|Add attributes when the weapon is active
|<nowiki>move speed bonus|2|damage bonus|2</nowiki>
|-
|radial cond
|Add conditions and attributes on hit in a radius
|400
|-
|mult explosion radius direct hit
|Explosion radius multiplier on direct hit
|2
|-
|buildings cannot be sapped
|Buldings cannot be sapped
|1
|-
|mult dmg direct hit
|Damage multiplier on direct hit
|2
|-
|explosion particle on direct hit
|Explosion particle on direct hit
|particle
|-
|cannot upgrade bomb
|Bomb cannot be upgraded
|1
|-
|sentry toolbox model
|Custom carried by player sentry toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|dispenser toolbox model
|Custom carried by player dispenser toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|teleporter toolbox model
|Custom carried by player teleporter toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|medigun attack enemy
|Can attack enemies, dealing damage equal to % heal rate
|1.1
|-
|medigun self drain
|Drain health equal to % heal rate from the user when healin
|0.6
|-
|fire input on attack
|Fire input on attack. Player is !activator, projectile is !projectile (must be input target), weapon is !self
|!activator^SetHealth^0
|-
|stun on hit
|Stun target on hit duration
|4
|-
|stun on hit no giants
|Giant robots cannot be stunned
|1
|-
|stun on hit type
|Stun on hit type:
movement
panic
bonk
ghost
bigbonk
|movement
|-
|stun on hit slow
|Movement penalty applied with "movement" stun on hit type
|0.4
|-
|medigun attack enemy heal mult
|Multiplier of health gained from attacking enemies
|3
|-
|medigun particle
|Medigun custom particle. Automatically uses _red and _blue particles when not specified. Sometimes ~ has to be added so that the particle disappears when needed
|passtime_beam
|-
|medigun particle enemy
|Medigun custom particle when attacking enemies. Sometimes ~ has to be added so that the particle disappears when needed
|~dxhr_arm_muzzleflash2
|-
|medigun particle release
|Medigun custom particle when uber is released. Sometimes ~ has to be added so that the particle disappears when needed
|~dxhr_arm_muzzleflash2
|-
|medigun particle spark
|Medigun custom particle for full charge sparks
|medicgun_invulnstatus_fullcharge
|-
|effect immunity
|Immune to effects applied by other players
|1
|-
|use robot voice
|Use robot voicelines
|1
|-
|use human voice
|Use human voicelines
|1
|-
|alt fire attack
|Alt fire fires an attack. Value higher than 1 specifies fire rate multipler when using secondary attack
|1
|-
|alt fire attributes
|Attributes to apply when alt fire button is pressed
|<nowiki>fire rate bonus|2|damage bonus|2</nowiki>
|-
|no revive
|No revive marker on death
|1
|-
|fire input on effect
|Fire input when an addcond effect is applied by this weapon. Provider is !activator. The receiver is !caller
|!activator^SetHealth^0
|-
|additional step sound
|Additional step sound
|MVM.BotStep
|-
|fov override
|Field of view override. Sniper rifles reset this
|33
|-
|hud overlay
|Overlay material
|effects/jarate_overlay
|-
|fire input on taunt
|Fire input when taunting
|!activator^SetHealth^0
|-
|displace touched enemies
|Move enemies out of the way. Deal x damage per tick to stuck enemies
|1
|-
|addcond immunity
|<nowiki>Immune to specific addconds, separated by |</nowiki>
|<nowiki>1|3</nowiki>
|-
|attribute immunity
|<nowiki>Player immune to specific attributes, separated by |</nowiki>
|<nowiki>move speed bonus|damage bonus</nowiki>
|-
|hold fire until full reload
|Hold fire until full reload. Set to 2 to disable weapon switch if weapon is not fully loaded, even if not currently reloading
|1
|-
|projectile hit radius
|Projectile hit radius for damageable entities only
|100
|-
|noclip projectiles
|Projectiles penetrate walls. Cannot hit anything unless "projectile hit radius" is set
|1
|-
|projectile health
|Projectiles have specified amount of health. Not every projectile is compatible, the owner cannot shoot his own non grenade projectiles. "custom projectile size" might be required to hit some projectiles with bullets
|100
|-
|projectile take damage type
|Damage taken by projectile restrictions:
0 - no restrictions

1 - only owner can damage

2 - own team only

3 - enemies only
|1
|-
|projectile take damage time
|Time in seconds before projectile can take damage
|0.25
|-
|projectile explode on destroy
|Projectiles explode when destroyed. Can be one of those values:
0 - do not explode
1 - explode
2 - explode, the damage belongs to the attacker
3 - explode only if destroyed by the same team
|1
|-
|projectile explode time
|Projectiles detonate after delay in seconds
|1
|-
|shoot view punch angle
|View punch angle when shooting
| -3 0 0
|-
|shoot view punch angle random
|View punch angle random variance when shooting
|3 0 0
|-
|custom item model attachment
|<nowiki>Custom additional item models, parameters in order: model path, player attachment name (leave empty for bonemerge, type "none" for no attachment), R G B color (leave empty for normal), offset, rotation, scale. Offset, rotation, scale only works if attachment name is not empty. Separate attachments with |</nowiki>
|<nowiki>models/model.mdl,,33 55 99|models/model.mdl,effect_hand_R,,4 2 0,0 270 90,1.5</nowiki>
|-
|custom item model attachment 2
|Additional item model attribute
|models/model.mdl,none,255 255 0,0 0 100,0 0 0,1.5
|-
|custom item model attachment 3
|Additional item model attribute
|
|-
|custom item model attachment viewmodel
|<nowiki>Custom additional item models in view model, parameters in order: model path, offset, rotation, scale. Offset, rotation, scale detach the model from main view model. Separate attachments with |</nowiki>
|<nowiki>models/model.mdl|models/model.mdl,4 2 0,0 270 90,1.5</nowiki>
|-
|custom item model attachment viewmodel 2
|Additional item model attribute in view model
|models/model.mdl,0 0 100,0 0 0,1.5
|-
|custom item model attachment viewmodel 3
|Additional item model attribute in view model
|
|-
|custom weapon deploy sound
|Custom deploy sound
|sound.wav
|-
|spread angle pattern
|Spread angle (pitch, yaw, roll) pattern, the pattern cycles with each projectile fired
|<nowiki>10 0 0|0 0 0|-10 0 0</nowiki>
|-
|spread offset pattern
|Spread offset (front, left, up) pattern, the pattern cycles with each projectile fired
|<nowiki>0 10 0|0 0 0|0 -10 0</nowiki>
|-
|proj attribute pattern
|<nowiki>Attribute pattern, cycles with each projectile fired. Attributes separated with |, cycles separated with &</nowiki>
|<nowiki>projectile speed increased|2|damage bonus|0.5&projectile speed decreased|0.5</nowiki>
|-
|shoot pattern reset time
|Reset the pattern this many seconds after last attack. By default, pattern is reset as soon as the player stops firing
|1
|-
|shoot pattern no rollback
|Set to 1 to not rollback the pattern when reaching the last cycle
|1
|-
|custom damage type override
|Change custom damage type to something else. Usually it only changes kill icon but sometimes it applies some effects. Available custom damage types: https://developer.valvesoftware.com/wiki/Team_Fortress_2/Scripting/Script_Functions/Constants#ETFDmgCustom
|47
|-
|flare no crit burning
|Disable crit on burning players for flares
|1
|-
|rage receive scale
|Scale for damage being received
|2
|-
|fire input on hit ally
|Fire input on hit allied players. May require allow friendly fire to work. The player is the activator. The format is <target>^<input>^<param>. If omitted, default param is damage received. !projectile is the projectile entity
|!self^SetHealth^0
|}
[[Category:Misc Additions]]

List of custom attributes

2026-07-23T00:44:23Z

ABadHaiku: Separate fully-custom attributes from formerly-inaccessible vanilla ones, add "applicable to" information for vanilla attributes and clarify type hierarchy.

== Type Hierarchy ==
All weapons and entities inherit from other things in the code, and as such can use any attributes from anything they inherit from.

* '''BaseEntity''' (All weapons and cosmetics)
** '''Wearable'''
*** Cosmetics
*** Demo Shields
*** Wearable Weapons (Boots, Booties, Sniperbacks)
** '''WeaponBase''' (All weapons)
*** '''BaseMelee''' (All melee weapons)
**** Swords
**** Banners
***** BASE Jumper (Parachute comes from attribute not weapon)
**** Thermal Thruster
*** '''Flamethrower'''
**** Dragon's Fury
*** Lunchbox items
*** Invis watches
*** Builders
**** '''Sapper'''
*** '''BaseGun''' (Anything that has projectiles/bullets)
**** '''Minigun'''
**** '''Revolver'''
**** '''SyringeGun'''
**** '''Medigun'''
**** Shotgun
***** Scattergun
***** Frontier Justice
**** Stock Pistol
***** Scout-specific pistols
**** Rocket Launchers
***** '''Crossbow''' (Crusader's Crossbow)
***** Righteous Bison + Pomson
**** Flare Guns
**** '''Sniper Rifles'''
**** Grenade Launchers
**** Stickybomb Launchers
***** '''CompoundBow''' (Huntsman/Fortified Compound)
**** Jars + Throwables
***** Halloween Spells
**** The Wrangler

* '''Entity''' (In the "Hammer" sense. Anything in the world with "state".)
** '''Player'''
*** '''MvMBot'''
** All other NPCs, buildings, etc

* BaseProjectile
** BaseRocket
** Flare
** Grenades + Cannonballs
** Bison + Pomson
** Arrows
** Stickies

== Unused Vanilla Attributes ==
These attributes exist in the base game's code, but since there's no "named attribute" for them in the item schema, there was no way to trigger them without a mod.

Since these are part of the base game, they're only checked for on certain weapon/entity types.

===== Types: =====

* <code>0/1</code>: A true or false value: either <code>0</code> or <code>1</code>.
* <code>Int</code>: A number without a decimal point. (e.g. <code>42</code>)
* <code>Float</code>: A number that may have a decimal point. (e.g. <code>6.7</code>)

{| class="wikitable sortable"
!Attribute Name
!Description
!Type
!Applicable To
|-
| parachute disabled
|If set to 1, the user cannot deploy parachutes
| 0/1
|Entity
|-
|fires milk bolt
|Secondary attack: crossbow fires milk bolt. Regenerates every x seconds
|0/1
|Crossbow
|-
|melee cleave attack
|Melee weapon attacks all enemies in range
|0/1
|BaseMelee
|-
|extra damage on hit
|Adds this number of heads on hitting an enemy.
On the Revolver specifically, increases damage dealt by 1% per head collected.
|Int
|WeaponBase/Revolver
|-
| extra damage on hit penalty
|Reduces your head count by this amount every time a shot is fired.
|Int
|Revolver
|-
|mod teleporter speed boost
|Grants the players speed buff for 4 seconds after leaving teleporter
|0/1
|Entity
|-
| can breathe under water
|If set to 1, the player can breathe underwater
|0/1
|Player
|-
| cannot swim
|If set to 1, the player cannot swim
|0/1
|Player
|-
|swimming mastery
|If set to 1, the player is not slowed down by 20% in water.
|0/1
|Player
|-
|scoreboard minigame
|Players with this attribute are granted more points for kills, but lose points after death.
Specifically, adds <code>kills + captures + defenses + buildingsdestroyed - (3 * deaths)</code> to the player's score, on top of the default scoring algorithm.
|0/1
|Player
|-
|wet immunity
|Makes the player immune to wet statuses, like Jarate and Mad Milk
|0/1
|Player
|-
|ability master sniper
|Unused Sniper upgrade with two levels. Multipliers are applied multiplicatively on top of other buffs.
On Sniper Rifles: Applies 0.6x/0.3x multiplier to zoom/unzoom delay, and multiplies charge rate by 1.5x/3x.
On Bows: Applies 0.6x/0.3x multiplier to reload time. Notably, does not stack with the Haste powerup.
|Int (0-2)
|SniperRifle/CompoundBow
|-
|last shot crits
|Become crit-boosted when only one shot is left in your clip.
|0/1
|WeaponBase
|-
|keep disguise on attack
|If 1, spies will keep their disguise when attacking with this weapon.
|0/1
|BaseGun
|-
|add give health to teammate on hit
| On hit ally: heal your teammate for x health, draining your own health.
|Int
|BaseMelee
|-
|mod minigun can holster while spinning
|Can switch to other weapons while aiming with the minigun.
|0/1
|Minigun
|-
|sapper deploy time
|Unimplemented. Makes the sapper take this amount of time to place on a building/robot.
|Float
|Sapper
|-
|kill combo fire rate boost
|On kill: gives x% fire rate bonus, stacks up to 3 times. Killing a different class clears the combo.
|Float
|WeaponBase
|-
|mult dispenser rate
|Multiplier for health, ammo, and metal dispenser rate. Queried on the builder.
| Float
|Entity
|-
| mvm sentry ammo
|Sentry max ammo multiplier. Queried on the builder.
|Float
|Entity
|-
| build small sentries
|Sentry is 20% smaller with 33% less health, and requires 25% less metal to upgrade. Queried on the builder.
|0/1
|Entity
|-
|mult teleporter recharge rate
|Teleporter recharge duration multiplier. Queried on the builder.
|Float
|Entity
|-
| disguise as dispenser on crouch
|As spy, disguise as a dispenser when crouching.
|0/1
|Player
|-
|ubercharge ammo
| Uses this much ubercharge % per shot instead of normal ammunition.
|Float
|SyringeGun
|-
|ubercharge transfer
|If <code>ubercharge_ammo</code> is set, hitting any other medic with the weapon will transfer this much ubercharge % to them.
|Float
|WeaponBase
|-
|teleport instead of die
| On receiving fatal damage: x% chance of being immediately revived at spawn with 1 health.
|Float
|Player
|-
|mult dmg vs same class
|Damage vs same class multiplier
|Float
|WeaponBase
|-
|uber on damage taken
|On taking damage: x% chance of being ubercharged for 3 seconds
| Float
|Player
|-
|mult dmgtaken from melee
|Damage taken from melee multiplier
| Float
|Player
|-
| mult crit when health is below percent
|Gain crit boost when below this proportion of health. (e.g. 0.6 = 60%)
|Float
|BaseEntity
|-
|penetration damage penalty
|Multiplier applied to a bullet's damage after each successive player it penetrates. Can also be used as a damage bonus applied exponentially per player penetrated.
| Float
|WeaponBase
|-
| firing forward pull
|On all weapons, pulls the user forward with x velocity while firing the weapon. Limited by ground move speed cap.
Additionally on the flamethrower: applies "speed boost" condition while firing.
|Float
|WeaponBase/Flamethrower
|-
|mod soldier buff range
| Multiplier for Soldier's banner buff range. Base is 450 HU.
|Float
|Player
|-
|mult rocketjump deploy time
|Deploy speed bonus when rocket jumping
|Float
|WeaponBase
|-
|mul nonrocketjump attackrate
|Fire rate multiplier when not rocket jumping.
|Float
|BaseGun
|-
|aoe heal chance
|On hit: refire time * (x/60) % chance for aoe heal for 1s (24 hp healed total). use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
| crits on damage
| On hit: refire time * (x/60) % chance for crit boost for 3s. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
|stun on damage
|On hit: refire time * (x/60) % chance for stun for 3s. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
| Float
|WeaponBase
|-
|aoe blast on damage
| On hit: refire time * (x/60) % chance for 100 hu blast that stuns players for 2 seconds and applies bleed. use 60 for 100% chance on 1s refire time weapon, 600 for 0.1s
|Float
|WeaponBase
|-
| mult dmg with reduced health
| Multiplier applied to damage proportion that is multiplied by "player maximum health" / "player current health".
|Float
|BaseMelee
|-
|mult airblast refire time
|Multiplier applied to the cooldown after airblasting before you can either fire or alt-fire again.
|Float
|Flamethrower
|-
|mult airblast primary refire time
|Multiplier of how fast primary fire specifically can be used after airblasting.
Primary attack delay = this * refire_time * base
| Float
|Flamethrower
|-
|mod flamethrower spinup time
|Spin up time for flamethrowers in seconds
|Float
|Flamethrower
|-
| mult airblast cone scale
|Scales the cone used to push players by this amount.
|Float
|Flamethrower
|-
|airblast functionality flags
|Combination of flamethrower flags, used to limit airblast functionality. You have to add those numbers to enable specific functions (by default all are enabled):
1 - If airblast should push players

2 - If airblast can put out afterburn

4 - If airblast can reflect projectiles

8 - If airblast can stun players

16 - If airblast disrupts player aim
|Int
|Flamethrower
|-
|reverse airblast
|If the airblast can push players (see "airblast functionality flags"), airblast pushes players towards the pyro.
|0/1
|Flamethrower
|-
|airblast dashes
|Airblast pushes the pyro instead of enemies. Affected by airblast push force.
Flamethrowers with this attribute cannot reflect projectiles.
|0/1
|Flamethrower
|-
|mult sniper charge per sec with enemy under crosshair
|Sniper rifle charge rate when looking at the enemy. Still subject to the 200% charge rate limit
|Float
|SniperRifle
|-
|sniper beep with enemy under crosshair
|Plays <code>doomsday.warhead</code> sound when an enemy appears under your crosshair.
|0/1
|SniperRifle
|-
|medic machinery beam
|If set to 1, enables healing buildings as medic. increases building healing rate by 10% for each point
|Int
|Medigun
|-
|force distribute currency on death
|Bots with this attribute distribute their currency on death, like with sniper kills (red money)
|0/1
|MvMBot
|}

== Custom Attributes ==
These attributes are fully custom, implemented with modded logic.

{| class="wikitable sortable"
!Attribute Name
!Description
!Example Value
|-
|set turn to ice
|Turns the victim ragdoll to ice
|1
|-
|arrow mastery
|Lets the Huntsman shoot 2 additional arrows per level, 25 base damage each. Can headshot.
|1
|-
|ability doubletap teleport
|If set to 1, the player can move teleporters with double tapped movement keys. Does not work
|1
|-
|mod ignore resists absorbs
| A worse version of damage piercing since it only ignores the Battalion's Backup's 35% damage reduction. Does not work?
|1
|-
|mod projectile heat seek power
| The weapon's homing seek power, in degrees per second.
This attribute is '''required''' for the other "mod projectile heat" attributes to work!
|360
|-
| mod projectile heat aim error
|The weapon's max error in aim in degrees. If no target is within this degree, the projectile will not home.
|90
|-
|mod projectile heat aim time
|Time in seconds that the projectile is homing for
|1.75
|-
|mod projectile heat no predict target speed
|Disables movement prediction for homing projectiles. Might be useful for very slow projectiles.
|1
|-
|mod projectile heat follow crosshair
|Homing projectiles will follow the crosshair instead of enemies.
|1
|-
|mod projectile heat aim start time
|Time in seconds before the projectile starts homing.
|3
|-
|disable buildings on hit
|On building hit: Disable for x seconds
|4
|-
| regenerate stickbomb
|Regenerates Ullapool Caber after a hit.
| 1
|-
|mult smack time
|Melee "smack time" multiplier; time between pressing the fire button and the attack being dealt (0.2s default)
|4
|-
|custom item model
|Custom item model name
|models/model.mdl
|-
|custom weapon fire sound
| Custom weapon fire sound. Does not work for the weapon owner
|
|-
|explosive bullets
| Bullets explode in x radius on hit (147 is rocket launcher radius)
|100
|-
|mult projectile scale
| Projectile model scale multipier
|2
|-
| mult projectile count
|Fire x projectiles at once. Add "ignores other projectiles" 1 to Rocket Launchers so that rockets don't collide with each other.
|4
|-
| projectile trail particle
|Projectile trail particle name. Prefix the particle name with ~ to remove the original particle.
|
|-
|explosion particle
|Explosion particle name
|
|-
|radius sleeper
|Restores the Sydney Sleeper's old "Jarate explosion" on headshot and fully-charged bodyshot.
|1
|-
|cannot be sapped
|Bots with this attribute cannot be affected by the Sapper
|1
|-
|item color rgb
|Item tint color
|223424
|-
| is invisible
|Turns item invisible
| 1
|-
| cannot taunt
|If set to 1, cannot taunt
|1
|-
|projectile acceleration
|Projectile acceleration in hu/s^2
|500
|-
|projectile acceleration time
|TIme in seconds that the projectile should accelerate for
|2.55
|-
|projectile acceleration start time
|Time before projectile starts accelerating
|1
|-
|is miniboss
|The player is counted as a miniboss. Sappers will not fully stun, backstabs deal set damage, will not receive bomb buffs.
|1
|-
|model scale
| Player's model scale. 1.75 is used for giant bots.
|1
|-
|cannot upgrade
|If set to 1, the player cannot use upgrade stations
|1
|-
|min respawn time
|Minimal respawn time in seconds
|4
|-
|always crit
|Weapon always crits. Less reliable with higher ping.
|1
|-
|mult firerocket rate
|Level 3 Sentry rocket fire rate
| 1
|-
|building max level
|Building max level limit
|1
|-
|sentry rapid fire
|Allows for faster sentry fire rate, up to 66 shots per second. Effectively fixes sentry fire rate upgrades by not simulating it every 3 ticks, but every tick.
| 1
|-
|dont count damage towards crit rate
| Dealing damage with weapon does not increase crit rate
|1
|-
|reduced damage rampup
|Sets the weapon's maximum damage rampup to 20% (similar to Stickybomb Launchers)
|1
|-
|no reduced damage rampup
|Sets the weapon's maximum damage rampup to 50% (similar to Shotguns)
|1
|-
|force damage falloff
|Forces the weapon to have damage rampup and falloff
|1
|-
|can headshot
|Weapon can headshot. Hitscan only; inconsistent on multi-pellet weapons such as Shotguns.
|1
|-
|building color rgb
|Building tint color
|23424
|-
|building scale
|Building scale. Values above 1.17 make it difficult for players to build on uneven ground
|1.54
|-
|mult stun resistance
|Stun and slow multiplier. 0 to be fully stun/slow immune
| 0
|-
|allow friendly fire
| If set to 1, the player can deal friendly fire damage
|1
|-
|receive friendly fire
| If set to 1, the player can receive friendly fire from teammates
|1
|-
|mult dmg friendly fire
|Damage dealt to teammates multiplier. '''Requires''' "allow friendly fire" to be set to 1.
|0.4
|-
|cannot headshot
|Weapon cannot headshot
|1
|-
|mult crit dmg
|Crit damage multiplier
|1.54
|-
| cannot be headshot
|If set to 1, the player cannot be headshot. Only blocks hitscan headshots
|1
|-
|attachment name
| Use this model attachment instead of bonemerging. If the name is empty, it will follow player origin instead.
Common attachments for robot models: head, eye_1, flag. Some bot models also have eye_2, partyhat. Demo & Soldier additionally contain foot_L and foot_R

Common attachments for player models: head, eyes, flag, partyhat, bread_face, bread_head, effect_hand_L, effect_hand_R, bread_hand_r, bread_hand_l, bread_butt, bread_heel_l, foot_L, foot_R

This attribute is '''required''' to make other "attachment" attributes work!
|head
|-
|attachment offset
| Item offset from the attachment origin
|4 2 44
|-
|attachment angles
|Rotation for attached items
|25 25 0
|-
| attachment scale
|Model scale for attached items
|1.5
|-
|projectile gravity
|Projectile gravity in hu/s^2
|600
|-
| grenade explode on impact
|Grenades explode on impact with the world, similar to rockets
| 1
|-
|
projectile lifetime
|Projectile lifetime in seconds; deletes projectiles, does not cause explosions for explosive projectiles.
| 52
|-
|not solid to players
| The player is not solid to other players
|1
|-
|is suicide counter
|If set, the player takes this amount of damage per second, ignores uber, does not apply damage force
|1
|-
|always allow taunt
|Always allow the player to continue taunting, even midair. The player cannot start a taunt in midair, but their taunts will not be interrupted by being launched or falling off a bot.
|1
|-
|mult reflect velocity
| Reflected projectile speed multiplier
| 1
|-
|custom kill icon
|Use custom kill icon. Icons are defined in scripts/mod_textures.txt in tf_misc_dir.vpk
|armageddon
|-
| cannot be upgraded
|If set to 1, the weapon cannot be upgraded, but the player can still use the upgrade station
|1
|-
|projectile no deflect
|Projectile cannot be deflected (such as by miniguns) or reflected (such as by flamethrowers). Short Circuit orb will still delete the projectile.
| 1
|-
| player gravity ballon head
|Player gravity multiplier when affected by the balloon head condition (TF_COND_BALLOON_HEAD). 0 is for regular gravity
|12
|-
| mult dmg vs giants
|Damage multiplier vs giants
|2.5
|-
| mult dmg vs tanks
| Damage multiplier vs tanks
|2.5
|-
| mult dmg vs npc
|Damage multiplier vs npc - including Halloween bosses and tanks, excluding player bots
| 2.5
|-
| custom hit sound
|Custom sound played when an enemy is hit with the weapon
|fdfdf
|-
| custom impact sound
|Custom sound played when a rocket / projectile / bullet hits something
|fdfdf
|-
|custom weapon reload sound
|Custom weapon reload sound
|fdfdf
|-
|no explosion particles
| No explosion particles and sounds
|1
|-
| override projectile type extra
|Special version of override projectile type that adds more projectile types:
{| class="wikitable sortable mw-collapsible mw-collapsed" style="margin: 0 auto; width: 100%; padding: 0;"
! colspan="1" |Possible values
|-
|
* "mechanicalarmorb" - Short circuit orb

* "stunball" - Sandman ball

* "ornament" - Wrap Assassin projectile
*"jarate"
*"madmilk"
*"cleaver"
*"gas"
*"brick" - Uses bread model. Deals 40 damage on hit.
*"repel"
*"breadmonster"
*"spellfireball" - Fireball spell. ''Only this spells will trigger ShootTemplate blocks; others will not!''
*"spelllightningorb"
*"spellkartorb" - Explosive KGB Glove from the Carnival of Carnage kart minigames.
*"spellbats"
*"spellmirv" - Pumpkin bombs, only works if the owner has spellbook equipped
*"spelltransposeteleport"
*"spellmeteorshower"
*"spellspawnboss" - Summons spectral MONOCULUS.
*"spellspawnhorde" - Summon skeletons, only works if the owner has spellbook equipped
|}
|mechanicalarmorb
|-
|dmg current health
|Deal additional damage; x * target's current health.
|0.34
|-
|dmg max health
|Deal additional damage; x * target's max health
|0.34
|-
|dmg missing health
|Deal additional damage; x * target's missing health
|0.34
|-
| cannot be teleported
|If set to 1, the player cannot be teleported
|1
|-
| mult medigun range
|Medigun range multiplier
|1.5
|-
|projectile penetration limit
|Penetration limit for projectiles
|3
|-
| max aoe targets
|Max targets affected by explosives and flamethrowers
|4
|-
|effect cond override
|Effect condition override on drinks, jars, medigun ubercharges, and many other effect-causing weapons
| 24
|-
|add cond on hit
|Adds condition to the target on hit. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536.
|56
|-
|add cond on hit duration
|Add condtion on hit duration
|4
|-
| remove cond on hit
|Remove condtion from target on hit. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536.
| 57
|-
| self add cond on hit
|Adds condition to self when hitting a target
|54
|-
|self add cond on hit duration
| Duration of the condition added to self when hitting a target. Requires "self add cond on hit".
|3
|-
|add cond on kill
|Adds condition to self when killing a target
|57
|-
|add cond on kill duration
|Duration of the condition added to self when killing a target. Requires "add cond on kill".
|10
|-
|add cond when active
|Add condition when weapon is active. To provide a second condition, multiply it by 256. To provide a third condition, multiply it by 65536
|11
|-
|add damage type
|Add damage type to the attack. See [https://developer.valvesoftware.com/wiki/Half-Life_2/Damage_types here] for a list of damage types.
|1
|-
|remove damage type
|Remove damage type from the attack
|1
|-
|special damage type
| Sets a special damage type to a range from 1-3, to interact with the attributes listed below. Has no effect otherwise.
|1
|-
|dmg taken mult from special damage type 1
|
Damage taken multiplier from weapons with special damage type 1
|4
|-
|dmg taken mult from special damage type 2
|Damage taken multiplier from weapons with special damage type 2
|4
|-
|dmg taken mult from special damage type 3
|Damage taken multiplier from weapons with special damage type 3
|4
|-
|mult effect duration
|Effect duration multiplier on drinks and jars (Crit-a-Cola, Jarate, etc.)
|3
|-
|special item description
|Shows text as an attribute if the weapon is inspected or shown as a custom weapon.

|item description
|-
|mult flag carrier move speed
|Flag carrier move speed multiplier
|0.66
|-
|overheal from heal on kill
|If set to 1 and the weapon heals on kill, it can provide overheal
|1
|-
| fire input on hit
|Fire an input on hit targets. The player with the attribute is considered the !activator, the target hit is considered the !self. The format is <target>^<input>^<param>. If omitted, default param is damage received
|!self^SetHealth^0
|-
|fire input on hit name restrict
|Restrict input on hit to the specified targetname or classname. Wildcards are allowed.
|player
|-
|grenade bounce speed
|Grenades bounce off walls, retaining x% of speed after each bounce. Also works on arrows.
| 0.8
|-
|grenade bounce speed xy
|Grenade bounce speed in xy direction multiplier
|2
|-
|grenade bounce damage
|Grenades explode on direct hits even if the grenade already touched a wall, dealing x% additional damage. Values below 1 will make the grenade deal less damage.
|0.3
|-
|reset arrow hits on bounce
|If set to 1 on the Huntsman, when the arrow bounces, allow it to hit the same target again. Requires "grenade bounce speed" or "arrow target bounce speed"
|1
|-
|arrow target bounce speed
|Proj+ectiles bounce off hit targets, retaining x% of speed after each bounce.
|1
|-
|projectile gravity native
|
Gravity for arrows and flares. 0 is default gravity. For grenades and stickybombs, any value will disable gravity
|0.4
|-
|grenade no drag
|No drag for grenades and stickybombs, slightly changes projectile arc.
|
1
|-
|stickybomb stick to enemies
|Stickybombs can stick to enemies on hit. If already stuck to the world, they will not get stuck on players.
|1
|-
|stickybomb no stick
|Stickybombs do not stick to ground
|1
|-
|collect currency on kill
|Bots killed by the weapon distribute their currency, like with sniper kills (red money)
|1
|-
|stomp player damage
|Damage applied to enemies when touching them
|100
|-
|stomp player time
|Time between each instance of stomp damage and push. By default, it happens every tick
|0.1
|-
|stomp player force
|Force applied to enemies when touching them. 260 is the minimum amount to knock players up.
|270
|-
|stomp building damage
|Damage dealt to enemy buildings on touch
|125
|-
|reflect keep team
|Projectiles reflected by this weapon keep their original team

|1
|-
| custom wind up sound
|Custom minigun wind up sound. Does not override default sound
|sound.wav
|-
| custom wind down sound
|Custom minigun wind down sound. Does not override default sound
|sound.wav
|-
|custom minigun spin sound
|Custom minigun spin sound. The sound will not loop unless its made to loop
|sound.wav
|-
|reflect magnet
|If set to 1, reflected projectiles aim towards the reflector
|1
|-
|stay after regenerate
|If set to 1, the weapon will stay after touching a resupply cabinet or upgrading, if the weapon in the inventory in the slot is different
|1
|-
|arrow hit kill time
|If set to any value other than 0, sets custom arrow kill time after hitting something
|0.3
|-
|custom projectile size
|Custom projectile hitbox size
|30
|-
|mod sentry cost
|Sentry cost multiplier
|1.25
|-
| mod dispenser cost
| Dispenser cost multiplier
|1.25
|-
|penetrate teammates
|Bullets and projectiles penetrate teammates, like sniper rifles.
| 1
|-
|mult step height
|Step height multiplier (x * 18hu); allows the player to not need to jump for greater heights
|10
|-
|ignore player clip
|Ignore player clip brushes
|1
|-
|allow bunny hop
|Allow bunny hopping. 1 - auto bhop. 2 - manual bhop
|1
|-
|fire input on kill
| Fire input on killed targets. The player with the attribute is considered the !activator, the target killed is considered the !self. The format is <target>^<input>^<param>. If omitted, default param is damage received. !projectile is the projectile entity
|!self^SetHealth^0
|-
|fire input on kill name restrict
|Restrict input on kill to specified targetname. Wildcards are allowed

|player
|-
|fire full clip at once
|Fire the weapon's entire clip at once
|1
|-
|reload full clip at once
|Reload full clip at once, like pistols
|1
|-
|force fire full clip
| Automatically fire full clip, one shot at a time. Not to be confused with "fire full clip at once".
|1
|-
|projectile sound
| Sound played when the projectile is fired
|sound.wav
|-
|burst fire count
|Fire this many rounds in a burst. If negative, forces to fire this many rounds even if attack button is only pressed once
|3
|-
|burst fire rate mult
|Fire rate multiplier between bursts. Regular fire rate is used for the time between shots in a burst.
|2
|-
|continous accuracy mult
|Accuracy multiplier, continous attacking increases/decreases accuracy up to specified value over the duration of "continous accuracy time" attribute. Overwrites "spread penalty" attribute
|3
|-
|continous accuracy time
|How long in seconds should the weapon be fired continously to reach full "continous accuracy mult" value
|1
|-
|duck accuracy mult
|Accuracy multiplier when ducking. Overwrites "spread penalty" attribute
|0.5
|-
|move accuracy mult
|Accuracy multiplier when moving. Overwrites "spread penalty" attribute
|2
|-
|special item description 2
|Additional item description line
|description
|-
|special item description 3
|Additional item description line
|description
|-
|special item description 4
|Additional item description line
|description
|-
|allowed build types
| Allowed building types, add values together to allow multiple buildings:
1 - dispenser

2 - teleporter

4 - sentry gun

8 - sapper
|6
|-
|max bullet range
|Max bullet range in hu
|10
|-
|effect add attributes
|Make weapons that apply addcond effects, such as banners, jars, etc., also apply attributes to the affected player
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|medigun passive attributes
|Attributes added passively to the patient being healed
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|medigun passive attributes owner
|Attributes added passively to the healing medic
|<nowiki>move speed bonus|2|fire rate bonus|0.1</nowiki>
|-
|mult dmg vs airborne
|Damage multiplier vs airborne players
|3
|-
|revive rate
|Medigun revive speed multiplier
|10
|-
|taunt attack after end
|Taunt attack happens even after taunt ends or is interrupted
|1
|-
|taunt attack time mult
|Taunt attack time multiplier, making it happen earlier/later
|2
|-
|damage returns as health
|Returns x * damage dealt as health
|0.5
|-
|no resupply
|Cannot resupply from cabinets
|1
|-
|no damage view flinch
|No view flinch from taking damage
|1
|-
|disable wrangler shield
|If set to 1, the Wrangler's sentry shield is disabled
|1
|-
|parachute redeploy
|Allow infinite mid-air parachute redeploying
|1
|-
|mult duck speed
|Ducking speed multiplier. 3 is for walking speed. Cannot be faster than walking speed
|3
|-
|particle color rgb
|RGB color for projectile particles that support it (Bison, Pomson)
|765776
|-
|particle color rainbow
|Cycles colors for the projectile particle. Higher values cycle faster
|100
|-
|ignored by enemy sentries
|If set to 1, enemy sentries ignore the player
|1
|-
|melee airblast
|If set to 1 on a melee weapon, its attacks will reflect projectiles
|1
|-
|passive reload
|Automatically reloads the weapon while not active. Since the reload speed is tied to animations this will make weapons reload faster than usual
|1
|-
|kb fall min velocity
|Knockback, stun and damage nearby enemies when landing. The value specifies the minimum fall velocity before applying knockback. This attribute is '''required''' for the other "kb fall" attributes to work!
|300
|-
|kb fall radius
|The radius of the fall knockback. 230 by default
|230
|-
|kb fall stun time
|Small robot stun time of the fall knockback. 5 by default
|5
|-
|kb fall force
|Fall knockback force. 300 by default
|300
|-
|kb fall damage
|Fall knockback damage. 50 by default
|50
|-
|melee grants protection
|Melee attacks grant protection from attacks for x seconds
|0.6
|-
|arrow snap to next target radius
|If set on the Huntsman, snaps the arrow to the next closest available target within range
|1000
|-
|mult credit collect range
|Credit collection radius multiplier. Scouts have a 4x bigger collection radius
|2
|-
|health from credits
|Additional health gained from collecting credits. Scouts usually gain 50 health on collecting credits
|50
|-
|mult bleeding delay
|Delay between bleeding damage multiplier. Lower values causes bleed damage to happen more times per second.
|2
|-
|mult bleeding dmg
|Bleeding damage multiplier
|2
|-
|not solid
|If set to 1, the player can phase though walls
|1
|-
|dmg taken from self reduced
|Self damage multiplier for the player
|0.5
|-
|ignored by bots
|If set to 1, the player is ignored by bots.
|1
|-
|add attributes on hit
|<nowiki>Apply attributes to victim on hit with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|self add attributes on hit
|<nowiki>Apply attributes to self on hit with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|add attributes on kill
|<nowiki>Apply attributes to self on kill with the weapon. Format: attribute|value|duration ...</nowiki>
|<nowiki>move speed bonus|0.3|2|head scale|3|2</nowiki>
|-
|move speed as health decreases
|Multiply move speed up to x with decreasing health
|2
|-
|no self effect
|If set to 1, the weapon cannot ignite or cause bleeding to the wielder
|1
|-
|cannot pickup spells
|Cannot pickup spells
|1
|-
|mult max health
|Max health multiplier
|2
|-
|add spread
|Bullet spread additive. Does not affect clientside effects
|1
|-
|projectile spread angle mult
|Projectile spread angle multiplier
|3
|-
|always allow disguise
|Always allow the spy to disguise
|1
|-
|always allow cloak
|Always allow the spy to cloak
|1
|-
|always allow teleport
|Always allow the player to teleport
|1
|-
|destroy buildings on death
|Destroy owned buildings on death
|1
|-
|sentry bullet weapon
|Sentry bullet weapon name. Can be a custom weapon name
|TF_WEAPON_ROCKETLAUNCHER
|-
|sentry rocket weapon
|Sentry rocket weapon name. Can be a custom weapon name
|TF_WEAPON_ROCKETLAUNCHER
|-
|custom sentry model
|Custom sentry model file name or prefix
|models/buildables/sentry
|-
|custom dispenser model
|Custom dispenser model file name or prefix
|models/buildables/dispenser
|-
|custom teleporter model
|Custom teleporter model file name or prefix
|models/buildables/teleporter
|-
|mult sentry rocket ammo
|Sentry rocket ammo multiplier
|3
|-
|midair accuracy mult
|Midair accuracy multiplier
|2
|-
|add damage per target
|Damage bonus for every target hit by explosion
|0.5
|-
|projectile detonate time
|Projectile self detonation time in seconds
|0.5
|-
|mult afterburn delay
|Multiplier for the delay between afterburn damage ticks, similar to "mult bleeding delay". Lower values result in more damage per second.
|2
|-
|custom view model
|Custom view model. This typically affects first person hands and their animations
|models/model.mdl
|-
|mult dmg while midair
|Damage multiplier while midair
|0.5
|-
|hidden string attribute 1
|Attribute for storing hidden text in items. 1-4 numbers are available
|abc
|-
|medigun keep charged effect
|Keep custom medigun uber effect after the beam is disconnected until the uber meter runs out
|1
|-
|ignores other projectiles
|Don't collide with other projectiles
|1
|-
|weapon always gib
|This weapon always gibs killed enemies
|1
|-
|weapon never gib
|This weapon never gibs killed enemies
|1
|-
|always gib
|Always gib on death
|1
|-
|never gib
|Never gib on death
|1
|-
|sapper sap allies
|Sap ally players instead of enemies
|1
|-
|custom sapper model
|Custom sapper model; accept either a prefix or full model path
|models/buildables/sd_sapper
|-
|custom sapper sound
|Custom sapper sound. See example value.
|Weapon_Sapper.Timer
|-
|no clip
|Give noclip. 1 for regular player speed, use any other value to override
|1
|-
|arrow ignite
|If set to 1 on the Huntsman, automatically ignites arrows
|1
|-
|use original class weapon animations
|Use weapon animations of the weapon's original class if the weapon is given to an unintended class
|1
|-
|mult dmg before distance
|Deals up to x damage depending on distance (2048 hu by default)
|2
|-
|mult dmg before distance specify
|Custom distance for "mult dmg before distance"
|1000
|-
|minigun full movement
|Can move while ducking when shooting. Bots can also jump
|1
|-
|use original class player animations
|Use player animations of the weapon's original class if the weapon is given to an unintended class
|1
|-
|mult sentry rocket projectile speed
|Sentry rocket projectile speed multiplier
|2
|-
|crit on cond
|Critical hit when the enemy has specified cond
|13
|-
|minicrit on cond
|Mini crit hit when the enemy has specified cond
|13
|-
|add attributes when active
|Add attributes when the weapon is active
|<nowiki>move speed bonus|2|damage bonus|2</nowiki>
|-
|radial cond
|Add conditions and attributes on hit in a radius
|400
|-
|mult explosion radius direct hit
|Explosion radius multiplier on direct hit
|2
|-
|buildings cannot be sapped
|Buldings cannot be sapped
|1
|-
|mult dmg direct hit
|Damage multiplier on direct hit
|2
|-
|explosion particle on direct hit
|Explosion particle on direct hit
|particle
|-
|cannot upgrade bomb
|Bomb cannot be upgraded
|1
|-
|sentry toolbox model
|Custom carried by player sentry toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|dispenser toolbox model
|Custom carried by player dispenser toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|teleporter toolbox model
|Custom carried by player teleporter toolbox model
|models/weapons/c_models/c_toolbox/c_toolbox.mdl
|-
|medigun attack enemy
|Can attack enemies, dealing damage equal to % heal rate
|1.1
|-
|medigun self drain
|Drain health equal to % heal rate from the user when healin
|0.6
|-
|fire input on attack
|Fire input on attack. Player is !activator, projectile is !projectile (must be input target), weapon is !self
|!activator^SetHealth^0
|-
|stun on hit
|Stun target on hit duration
|4
|-
|stun on hit no giants
|Giant robots cannot be stunned
|1
|-
|stun on hit type
|Stun on hit type:
movement
panic
bonk
ghost
bigbonk
|movement
|-
|stun on hit slow
|Movement penalty applied with "movement" stun on hit type
|0.4
|-
|medigun attack enemy heal mult
|Multiplier of health gained from attacking enemies
|3
|-
|medigun particle
|Medigun custom particle. Automatically uses _red and _blue particles when not specified. Sometimes ~ has to be added so that the particle disappears when needed
|passtime_beam
|-
|medigun particle enemy
|Medigun custom particle when attacking enemies. Sometimes ~ has to be added so that the particle disappears when needed
|~dxhr_arm_muzzleflash2
|-
|medigun particle release
|Medigun custom particle when uber is released. Sometimes ~ has to be added so that the particle disappears when needed
|~dxhr_arm_muzzleflash2
|-
|medigun particle spark
|Medigun custom particle for full charge sparks
|medicgun_invulnstatus_fullcharge
|-
|effect immunity
|Immune to effects applied by other players
|1
|-
|use robot voice
|Use robot voicelines
|1
|-
|use human voice
|Use human voicelines
|1
|-
|alt fire attack
|Alt fire fires an attack. Value higher than 1 specifies fire rate multipler when using secondary attack
|1
|-
|alt fire attributes
|Attributes to apply when alt fire button is pressed
|<nowiki>fire rate bonus|2|damage bonus|2</nowiki>
|-
|no revive
|No revive marker on death
|1
|-
|fire input on effect
|Fire input when an addcond effect is applied by this weapon. Provider is !activator. The receiver is !caller
|!activator^SetHealth^0
|-
|additional step sound
|Additional step sound
|MVM.BotStep
|-
|fov override
|Field of view override. Sniper rifles reset this
|33
|-
|hud overlay
|Overlay material
|effects/jarate_overlay
|-
|fire input on taunt
|Fire input when taunting
|!activator^SetHealth^0
|-
|displace touched enemies
|Move enemies out of the way. Deal x damage per tick to stuck enemies
|1
|-
|addcond immunity
|<nowiki>Immune to specific addconds, separated by |</nowiki>
|<nowiki>1|3</nowiki>
|-
|attribute immunity
|<nowiki>Player immune to specific attributes, separated by |</nowiki>
|<nowiki>move speed bonus|damage bonus</nowiki>
|-
|hold fire until full reload
|Hold fire until full reload. Set to 2 to disable weapon switch if weapon is not fully loaded, even if not currently reloading
|1
|-
|projectile hit radius
|Projectile hit radius for damageable entities only
|100
|-
|noclip projectiles
|Projectiles penetrate walls. Cannot hit anything unless "projectile hit radius" is set
|1
|-
|projectile health
|Projectiles have specified amount of health. Not every projectile is compatible, the owner cannot shoot his own non grenade projectiles. "custom projectile size" might be required to hit some projectiles with bullets
|100
|-
|projectile take damage type
|Damage taken by projectile restrictions:
0 - no restrictions

1 - only owner can damage

2 - own team only

3 - enemies only
|1
|-
|projectile take damage time
|Time in seconds before projectile can take damage
|0.25
|-
|projectile explode on destroy
|Projectiles explode when destroyed. Can be one of those values:
0 - do not explode
1 - explode
2 - explode, the damage belongs to the attacker
3 - explode only if destroyed by the same team
|1
|-
|projectile explode time
|Projectiles detonate after delay in seconds
|1
|-
|shoot view punch angle
|View punch angle when shooting
| -3 0 0
|-
|shoot view punch angle random
|View punch angle random variance when shooting
|3 0 0
|-
|custom item model attachment
|<nowiki>Custom additional item models, parameters in order: model path, player attachment name (leave empty for bonemerge, type "none" for no attachment), R G B color (leave empty for normal), offset, rotation, scale. Offset, rotation, scale only works if attachment name is not empty. Separate attachments with |</nowiki>
|<nowiki>models/model.mdl,,33 55 99|models/model.mdl,effect_hand_R,,4 2 0,0 270 90,1.5</nowiki>
|-
|custom item model attachment 2
|Additional item model attribute
|models/model.mdl,none,255 255 0,0 0 100,0 0 0,1.5
|-
|custom item model attachment 3
|Additional item model attribute
|
|-
|custom item model attachment viewmodel
|<nowiki>Custom additional item models in view model, parameters in order: model path, offset, rotation, scale. Offset, rotation, scale detach the model from main view model. Separate attachments with |</nowiki>
|<nowiki>models/model.mdl|models/model.mdl,4 2 0,0 270 90,1.5</nowiki>
|-
|custom item model attachment viewmodel 2
|Additional item model attribute in view model
|models/model.mdl,0 0 100,0 0 0,1.5
|-
|custom item model attachment viewmodel 3
|Additional item model attribute in view model
|
|-
|custom weapon deploy sound
|Custom deploy sound
|sound.wav
|-
|spread angle pattern
|Spread angle (pitch, yaw, roll) pattern, the pattern cycles with each projectile fired
|<nowiki>10 0 0|0 0 0|-10 0 0</nowiki>
|-
|spread offset pattern
|Spread offset (front, left, up) pattern, the pattern cycles with each projectile fired
|<nowiki>0 10 0|0 0 0|0 -10 0</nowiki>
|-
|proj attribute pattern
|<nowiki>Attribute pattern, cycles with each projectile fired. Attributes separated with |, cycles separated with &</nowiki>
|<nowiki>projectile speed increased|2|damage bonus|0.5&projectile speed decreased|0.5</nowiki>
|-
|shoot pattern reset time
|Reset the pattern this many seconds after last attack. By default, pattern is reset as soon as the player stops firing
|1
|-
|shoot pattern no rollback
|Set to 1 to not rollback the pattern when reaching the last cycle
|1
|-
|custom damage type override
|Change custom damage type to something else. Usually it only changes kill icon but sometimes it applies some effects. Available custom damage types: https://developer.valvesoftware.com/wiki/Team_Fortress_2/Scripting/Script_Functions/Constants#ETFDmgCustom
|47
|-
|flare no crit burning
|Disable crit on burning players for flares
|1
|-
|rage receive scale
|Scale for damage being received
|2
|-
|fire input on hit ally
|Fire input on hit allied players. May require allow friendly fire to work. The player is the activator. The format is <target>^<input>^<param>. If omitted, default param is damage received. !projectile is the projectile entity
|!self^SetHealth^0
|}
[[Category:Misc Additions]]

TFBot

2026-07-20T20:16:22Z

ABadHaiku: Move AddCond out of Periodic Tasks block, as it only implements a SUBSET of the keyvalues.

Listed below are all of the custom keyvalues accepted in the '''TFBot{}''' block by our server mods. Examples of these additions can be found in the [https://testing.potato.tf/mvm_bigrock_sigdemo.pop demonstrative SigMod popfile].

= Periodic Tasks =
The blocks in this section are actions that can occur multiple times, using either a delay or condition for activating them. The keyvalues here can be used to configure any of these "periodic tasks":<syntaxhighlight>
Delay 10 //Time before the task starts (Default: 10)
Cooldown 1 //Time between each execution of the task (Default: 10)
Repeats 1 //How many times the bot should perform the task in total (Default: 0 - Infinite)
IfSeeTarget 1 //When set to 1, this task activates only when the bot can see a target (Default: 0 - Always activate)
IfNoTarget 1 //When set to 1, this task activates only when the bot does not have a target (Default: 0 - Always activate)
IfHealthBelow 100 //When set, the task activates only when the bot health is below specified value
IfHealthAbove 100 //When set, the task activates only when the bot health is above specified value
MaxTargetRange 150 //If set, the task activates only when the target is within specified units away
MinTargetRange 50 //If set, the task activates only when the target is more than specified units away
IfLeftSpawn 1 //If set, the task activates only after the target has left its spawn.
</syntaxhighlight>

== SpawnTemplate ==
<syntaxhighlight>
SpawnTemplate [$SIGSEGV] //Spawn custom player template
{
Name "Sentry"
Bone "bip_head" //Bone name where the template should be attached to
//Some bone names are listed here:
//bip_head
//bip_spine_2 - used by flag
//bip_hand_L
//bip_hand_R
//weapon_bone_R
//weapon_bone_L
//bip_foot_L
//bip_foot_R
}

</syntaxhighlight>Allows you to spawn [https://steamcommunity.com/sharedfiles/filedetails/?id=2289315026 PointTemplates], which will automatically be parented on the bot this block is on. Does <u>not</u> support global keyvalues. Bone names can also be found using HLMV, which is available by default in your Team Fortress 2/bin folder (which is "above" your tf/ folder).

== Taunt ==
<syntaxhighlight>
Taunt [$SIGSEGV] //Taunt periodically
{
Duration 5 //Duration of a looping taunt (Default: 0.1)
Name "Taunt: Kazotsky Kick" //If set, uses this item taunt instead of default
}

</syntaxhighlight>Note that "Name" requires the ''name of the item that you equip to use the taunt''. This name can be found in <code>items_game.txt</code>, with most newer taunts being prefixed with "Taunt: ", or having "Taunt" elsewhere in their name. Weapon-specific taunts can only be done if the bot is currently holding that weapon.

== Voice Command ==
<syntaxhighlight>
VoiceCommand [$SIGSEGV] //Periodically uses voice commands
{
Type "Medic" //Type of voice command. Possible values:
//Medic
//Help
//Go
//Move up
//Left
//Right
//Yes
//No
//Activate Charge
//Charge Ready
//Incoming
//Spy
//Thanks
//Jeers
//Battle cry
//Cheers
//Sentry here
//Dispenser here
//Teleporter here
//Good job
//Sentry ahead
//Positive
//Negative
//Nice shot
}

</syntaxhighlight>

== ChangeAttributes ==
<syntaxhighlight>
ChangeAttributes [$SIGSEGV] //Periodically changes bot attributes, defined in EventChangeAttributes{}
{
Name "Attr1" //Name of the bot attributes block listed in EventChangeAttributes{}
}

</syntaxhighlight>Note that bots will automatically start out in any attributes block named "Default". Maps with a gate will force bots to change to their "RevertGateBotsBehavior" block, if they have one.

== ClientCommand ==
<syntaxhighlight>
ClientCommand [$SIGSEGV] // Executes client commands, also known as console commands
{
Name "build 0" // Name of the client command, notable examples:
// "build 0/1/2/3" - Build dispenser / teleporter entrance / sentry / teleporter exit
// "destroy 0/1/2/3" - Destroy dispenser / teleporter entrance / sentry / teleporter exit
}

</syntaxhighlight>
== FireWeapon ==
<syntaxhighlight>
FireWeapon [$SIGSEGV] //Periodically fires weapon
{
Duration 0.5 //How long should the button be pressed (Default: 0.1)
Type "Secondary" // Type of fire input, Possible values:
//Primary
//Secondary
//Special - MOUSE3
//Reload
//Jump
//Crouch - requires NoCrouchButtonRelease 1 in TFBot
//Action
}

</syntaxhighlight>A FireWeapon{} block with <code>Type "Action"</code> can be paired with <code>ExtAttr SuppressCanteenUse</code> to time canteen usage.

A FireWeapon{} block with <code>Type "Primary"</code> can be paired with <code>Attributes SuppressFire</code> to control when a bot attacks.

== FireInput ==
<syntaxhighlight>
FireInput [$SIGSEGV] // Fires an input to an entity. Target !self and !activator refer to target the bot this block is on.
{
Target "random_color_case*" //Entity name to use
Action "PickRandom" //Input to fire
Param "" //Parameter to use
}

</syntaxhighlight>Keep in mind that <code>Repeats</code> defaults to 0, infinite. Specify it as 1 to only fire an input once. The bot will be considered the !activator.

== Add- & RemoveAttribute ==
<syntaxhighlight>
AddAttribute [$SIGSEGV]
{
Item "TF_WEAPON_KNIFE" // Item name to which add the attribute, or Player for player attribute, or Active for active weapon
Name "damage bonus" // Attribute name
Value 2 // Attribute value
}
RemoveAttribute [$SIGSEGV]
{
Item "TF_WEAPON_KNIFE" // Item name from which remove the attribute, or Player for player attribute, or Active for active weapon
Name "damage bonus" // Attribute name
}

</syntaxhighlight>If multiple attributes should be added or removed at once, it may be preferable to use <code>EventChangeAttributes{}</code> with <code>ChangeAttributes{}</code> instead.

== Message ==
<syntaxhighlight>
Message //Displays message in the chat
{
Name "{red}Hello!" //Message in the chat displayed
}

</syntaxhighlight>Text colour can also accept hex codes without #, such as <code>FF0000</code> for red.

== Sequence ==
<syntaxhighlight>
Sequence [$SIGSEGV] // Display a sequence animation with a name. Not every animation is supported
{
Name "Run_MELEE" // Name of the sequence
}

</syntaxhighlight>Sequence names can be found using HLMV, which is available by default in your Team Fortress 2/bin folder (which is "above" your tf/ folder), or in the Hammer++ Model Browser tool.

== WeaponSwitch ==
<syntaxhighlight>
WeaponSwitch [$SIGSEGV] //Periodically switches weapon
{
Type "Primary" // Weapon slot, possible values:
//Primary
//Secondary
//Melee
//PDA
//Building
}
</syntaxhighlight>

= Non-Periodic =

== AddCond ==
<syntaxhighlight>
AddCond [$SIGSEGV] //Adds conditions to bots
{
Name "TF_COND_REPROGRAMMED" // Condition to apply.
//Index 43 //Condition index can be used instead
Delay 3 // Delay before the condition activates (Default: 0)
Duration 99 // Duration of the condition effect (Default: -1 - infinite duration)
IfHealthBelow 100 //When set, the condition is applied only when the bot health is below specified value
IfHealthAbove 100 //When set, the condition is applied only when the bot health is above specified value
IfLeftSpawn 1 //If set to 1, the condition is applied only after the target has left its spawn.
}
</syntaxhighlight>Note that the default Delay value is 0.

Available condition values and names can be found on the [https://wiki.teamfortress.com/wiki/Cheats#addcond TF2 wiki].

To note: this is not a periodic task. Only these keyvalues will be recognized.

== WeaponResist ==
<syntaxhighlight>
WeaponResist [$SIGSEGV] //Multiplies damage received from weapons listed below
{
"TF_WEAPON_KNIFE" 0.1
"TF_WEAPON_MINIGUN" 10
}

</syntaxhighlight>Accepts both weapon classnames (such as <code>tf_weapon_flamethrower</code>applying to all regular flamethrowers) and individual weapon names.

== ExtAttr ==

Extra Attributes that can be applied to bots, akin to the vanilla Attributes keyvalue.<syntaxhighlight>
// Aim behavior.
MedicLookAtThreats //If the bot is a Medic: can turn around to look at threats
TargetStickies //Target and destroy stickies
IgnoreBuildings //Ignore buildings
IgnorePlayers //Ignore players (including bots)
IgnoreBots //Ignore bots
IgnoreRealPlayers //Ignore non-bot players
IgnoreNPC //Ignore NPCs such as Tanks, skeletons, and halloween bosses

// Attacking behavior.
AlwaysFireWeaponAlt //Always use secondary fire
SuppressCanteenUse //If set, the bot will not automatically activate canteens when looking at an enemy
JumpStomp //Try to jump over and stomp obstracles

// Engineer-only.
BuildDispenserAsTeleporter //Builds dispenser instead of teleporter
BuildDispenserAsSentryGun //Builds dispenser instead of sentry gun

// Misc.
DisableSpawnProtectionFix //Disables a fix where a medic activating ubercharge inside spawn will not be invulnerable when exiting spawn
</syntaxhighlight>

== Homing Rockets ==
<syntaxhighlight>
HomingRockets [$SIGSEGV]
{
IgnoreDisguisedSpies 1 //Ignore Spies that are disguised?
IgnoreStealthedSpies 1 //Ignore Spies that are cloaked?
RocketSpeed 0.25 //Multiplier of rocket speed. 1 for default speed
TurnPower 90 //How fast should the rocket rotate to face the target
MaxAimError 360 //Max angle between rocket and the target
}

</syntaxhighlight>Allows rockets (''but no other projectiles'') to home in on enemies. For making most projectiles home in on enemies, use the "mod projectile heat" set of [[List of custom attributes|custom attributes]].

== Action ==
A defunct keyvalue in vanilla. Works correctly on servers with our mods.<syntaxhighlight>
Action FetchFlag [$SIGSEGV] //Overrides default bot AI. Possible values:
//Default - Default action
//FetchFlag - Uses generic bomb fetching AI, default action for most bots except Spy, Medic, Engineer or Mission bots
//EscortFlag - As above, but ignores bot escort limit
//PushToCapturePoint - Pushes to capture point (or hatch in MvM). Similar to BehaviorModfiers Push and its aliases.
//Mobber - Chases down random player targets
//Spy - Uses spy AI, teleports behind players, but does not use disguises or cloak.
//Sniper - Uses mission sniper AI
//SuicideBomber - Uses sentry buster AI, but targets players instead. Might crash servers
//Idle - Sit in spawn and wait
//Passive - Sit at spawn position, until an active threat is in vision
//Medic - Use medic AI

</syntaxhighlight>

== Custom weapon model ==
<syntaxhighlight>
CustomWeaponModel [$SIGSEGV] //Sets custom weapon model
{
Slot 1 //Valid loadout positions:
//0 - LOADOUT_POSITION_PRIMARY
//1 - LOADOUT_POSITION_SECONDARY
//2 - LOADOUT_POSITION_MELEE
//3 - LOADOUT_POSITION_UTILITY
//4 - LOADOUT_POSITION_BUILDING
//5 - LOADOUT_POSITION_PDA
//6 - LOADOUT_POSITION_PDA2
Model "models/weapons/w_models/w_minigun.mdl"
}

</syntaxhighlight>Alternatively, use "custom item model" as a [[List of custom attributes|custom attribute]]. The model has to be precached if it isn't part of the current map. Double-check this if you end up with ERROR models.

== ItemColor ==
<syntaxhighlight>
ItemColor [$SIGSEGV] //Set item color
{
ItemName "The Gunboats"
Red 255
Green 0
Blue 0
}
</syntaxhighlight>

== DamageAppliesCond ==
<syntaxhighlight>
DamageAppliesCond [$SIGSEGV] //Adds conditions to players on hit
{
Name "TF_COND_URINE" // Condition to apply.
//Index 43 //Condition index can be used instead
Duration 3 // Duration of the condition effect (Default: -1 - infinite duration)
}

</syntaxhighlight>Available condition values and names can be found on the [https://wiki.teamfortress.com/wiki/Cheats#addcond TF2 wiki]. Alternatively, use the "add cond on hit" set of [[List of custom attributes|custom attributes]], which can be specified per weapon.

== Stripping items ==
<syntaxhighlight>
StripItemSlot 1 [$SIGSEGV] //If set, weapon in specified slot is stripped
//Valid loadout positions:
//0 - LOADOUT_POSITION_PRIMARY
//1 - LOADOUT_POSITION_SECONDARY
//2 - LOADOUT_POSITION_MELEE
//3 - LOADOUT_POSITION_UTILITY
//4 - LOADOUT_POSITION_BUILDING
//5 - LOADOUT_POSITION_PDA
//6 - LOADOUT_POSITION_PDA2
StripItem "Zombie Spy" [$SIGSEGV] // Remove item by name. This can be used to remove cosmetics including zombie cosmetics

</syntaxhighlight>

== Visual changes ==
UseBusterModel 1 [$SIGSEGV] //Use buster model

Skin 4 [$SIGSEGV] // Force the bot to use specified model skin

== Misc. keyvalues ==
NoBombUpgrades 1 [$SIGSEGV] //If set, the bomb carrier will not upgrade over time

PainSound "=70|GoldPipe_MissionIntro.mp3" [$SIGSEGV] //Override pain sound. The value after = is sound level in DB, applicable for all custom mission sounds

DeathSound "GoldPipe_MissionIntro.mp3" [$SIGSEGV] //Override death sound.

DesiredAttackRange 100 [$SIGSEGV] // How close to the target the bot should want to move when trying to attack. For melee weapons, default is 100. For other weapons except sniper rifles, default is 500

MoveBehindEnemy 1 [$SIGSEGV] // Should the bot try to get behind the target, similar to how the Spy bot behaves. Instead of 1 you can also specify custom distance at which the bot will start strafing around the target (default: 0)

== Additions to existing keyvalues ==
WeaponRestrictions now also supports '''PDAOnly''' and '''BuildingOnly'''.

TFBot

2026-07-20T20:10:42Z

ABadHaiku: Change "global keyvalues" into what they actually are: periodic tasks. Using source code, sort all periodic tasks into their own section.

Listed below are all of the custom keyvalues accepted in the '''TFBot{}''' block by our server mods. Examples of these additions can be found in the [https://testing.potato.tf/mvm_bigrock_sigdemo.pop demonstrative SigMod popfile].

= Periodic Tasks =
The blocks in this section are actions that can occur multiple times, using either a delay or condition for activating them. The keyvalues here can be used to configure any of these "periodic tasks":<syntaxhighlight>
Delay 10 //Time before the task starts (Default: 10)
Cooldown 1 //Time between each execution of the task (Default: 10)
Repeats 1 //How many times the bot should perform the task in total (Default: 0 - Infinite)
IfSeeTarget 1 //When set to 1, this task activates only when the bot can see a target (Default: 0 - Always activate)
IfNoTarget 1 //When set to 1, this task activates only when the bot does not have a target (Default: 0 - Always activate)
IfHealthBelow 100 //When set, the task activates only when the bot health is below specified value
IfHealthAbove 100 //When set, the task activates only when the bot health is above specified value
MaxTargetRange 150 //If set, the task activates only when the target is within specified units away
MinTargetRange 50 //If set, the task activates only when the target is more than specified units away
IfLeftSpawn 1 //If set, the task activates only after the target has left its spawn.
</syntaxhighlight>

== SpawnTemplate ==
<syntaxhighlight>
SpawnTemplate [$SIGSEGV] //Spawn custom player template
{
Name "Sentry"
Bone "bip_head" //Bone name where the template should be attached to
//Some bone names are listed here:
//bip_head
//bip_spine_2 - used by flag
//bip_hand_L
//bip_hand_R
//weapon_bone_R
//weapon_bone_L
//bip_foot_L
//bip_foot_R
}

</syntaxhighlight>Allows you to spawn [https://steamcommunity.com/sharedfiles/filedetails/?id=2289315026 PointTemplates], which will automatically be parented on the bot this block is on. Does <u>not</u> support global keyvalues. Bone names can also be found using HLMV, which is available by default in your Team Fortress 2/bin folder (which is "above" your tf/ folder).

== Taunt ==
<syntaxhighlight>
Taunt [$SIGSEGV] //Taunt periodically
{
Duration 5 //Duration of a looping taunt (Default: 0.1)
Name "Taunt: Kazotsky Kick" //If set, uses this item taunt instead of default
}

</syntaxhighlight>Note that "Name" requires the ''name of the item that you equip to use the taunt''. This name can be found in <code>items_game.txt</code>, with most newer taunts being prefixed with "Taunt: ", or having "Taunt" elsewhere in their name. Weapon-specific taunts can only be done if the bot is currently holding that weapon.

== Voice Command ==
<syntaxhighlight>
VoiceCommand [$SIGSEGV] //Periodically uses voice commands
{
Type "Medic" //Type of voice command. Possible values:
//Medic
//Help
//Go
//Move up
//Left
//Right
//Yes
//No
//Activate Charge
//Charge Ready
//Incoming
//Spy
//Thanks
//Jeers
//Battle cry
//Cheers
//Sentry here
//Dispenser here
//Teleporter here
//Good job
//Sentry ahead
//Positive
//Negative
//Nice shot
}

</syntaxhighlight>

== ChangeAttributes ==
<syntaxhighlight>
ChangeAttributes [$SIGSEGV] //Periodically changes bot attributes, defined in EventChangeAttributes{}
{
Name "Attr1" //Name of the bot attributes block listed in EventChangeAttributes{}
}

</syntaxhighlight>Note that bots will automatically start out in any attributes block named "Default". Maps with a gate will force bots to change to their "RevertGateBotsBehavior" block, if they have one.

== ClientCommand ==
<syntaxhighlight>
ClientCommand [$SIGSEGV] // Executes client commands, also known as console commands
{
Name "build 0" // Name of the client command, notable examples:
// "build 0/1/2/3" - Build dispenser / teleporter entrance / sentry / teleporter exit
// "destroy 0/1/2/3" - Destroy dispenser / teleporter entrance / sentry / teleporter exit
}

</syntaxhighlight>

== FireWeapon ==
<syntaxhighlight>
FireWeapon [$SIGSEGV] //Periodically fires weapon
{
Duration 0.5 //How long should the button be pressed (Default: 0.1)
Type "Secondary" // Type of fire input, Possible values:
//Primary
//Secondary
//Special - MOUSE3
//Reload
//Jump
//Crouch - requires NoCrouchButtonRelease 1 in TFBot
//Action
}

</syntaxhighlight>A FireWeapon{} block with <code>Type "Action"</code> can be paired with <code>ExtAttr SuppressCanteenUse</code> to time canteen usage.

A FireWeapon{} block with <code>Type "Primary"</code> can be paired with <code>Attributes SuppressFire</code> to control when a bot attacks.

== AddCond ==
<syntaxhighlight>
AddCond [$SIGSEGV] //Adds conditions to bots
{
Name "TF_COND_REPROGRAMMED" // Condition to apply.
//Index 43 //Condition index can be used instead
Delay 3 // Delay before the condition activates (Default: 0)
Duration 99 // Duration of the condition effect (Default: -1 - infinite duration)
}
</syntaxhighlight>Note that the default Delay value is 0.

Available condition values and names can be found on the [https://wiki.teamfortress.com/wiki/Cheats#addcond TF2 wiki].

== FireInput ==
<syntaxhighlight>
FireInput [$SIGSEGV] // Fires an input to an entity. Target !self and !activator refer to target the bot this block is on.
{
Target "random_color_case*" //Entity name to use
Action "PickRandom" //Input to fire
Param "" //Parameter to use
}

</syntaxhighlight>Keep in mind that <code>Repeats</code> defaults to 0, infinite. Specify it as 1 to only fire an input once. The bot will be considered the !activator.

== Add- & RemoveAttribute ==
<syntaxhighlight>
AddAttribute [$SIGSEGV]
{
Item "TF_WEAPON_KNIFE" // Item name to which add the attribute, or Player for player attribute, or Active for active weapon
Name "damage bonus" // Attribute name
Value 2 // Attribute value
}
RemoveAttribute [$SIGSEGV]
{
Item "TF_WEAPON_KNIFE" // Item name from which remove the attribute, or Player for player attribute, or Active for active weapon
Name "damage bonus" // Attribute name
}

</syntaxhighlight>If multiple attributes should be added or removed at once, it may be preferable to use <code>EventChangeAttributes{}</code> with <code>ChangeAttributes{}</code> instead.

== Message ==
<syntaxhighlight>
Message //Displays message in the chat
{
Name "{red}Hello!" //Message in the chat displayed
}

</syntaxhighlight>Text colour can also accept hex codes without #, such as <code>FF0000</code> for red.

== Sequence ==
<syntaxhighlight>
Sequence [$SIGSEGV] // Display a sequence animation with a name. Not every animation is supported
{
Name "Run_MELEE" // Name of the sequence
}

</syntaxhighlight>Sequence names can be found using HLMV, which is available by default in your Team Fortress 2/bin folder (which is "above" your tf/ folder), or in the Hammer++ Model Browser tool.

== WeaponSwitch ==
<syntaxhighlight>
WeaponSwitch [$SIGSEGV] //Periodically switches weapon
{
Type "Primary" // Weapon slot, possible values:
//Primary
//Secondary
//Melee
//PDA
//Building
}
</syntaxhighlight>

= Non-Periodic =

== WeaponResist ==
<syntaxhighlight>
WeaponResist [$SIGSEGV] //Multiplies damage received from weapons listed below
{
"TF_WEAPON_KNIFE" 0.1
"TF_WEAPON_MINIGUN" 10
}

</syntaxhighlight>Accepts both weapon classnames (such as <code>tf_weapon_flamethrower</code>applying to all regular flamethrowers) and individual weapon names.

== ExtAttr ==

Extra Attributes that can be applied to bots, akin to the vanilla Attributes keyvalue.<syntaxhighlight>
// Aim behavior.
MedicLookAtThreats //If the bot is a Medic: can turn around to look at threats
TargetStickies //Target and destroy stickies
IgnoreBuildings //Ignore buildings
IgnorePlayers //Ignore players (including bots)
IgnoreBots //Ignore bots
IgnoreRealPlayers //Ignore non-bot players
IgnoreNPC //Ignore NPCs such as Tanks, skeletons, and halloween bosses

// Attacking behavior.
AlwaysFireWeaponAlt //Always use secondary fire
SuppressCanteenUse //If set, the bot will not automatically activate canteens when looking at an enemy
JumpStomp //Try to jump over and stomp obstracles

// Engineer-only.
BuildDispenserAsTeleporter //Builds dispenser instead of teleporter
BuildDispenserAsSentryGun //Builds dispenser instead of sentry gun

// Misc.
DisableSpawnProtectionFix //Disables a fix where a medic activating ubercharge inside spawn will not be invulnerable when exiting spawn
</syntaxhighlight>

== Homing Rockets ==
<syntaxhighlight>
HomingRockets [$SIGSEGV]
{
IgnoreDisguisedSpies 1 //Ignore Spies that are disguised?
IgnoreStealthedSpies 1 //Ignore Spies that are cloaked?
RocketSpeed 0.25 //Multiplier of rocket speed. 1 for default speed
TurnPower 90 //How fast should the rocket rotate to face the target
MaxAimError 360 //Max angle between rocket and the target
}

</syntaxhighlight>Allows rockets (''but no other projectiles'') to home in on enemies. For making most projectiles home in on enemies, use the "mod projectile heat" set of [[List of custom attributes|custom attributes]].

== Action ==
A defunct keyvalue in vanilla. Works correctly on servers with our mods.<syntaxhighlight>
Action FetchFlag [$SIGSEGV] //Overrides default bot AI. Possible values:
//Default - Default action
//FetchFlag - Uses generic bomb fetching AI, default action for most bots except Spy, Medic, Engineer or Mission bots
//EscortFlag - As above, but ignores bot escort limit
//PushToCapturePoint - Pushes to capture point (or hatch in MvM). Similar to BehaviorModfiers Push and its aliases.
//Mobber - Chases down random player targets
//Spy - Uses spy AI, teleports behind players, but does not use disguises or cloak.
//Sniper - Uses mission sniper AI
//SuicideBomber - Uses sentry buster AI, but targets players instead. Might crash servers
//Idle - Sit in spawn and wait
//Passive - Sit at spawn position, until an active threat is in vision
//Medic - Use medic AI

</syntaxhighlight>

== Custom weapon model ==
<syntaxhighlight>
CustomWeaponModel [$SIGSEGV] //Sets custom weapon model
{
Slot 1 //Valid loadout positions:
//0 - LOADOUT_POSITION_PRIMARY
//1 - LOADOUT_POSITION_SECONDARY
//2 - LOADOUT_POSITION_MELEE
//3 - LOADOUT_POSITION_UTILITY
//4 - LOADOUT_POSITION_BUILDING
//5 - LOADOUT_POSITION_PDA
//6 - LOADOUT_POSITION_PDA2
Model "models/weapons/w_models/w_minigun.mdl"
}

</syntaxhighlight>Alternatively, use "custom item model" as a [[List of custom attributes|custom attribute]]. The model has to be precached if it isn't part of the current map. Double-check this if you end up with ERROR models.

== ItemColor ==
<syntaxhighlight>
ItemColor [$SIGSEGV] //Set item color
{
ItemName "The Gunboats"
Red 255
Green 0
Blue 0
}
</syntaxhighlight>

== DamageAppliesCond ==
<syntaxhighlight>
DamageAppliesCond [$SIGSEGV] //Adds conditions to players on hit
{
Name "TF_COND_URINE" // Condition to apply.
//Index 43 //Condition index can be used instead
Duration 3 // Duration of the condition effect (Default: -1 - infinite duration)
}

</syntaxhighlight>Available condition values and names can be found on the [https://wiki.teamfortress.com/wiki/Cheats#addcond TF2 wiki]. Alternatively, use the "add cond on hit" set of [[List of custom attributes|custom attributes]], which can be specified per weapon.

== Stripping items ==
<syntaxhighlight>
StripItemSlot 1 [$SIGSEGV] //If set, weapon in specified slot is stripped
//Valid loadout positions:
//0 - LOADOUT_POSITION_PRIMARY
//1 - LOADOUT_POSITION_SECONDARY
//2 - LOADOUT_POSITION_MELEE
//3 - LOADOUT_POSITION_UTILITY
//4 - LOADOUT_POSITION_BUILDING
//5 - LOADOUT_POSITION_PDA
//6 - LOADOUT_POSITION_PDA2
StripItem "Zombie Spy" [$SIGSEGV] // Remove item by name. This can be used to remove cosmetics including zombie cosmetics

</syntaxhighlight>

== Visual changes ==
UseBusterModel 1 [$SIGSEGV] //Use buster model

Skin 4 [$SIGSEGV] // Force the bot to use specified model skin

== Misc. keyvalues ==
NoBombUpgrades 1 [$SIGSEGV] //If set, the bomb carrier will not upgrade over time

PainSound "=70|GoldPipe_MissionIntro.mp3" [$SIGSEGV] //Override pain sound. The value after = is sound level in DB, applicable for all custom mission sounds

DeathSound "GoldPipe_MissionIntro.mp3" [$SIGSEGV] //Override death sound.

DesiredAttackRange 100 [$SIGSEGV] // How close to the target the bot should want to move when trying to attack. For melee weapons, default is 100. For other weapons except sniper rifles, default is 500

MoveBehindEnemy 1 [$SIGSEGV] // Should the bot try to get behind the target, similar to how the Spy bot behaves. Instead of 1 you can also specify custom distance at which the bot will start strafing around the target (default: 0)

== Additions to existing keyvalues ==
WeaponRestrictions now also supports '''PDAOnly''' and '''BuildingOnly'''.