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	Locations	Used by
Scout	Hat	All hats, except Batter's Helmet
	Headset	All hats, except Batter's Helmet
	Shoes and socks	Essential Accessories and Flip-Flops
	Dogtags	Sign of the Wolf's School
Soldier	Hat	All Hats, except Soldier's Stash and Exquisite Rack
	Grenades	Lumbricus Lid (Grenades)
	Medal	Many Miscellaneous items
Pyro	Head	Foster's Facade
	Grenades	Stockbroker's Scarf
Demoman	"Smile"	Grenade Launcher taunt
	Shoes	Ali Baba's Wee Booties
Heavy	Hands	Killing Gloves of Boxing, Gloves of Running Urgently and Fists of Steel.
Engineer	Hat	All Hats, except Mining Light and Industrial Festivizer.
	Right Arm	Gunslinger and Short Circuit.
Medic	Backpack	Quick-Fix.
Sniper	Arrows	Huntsman.
	Hat	All Hats, except the Trophy Belt.
	Bullets	Sydney Sleeper
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	bottle	When it breaks
Sandvich	Bite	To add a bite mark
Dalokohs Bar	Bite	To add a bite mark
Medi Gun	hose	Used to attach the Kritzkrieg
Huntsman	Arrow	The projectile

Update history

April 29, 2008 Patch (Gold Rush Update)

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

August 19, 2008 Patch (A Heavy Update)

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

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

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

August 13, 2009 Patch (Classless Update)

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

July 8, 2010 Patch (Engineer Update)

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

August 25, 2010 Patch

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

September 30, 2010 Patch (Mann-Conomy Update)

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

December 13, 2010 Patch

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

January 24, 2011 Patch

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

May 12, 2011 Patch

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

May 31, 2011 Patch

• [Undocumented] Added a new leg bodygroup to the Demoman model

June 23, 2011 Patch (Über Update)

• [Undocumented] Added new 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.

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