Difference between revisions of "Bodygroup"

From Team Fortress Wiki
Jump to: navigation, search
(Bugs: Rewording the last bug.)
 
(81 intermediate revisions by 42 users not shown)
Line 1: Line 1:
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.
+
{{update|Content hasn't been updated since 2015.}}
  
Bodygroups do not alter [[Mechanics#Hit detection|hitboxes]], they are merely a cosmetic feature.
+
[[File:Bodygroup.png|100px|right]]
 +
A '''bodygroup''' is a feature of the [[Source Engine]] that enables specific sections of a model to be enabled or disabled, popularly 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 [[cosmetic items]] manipulate bodygroups to remove the default headgear present on the player model to allow room for the newer cosmetic model.
 +
 
 +
Bodygroups do not alter [[Mechanics#Hit detection|hitboxes]]; like [[jigglebones]], they are a purely cosmetic feature.
  
 
== Bodygroups ==
 
== Bodygroups ==
 
=== Player models ===
 
=== Player models ===
{| class="wikitable grid"
+
{{Player bodygroup}}
! class="header" | Class
 
! class="header" | Group name
 
! class="header" | Used by
 
|-
 
| rowspan="4" | {{class link|Scout}}
 
| Hat
 
| [[Scout#Hats|All Hats]], except [[Batter's Helmet]].
 
|-
 
| Headset
 
| All hats, except [[Batter's Helmet]] and the [[Spiral Sallet]].
 
|-
 
| Shoes and socks
 
| [[Essential Accessories]] and [[Flip-Flops]].
 
|-
 
| Dogtags
 
| [[Sign of the Wolf's School]]
 
|-
 
| rowspan="3" | {{class link|Soldier}}
 
| Hat
 
| [[Soldier#Hats|All Hats]], except [[Soldier's Stash]] and [[Exquisite Rack]].
 
|-
 
| Grenades
 
| [[Lumbricus Lid|Lumbricus Lid (Grenades)]].
 
|-
 
| Medal
 
| [[Soldier#Hats|Many Miscellaneous items]]
 
|-
 
| rowspan="2" | {{class link|Pyro}}
 
| Head
 
| [[Foster's Facade]].
 
|-
 
| Grenades
 
| [[Stockbroker's Scarf]].
 
|-
 
| rowspan="2" | {{class link|Demoman}}
 
| "Smile"
 
| [[Demoman taunts#Primary|Primary taunts]].
 
|-
 
| Shoes
 
| [[Ali Baba's Wee Booties]].
 
|-
 
| rowspan="2" | {{class link|Heavy}}
 
| Hands
 
| [[Killing Gloves of Boxing]], [[Gloves of Running Urgently]] and [[Fists of Steel]].
 
|-
 
| Left Hand
 
| [[Purity Fist]]
 
|-
 
| rowspan="2" | {{class link|Engineer}}
 
| Hat
 
| [[Engineer#Hats|All Hats]], except [[Mining Light]] and [[Industrial Festivizer]].
 
|-
 
| Right Arm
 
| [[Gunslinger]] and [[Short Circuit]].
 
|-
 
| rowspan="1" | {{class link|Medic}}
 
| Backpack
 
| [[Quick-Fix|Quick-Fix (Backpack)]].
 
|-
 
| rowspan="3" | {{class link|Sniper}}
 
| Arrows
 
| [[Huntsman]].
 
|-
 
| Hat
 
| [[Sniper#Hats|All Hats]], except the [[Trophy Belt]].
 
|-
 
| Bullets
 
| [[Sydney Sleeper]].
 
|-
 
| rowspan="1" | {{class link|Spy}}
 
| Mask
 
| [[Disguise Kit]].
 
|-
 
|}
 
  
 
=== Weapons ===
 
=== Weapons ===
{| class="wikitable grid"
+
{{Weapons bodygroup}}
! class="header" | Weapon
 
! class="header" | Group name
 
! class="header" | Use
 
|-
 
! {{Table icon|Flare Gun}}
 
| Shell
 
| The projectile
 
|-
 
! {{Table icon|Detonator}}
 
| Shell
 
| The projectile
 
|-
 
! {{Table icon|Grenade Launcher}}
 
| Reload
 
| The projectile
 
|-
 
! {{Table icon|Loch-n-Load}}
 
| Reload
 
| The projectile
 
|-
 
! {{Table icon|Bottle}}
 
| bottle
 
| When it breaks
 
|-
 
! {{Table icon|Sandvich}}
 
| Bite
 
| To add a bite mark
 
|-
 
! {{Table icon|Dalokohs Bar}}
 
| Bite
 
| To add a bite mark
 
|-
 
! {{Table icon|Buffalo Steak Sandvich}}
 
| Bite
 
| To add a bite mark
 
|-
 
! {{Table icon|Medi Gun}}
 
| hose
 
| Used to attach the [[Kritzkrieg]]
 
|-
 
! {{Table icon|Huntsman}}
 
| Arrow
 
| The projectile
 
|-
 
|}
 
  
 
== Update history ==
 
== Update history ==
{{update history|
+
{{Update history|'''{{Patch name|8|19|2008}}''' ([[A Heavy Update]])
'''[[April 29, 2008 Patch]]''' ([[Gold Rush Update]])
+
* {{undocumented}} Added hand bodygroup to the Heavy model.
* {{undocumented}} Added new hose bodygroup to the Medi Gun.
 
  
'''[[August 19, 2008 Patch]]''' ([[A Heavy Update]])
+
'''{{Patch name|5|21|2009}}''' ([[Sniper vs. Spy Update]])
* {{undocumented}} Added new hand bodygroup to the Heavy model.
+
* {{undocumented}} Added arrow bodygroup to the Sniper model.
  
'''[[May 21, 2009 Patch]]''' ([[Sniper vs. Spy Update]])
+
'''{{Patch name|8|13|2009}}''' ([[Classless Update]])
* {{undocumented}} Added new arrow bodygroup to the Sniper model.
+
* {{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.
  
'''[[August 13, 2009 Patch]]''' ([[Classless Update]])
+
'''{{Patch name|7|8|2010}}''' ([[Engineer Update]])
* {{undocumented}} Added new hat bodygroups to the Scout, Soldier, Engineer and Sniper models.
+
* {{undocumented}} Added right arm bodygroup to the Engineer model.  
* {{undocumented}} Added new headset bodygroup to the Scout model.
 
* {{undocumented}} Added new medal bodygroup to the Soldier model.
 
  
'''[[July 8, 2010 Patch]]''' ([[Engineer Update]])
+
'''{{Patch name|8|25|2010}}'''
* {{undocumented}} Added new right arm bodygroup to the Engineer model.  
+
* {{undocumented}} Added grenade bodygroup to the Soldier model.  
  
'''[[August 25, 2010 Patch]]'''
+
'''{{Patch name|9|30|2010}}''' ([[Mann-Conomy Update]])
* {{undocumented}} Added a new grenade bodygroup to the Soldier model.  
+
* {{undocumented}} Added bullet bodygroup to the Sniper model.
  
'''[[September 30, 2010 Patch]]''' ([[Mann-Conomy Update]])
+
'''{{Patch name|12|13|2010}}'''
* {{undocumented}} Added a new bullet bodygroup to the Sniper model.
+
* {{undocumented}} Added head and grenade bodygroups to the Pyro model.
  
'''[[December 13, 2010 Patch]]'''
+
'''{{Patch name|1|24|2011}}'''
* {{undocumented}} Added new head and grenade bodygroups to the Pyro model.
+
* {{undocumented}} Added shoes and socks bodygroup to the Scout model.
  
'''[[January 24, 2011 Patch]]'''
+
'''{{Patch name|4|14|2011}}''' ([[Hatless Update]])
* {{undocumented}} Added new shoes and socks bodygroup to the Scout model
+
* {{undocumented}} Added hose bodygroup to the [[Medi Gun]] model.
  
'''[[May 12, 2011 Patch]]'''
+
'''{{Patch name|5|12|2011}}'''
* {{undocumented}} Added a new dogtag bodygroup to the Scout model.
+
* {{undocumented}} Added dogtag bodygroup to the Scout model.
  
'''[[May 31, 2011 Patch]]'''
+
'''{{Patch name|5|31|2011}}'''
* {{undocumented}} Added a new leg bodygroup to the Demoman model
+
* {{undocumented}} Added leg bodygroup to the Demoman model.
  
'''[[June 23, 2011 Patch]]''' ([[Über Update]])
+
'''{{Patch name|6|23|2011}}''' ([[Über Update]])
* {{undocumented}} Added new backpack bodygroup to the Medic model.  
+
* {{undocumented}} Added backpack bodygroup to the Medic model.  
  
'''[[August 18, 2011 Patch]]''' ([[Manno-Technology Bundle]])
+
'''{{Patch name|8|18|2011}}''' ([[Manno-Technology Bundle]])
 
* {{undocumented}} Fixed Heavy's fist bodygroup not being removed when equipped with certain melee weapons.
 
* {{undocumented}} Fixed Heavy's fist bodygroup not being removed when equipped with certain melee weapons.
 +
 +
'''{{Patch name|3|22|2012}}'''
 +
* {{undocumented}} Added backpack bodygroup to the Pyro.
 +
 +
'''{{Patch name|7|10|2012}}'''
 +
* Fixed body groups not hiding correctly on ragdolls.
 +
 +
'''{{Patch name|10|26|2012}}''' ([[Spectral Halloween Special]])
 +
* {{undocumented}} Fixed a bug that would make certain body groups will fail to activate when required. For example, the Soldier's 'rocket' and Demoman's 'smile' during certain taunts.
 +
 +
'''{{Patch name|11|5|2012}}'''
 +
* {{undocumented}} Fixed the [[Spooky Shoes]] not hiding the socks and shoes bodygroup.
 +
* {{undocumented}} Fixed the [[Coffin Kit]] hiding the backpack bodygroup.
 +
 +
'''{{Patch name|12|8|2014}} #2'''
 +
* {{undocumented}} Corrected bodygroups for [[Snow Sleeves]].
 +
 +
'''{{Patch name|12|10|2014}}'''
 +
* Updated the bodygroup settings for [[Screamin' Eagle]], [[North Polar Fleece]], [[Bomber's Bucket Hat]], [[Fur-lined Fighter]], [[Insulated Inventor]] and [[Snow Stompers]].
 +
 +
'''{{Patch name|1|15|2015}} #1'''
 +
* Fixed AE_CL_BODYGROUP_SET_VALUE animation events not working properly.
 +
 +
'''{{Patch name|2|11|2015}} #1'''
 +
* Fixed [[Bootenkhamuns|The Bootenkhamuns]] not hiding the correct bodygroup when equipped.
 +
 +
'''{{Patch name|2|18|2015}}'''
 +
* Fixed weapon attachments casting shadows at the wrong time.
 
}}
 
}}
 +
 +
== Unused content ==
 +
* The [[Pyromancer's Mask]] has a bodygroup that features an alternative set of horns.
  
 
== Bugs ==
 
== Bugs ==
* Items that turn off specific bodygroups will not cast a shadow.
+
* Items that turn off specific bodygroups do not cast a shadow.
* Occasionally, bodygroups will disappear, leaving empty space on the model.
+
* Occasionally, bodygroups 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.
+
* Occasionally, items 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]].
+
* Items that replace a removed group do not disappear when the player is backstabbed by [[Your Eternal Reward]].
 +
* If a cosmetic that partially covers a bodygroup and a cosmetic that disables that same bodygroup (e.g. the [[Bottle Cap]], which adds custom dog tags partially over the Scout's default ones, and the [[Bigg Mann on Campus]], which entirely removes the default dog tags) are equipped at the same time, the part covering the bodygroup remains visible.
  
 
== External links ==
 
== External links ==
 
* {{vdc|$bodygroup}} – technical explanation of {{code|$bodygroup}}
 
* {{vdc|$bodygroup}} – technical explanation of {{code|$bodygroup}}
 
  
 
[[Category:Glossary]]
 
[[Category:Glossary]]
 
[[Category:Lists]]
 
[[Category:Lists]]

Latest revision as of 15:13, 7 January 2024

Bodygroup.png

A bodygroup is a feature of the Source Engine that enables specific sections of a model to be enabled or disabled, popularly 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 cosmetic items manipulate bodygroups to remove the default headgear present on the player model to allow room for the newer cosmetic model.

Bodygroups do not alter hitboxes; like jigglebones, they are a purely cosmetic feature.

Bodygroups

Player models

List of bodygroups on player models
Class Group name Used by
Leaderboard class scout.png Scout Hat All Hats, except Batter's Helmet and the "Tuned in" style of the Bonk Boy.
Headset All hats, except Batter's Helmet, Spiral Sallet, Brütal Bouffant, the "I Can't Hear You" style of the Backwards Ballcap, the "Tuned in" style of the Bonk Boy, the "with Headphones" style of the Hanger-On Hood, and Bacteria Blocker.
Shoes and socks Argyle Ace, Ball-Kicking Boots, Baphomet Trotters, Blizzard Britches, Bootie Time, Bootenkhamuns, Brooklyn Booties, Buck Turner All-Stars, Cheet Sheet, Crazy Legs, Essential Accessories, Faun Feet, Flip-Flops, Futankhamun, Flunkyware, Forest Footwear, Harlequin's Hooves, Hot Heels, Long Fall Loafers, Olympic Leapers, Terrier Trousers, Teufort Tooth Kicker, Red Socks, Sole Saviors, Spooky Shoes and Xeno Suit.
Dog tags Sign of the Wolf's School, B-ankh!, Cryptic Keepsake, Ticket Boy, Frickin' Sweet Ninja Hood, Southie Shinobi, Polar Pullover, Flapjack, Cool Cat Cardigan, Bigg Mann on Campus and Triad Trinket.
Leaderboard class soldier.png Soldier Hat All Hats, except Soldier's Stash, Exquisite Rack, Cross-Comm Crash Helmet, and a style for both the Antlers and Battle Bob.
Grenades The Lumbricus Lid's grenades, Bananades, Bonedolier, Candleer, Captain's Cocktails, Chaser, Cold Snap Coat, Deadliest Duckling, Flakcatcher, Ghoul Gibbin' Gear, Gift Bringer, Handy Canes, Ornament Armament, Patriot's Pouches, Party Poncho, Pin Pals, Professor's Pineapple and War on Smissmas Battle Socks.
Medal Gentle Manne's Service Medal.
Leaderboard class pyro.png Pyro Head Airtight Arsonist, Air Raider, Arachno-Arsonist, Arthropod's Aspect, Apparition's Aspect, Beast from Below, Black Knight's Bascinet, Blizzard Breather, Breather Bag, Candy Cranium, Combustible Cutie, Corpsemopolitan, Dead Heat, Creature's Grin, Fear Monger, Fire Breather, Firefly, Fire Tooth, Fiercesome Fluorescence, Flame Warrior, Foster's Facade, Glob, HazMat Headcase, Hard-Headed Hardware, Head of the Dead, Hollowhead, Filamental, Gothic Guise, Last Breath, Macabre Mask, Lollichop Licker, Mair Mask, Miami Rooster, Mishap Mercenary, Mr. Juice, Mr. Quackers, Mucous Membrain, Nabler, Neptune's Nightmare, Phobos Filter, Plutonidome, PY-40 Incinibot, Pyro the Flamedeer, Pyr'o Lantern, Pyro Shark, Rugged Respirator, Rusty Reaper, Seared Sorcerer, Treehugger, Spectralnaut, Smiling Somen, Vampyro, Vicious Visage, Wandering Wraith and Winter Wonderland Wrap, and a style of the Nose Candy.
Grenades Bananades, Bonedolier, Burning Bongos, Candleer, Cremator's Conscience, Deadliest Duckling, Death Support Pack, Deity's Dress, Firebrand, Handy Canes, Hot Case, Jingle Belt, Kazan Karategi, Lunatic's Leathers, Ornament Armament, Professor's Pineapple, Mair Mask, Steel Sixpack, El Muchacho, Soot Suit, Space Diver, Stockbroker's Scarf, Torcher's Tabard, Pin Pals, Sengoku Scorcher, Soho Sleuth, Sweet Smissmas Sweater, Water Waders and Wanderer's Wear.
Backpack Thermal Thruster, Scrap Pack, Infernal Orchestrina, External Organ, Tiny Timber, Trail-Blazer, Frymaster, Gas Guzzler, Handhunter, Grisly Gumbo, Creature from the Heap, Russian Rocketeer, Pyrobotics Pack, Pyrotechnic Tote, Scrap Sack, Backpack Broiler, Hook, Line, and Cinder, Hovering Hotshot, Sacrificial Stone, Spawn Camper and Fireman's Essentials.
Leaderboard class demoman.png Demoman "Smiley" Primary taunts, taunting with Scotsman's Skullcutter and Pain Train.
Shoes Ali Baba's Wee Booties, Barefoot Brawler, Bootlegger, Pickled Paws, Teufort Tooth Kicker, Buck Turner All-Stars, Baphomet Trotters, Highland High Heels, Shin Shredders, Sole Saviors and Storm Stompers.
Grenades A Whiff of the Old Brimstone, Battery Bandolier, Bananades, Blast Blocker, Bonedolier, Candleer, Deadliest Duckling, Double Dynamite, Gaelic Garb, Handy Canes, Hawaiian Hangover, Juggernaut Jacket, Mad Lad, Ornament Armament, Professor's Pineapple, Shrapnel Shell, Six Pack Abs and Trickster's Treats.
Leaderboard class heavy.png Heavy Hands All melee weapons except Fists, Warrior's Spirit and Eviction Notice, and the Purity Fist.
Leaderboard class engineer.png Engineer Hat All Hats, except Mining Light, Industrial Festivizer, a style for both the Big Country and Professor's Peculiarity.
Right Arm Gunslinger and Short Circuit.
Leaderboard class medic.png Medic Backpack The Quick-Fix and Vaccinator's backpacks, Scrap Pack and the Medic Mech-bag.
Leaderboard class sniper.png Sniper Arrows Huntsman.
Hat All Hats, except the Trophy Belt.
Bullets Sydney Sleeper.
Leaderboard class spy.png Spy Mask Disguise Kit.

Weapons

List of weapons with bodygroup
Class Slot Weapon Group name Use
Secondary Flare Gun Detonator Shell The projectile
Flare Gun Detonator
Scorch Shot
Scorch Shot
Primary Grenade Launcher Loch-n-Load Reload The projectile
Grenade Launcher Loch-n-Load
Loose Cannon Iron Bomber
Loose Cannon Iron Bomber
Secondary Sandvich Dalokohs Bar Bite To add a bite mark
Sandvich Dalokohs Bar
Buffalo Steak Sandvich Robo-Sandvich
Buffalo Steak Sandvich Robo-Sandvich
Secondary Medi Gun Kritzkrieg Hose To remove the hose on death
Medi Gun Kritzkrieg
Quick-Fix Vaccinator
Quick-Fix Vaccinator
Primary Huntsman Fortified Compound Arrow The projectile
Huntsman Fortified Compound
Note

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 model.

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.

October 26, 2012 Patch (Spectral Halloween Special)

  • [Undocumented] Fixed a bug that would make certain body groups will fail to activate when required. For example, the Soldier's 'rocket' and Demoman's 'smile' during certain taunts.

November 5, 2012 Patch

  • [Undocumented] Fixed the Spooky Shoes not hiding the socks and shoes bodygroup.
  • [Undocumented] Fixed the Coffin Kit hiding the backpack bodygroup.

December 8, 2014 Patch #2

December 10, 2014 Patch

January 15, 2015 Patch #1

  • Fixed AE_CL_BODYGROUP_SET_VALUE animation events not working properly.

February 11, 2015 Patch #1

February 18, 2015 Patch

  • Fixed weapon attachments casting shadows at the wrong time.

Unused content

Bugs

  • Items that turn off specific bodygroups do not cast a shadow.
  • Occasionally, bodygroups disappear, leaving empty space on the model.
  • Occasionally, items fail to turn off the default bodygroup, leading to the original group clipping into the replacement model.
  • Items that replace a removed group do not disappear when the player is backstabbed by Your Eternal Reward.
  • If a cosmetic that partially covers a bodygroup and a cosmetic that disables that same bodygroup (e.g. the Bottle Cap, which adds custom dog tags partially over the Scout's default ones, and the Bigg Mann on Campus, which entirely removes the default dog tags) are equipped at the same time, the part covering the bodygroup remains visible.

External links