Bodygroup

A bodygroup is a feature of the Source Engine that enables specific sections of a model to be enabled or disabled, allowing for different models to take their place. In Team Fortress 2, bodygroups are used in the models of several items to show or hide specific player or weapon models when needed; for example, most hats manipulate bodygroups to remove the default headgear present on the player model to allow room for the newer hat model.

Bodygroups do not alter hitboxes, they are merely a cosmetic feature.

Bodygroups

Player models

Class	Group name	Used by
Scout	Hat	A style for the Bonk Boy, All Hats, except Batter's Helmet.
	Headset	A style for the Bonk Boy, all hats, except Batter's Helmet, the Spiral Sallet, and a style of the Backwards Ballcap.
	Shoes and socks	Essential Accessories, Flip-Flops, Futankhamun, Ball-Kicking Boots, Bootie Time and Teufort Tooth Kicker.
	Dog tags	Sign of the Wolf's School and B-ankh!
Soldier	Hat	All Hats, except Soldier's Stash, Exquisite Rack, and a style of the Battle Bob.
	Grenades	The Lumbricus Lid's grenades, the Professor's Pineapple, the Captain's Cocktails, and the Ornament Armament.
	Medal	Gentle Manne's Service Medal
Pyro	Head	Foster's Facade, Apparition's Aspect, HazMat Headcase, and Last Breath
	Grenades	Stockbroker's Scarf, Cremator's Conscience, Professor's Pineapple, Burning Bongos, Ornament Armament and Jingle Belt.
	Backpack	Moonman Backpack,the Scrap Pack,the Russian Rocketeer and the Pyrobotics Pack.
Demoman	"Smile"	Primary taunts.
	Shoes	Ali Baba's Wee Booties, the Bootlegger, the Pickled Paws, and the Teufort Tooth Kicker
	Grenades	A Whiff of the Old Brimstone, Professor's Pineapple, and Ornament Armament.
Heavy	Hands	Heavy melee weapons except Fists, Warrior's Spirit and Eviction Notice.
Engineer	Hat	All Hats, except Mining Light and Industrial Festivizer.
	Right Arm	Gunslinger and Short Circuit.
Medic	Backpack	The Quick-Fix's backpack, the Emerald Jarate, the Scrap Pack and the Medic Mech-bag.
Sniper	Arrows	Huntsman.
	Hat	All Hats, except the Trophy Belt.
	Bullets	Sydney Sleeper, Silver Bullets.
Spy	Mask	Disguise Kit.

Weapons

Weapon	Group name	Use
Flare Gun	Shell	The projectile
Detonator	Shell	The projectile
Grenade Launcher	Reload	The projectile
Loch-n-Load	Reload	The projectile
Bottle	Fragment	When it breaks
Sandvich	Bite	To add a bite mark
Dalokohs Bar	Bite	To add a bite mark
Buffalo Steak Sandvich	Bite	To add a bite mark
Medi Gun	Hose	Used to remove the hose on death
Huntsman	Arrow	The projectile

Update history

August 19, 2008 Patch (A Heavy Update)

• [Undocumented] Added hand bodygroup to the Heavy model.

May 21, 2009 Patch (Sniper vs. Spy Update)

• [Undocumented] Added arrow bodygroup to the Sniper model.

August 13, 2009 Patch (Classless Update)

• [Undocumented] Added hat bodygroups to the Scout, Soldier, Engineer and Sniper models.
• [Undocumented] Added headset bodygroup to the Scout model.
• [Undocumented] Added medal bodygroup to the Soldier model.

July 8, 2010 Patch (Engineer Update)

• [Undocumented] Added right arm bodygroup to the Engineer model.

August 25, 2010 Patch

• [Undocumented] Added grenade bodygroup to the Soldier model.

September 30, 2010 Patch (Mann-Conomy Update)

• [Undocumented] Added bullet bodygroup to the Sniper model.

December 13, 2010 Patch

• [Undocumented] Added head and grenade bodygroups to the Pyro model.

January 24, 2011 Patch

• [Undocumented] Added shoes and socks bodygroup to the Scout model

April 14, 2011 Patch (Hatless Update)

• [Undocumented] Added hose bodygroup to the Medi Gun.

May 12, 2011 Patch

• [Undocumented] Added dogtag bodygroup to the Scout model.

May 31, 2011 Patch

• [Undocumented] Added leg bodygroup to the Demoman model

June 23, 2011 Patch (Über Update)

• [Undocumented] Added backpack bodygroup to the Medic model.

August 18, 2011 Patch (Manno-Technology Bundle)

• [Undocumented] Fixed Heavy's fist bodygroup not being removed when equipped with certain melee weapons.

March 22, 2012 Patch

• [Undocumented] Added backpack bodygroup to the Pyro

July 10, 2012 Patch

• Fixed body groups not hiding correctly on ragdolls

Unused content

• Some items (e.g. The Pyromancer's Mask and the Splendid Screen) have an alternate styles that changes the shape or design on the item. This is accomplished via bodygroups.

Bugs

• Items that turn off specific bodygroups will not cast a shadow.
• Occasionally, bodygroups will disappear, leaving empty space on the model.
• Occasionally, items will fail to turn off the default bodygroup, leading to the original group clipping into the replacement model.
• Items that replace a removed group will not disappear when the player is backstabbed by Your Eternal Reward.

External links

• $bodygroup on the Valve Developer Community – technical explanation of $bodygroup