Team Fortress Wiki:3D Models
| 
 | ||||||||||||||||||||||||||||
The 3D Models project's goal is to construct pseudo-3D images of the weapons in Team Fortress 2 that can be freely rotated.
Contents
Example
 Note This is not for the faint of heart. It requires a bit of knowledge on how both VMTs and HLMV work, and a lot of time and patience since a lot of models will not be centered correctly by default, thus requiring plenty of tweaking to get them ready for the process.
 Note This is not for the faint of heart. It requires a bit of knowledge on how both VMTs and HLMV work, and a lot of time and patience since a lot of models will not be centered correctly by default, thus requiring plenty of tweaking to get them ready for the process.
Requirements
- Windows
- TF2
- HLMV (included as a part of TF2)
- (optionally) HLMV++
 
- Python 3.7.9
- A copy of the automaton repository
Initial setup
Installation
Please follow the latest instructions at the 3D-Models-automaton repo.
Workflow
Taking images
- Open up the weapon in HLMV and ensure it rotates properly. There are three possible outcomes here:
- The model will rotate around the bottom corner of the model. If so, you will need to make use of rotation_offset.- First, reset the model's position with Options → Center View.
- Then, from cmd, navigate to the folder containingautomate.pyand runmem trans, noting the second value (the Y translation).
- Back in HLMV, rotate the model so that it is facing right. Hold down ⇧ Shift and move the model sideways so that it is centered in the circle that appears.
- Go back to cmd, and runmem transagain, once again noting the second value.
- The difference between the current value and the initial value is the rotation_offsetvalue to set inautomate.py.
 
- The model will rotate around the wrong plane or the model will not rotate around the vertical or horizontal center. If so, the model will need to be recompiled.
- The model will rotate around the vertical and horizontal center of the model. If so, you are good to go.
 
- The model will rotate around the bottom corner of the model. If so, you will need to make use of 
- Center the model using Options → Center View.
- If the model does not face you directly when centered, it will need to be recompiled with a new rotation.
- Zoom the model out so that it is as large as possible, but will not clip outside the viewer window when rotated or tilted.
- If the light source produces a glare that interferes with the model, hold Ctrl and drag the light source around with the mouse until it is in a better position.
- Run the script, from the command line. Navigate to the folder containing the scripts and type python automate.py.
- After the image finishes rotating, switch back to the command line and follow the prompts to upload the file.
Team-colored models
- This is now very simple, simply change this in HLMV (Model → Skin #), then re-run the script.
Models with other class arms/models blocking the view
- If you wish to remove a model from the viewer (for example the Sniper's arms holding onto the view model Sniper Rifle), click on the Model tab in HLMV and find out which VMTs are being used for the model textures.
- Extract the VMTs using GCFScape to the same path in your /custom/folderand open them up in a text editor.
- Inside the "VertexLitGeneric"curly brackets add the line"$no_draw" "1". This will make this part of the model invisible in HLMV.
Recompiling models
- First, check here to see if a model has already been recompiled.
- Download and install Crowbar, GCFScape, and the Source SDK (Steam -> Library -> Tools)
- Extract the model with GCFScape, decompile with Crowbar.
- For the most part, adding $autocenterto the .qc file should do the trick. If not, try using$origin X Y Z. For more complex concerns, see Category:QC Commands on the Valve Developer Community.
- Recompile the model with Crowbar. You should be good to go!
Uploading your image
- This should happen automatically. If it does not, ensure that you have poster installed via pip install -U poster.
Tips and debugging
- You can set vertical_rotations = 0to generate the model with no tilting, or reduce the number of rotations withnumber_of_images.
- You will find it much easier when recompiling models to find out if they're centered correctly by checking the 'Ground' checkbox in HLMV and refreshing the model every time you make a change and recompile.
- If the 3D image's starting position isn't centered, click the edit button on the 3D image file's page and change "startframe" to whichever frame number is the centered frame.
Models repository
Weapons
Needed weapons
Scout Weapons:
 Bat, festive Bat, festive
 Fan O'War Fan O'War
 Force-A-Nature, festive, australium Force-A-Nature, festive, australium
Soldier Weapons:
 Air Strike Projectile Air Strike Projectile
 Buff Banner, festive, festive backpack Buff Banner, festive, festive backpack
 Battalion's Backup, alt, alt2, alt3 Battalion's Backup, alt, alt2, alt3
 Concheror, alt, alt2, backpack Concheror, alt, alt2, backpack
 Equalizer Equalizer
 Escape Plan Escape Plan
 Gunboats Gunboats
 Mantreads Mantreads
 B.A.S.E. Jumper, open B.A.S.E. Jumper, open
 Beggar's Bazooka Beggar's Bazooka
Pyro Weapons:
 Axtinguisher, alt, australium, festive Axtinguisher, alt, australium, festive
 Back Scratcher Back Scratcher
 Backburner, festive Backburner, festive
 Detonator projectile Detonator projectile
 Fire Axe Fire Axe
 Flare Gun, festive, projectile Flare Gun, festive, projectile
 Lollichop Lollichop
 Neon Annihilator Neon Annihilator
 Homewrecker Homewrecker
 Manmelter Manmelter
Demoman Weapons:
 Ali Baba's Wee Booties Ali Baba's Wee Booties
 Bootlegger Bootlegger
 Chargin' Targe, festive Chargin' Targe, festive
 Eyelander, festive, australium Eyelander, festive, australium
 Iron Bomber projectile Iron Bomber projectile
 Nessie's Nine Iron Nessie's Nine Iron
 Horseless Headless Horsemann's Headtaker Horseless Headless Horsemann's Headtaker
Heavy Weapons:
 Apoco-Fists Apoco-Fists
 Bread Bite Bread Bite
 Dalokohs Bar, bitten Dalokohs Bar, bitten
 Fists Fists
 Fists of Steel Fists of Steel
 Eviction Notice Eviction Notice
 Gloves of Running Urgently, festive Gloves of Running Urgently, festive
 Holiday Punch Holiday Punch
 Huo-Long Heater Huo-Long Heater
 Iron Curtain Iron Curtain
 Killing Gloves of Boxing Killing Gloves of Boxing
 Natascha, festive Natascha, festive
Engineer Weapons:
 Eureka Effect Eureka Effect
 Frontier Justice, festive, australium Frontier Justice, festive, australium
 Giger Counter Giger Counter
 Gunslinger Gunslinger
 Jag, festive Jag, festive
Medic Weapons:
 Bonesaw, festive Bonesaw, festive
 Kritzkrieg, festive Kritzkrieg, festive
Sniper Weapons:
 Classic Classic
 AWPer Hand AWPer Hand
 Cleaner's Carbine Cleaner's Carbine
 Hitman's Heatmaker Hitman's Heatmaker
 Bushwacka Bushwacka
 Cozy Camper Cozy Camper
 Darwin's Danger Shield Darwin's Danger Shield
 Fortified Compound Fortified Compound
 Huntsman, festive Huntsman, festive
 Jarate, festive Jarate, festive
 Kukri, festive Kukri, festive
 Machina Machina
 Shahanshah Shahanshah
Spy Weapons:
 Ap-Sap Ap-Sap
 Big Earner Big Earner
 Black Rose, festive Black Rose, festive
 Cloak and Dagger Cloak and Dagger
 Conniver's Kunai Conniver's Kunai
 Diamondback Diamondback
 Disguise Kit Disguise Kit
 Enthusiast's Timepiece Enthusiast's Timepiece
 Invis Watch Invis Watch
 L'Etranger L'Etranger
Multiple Class Weapons:
 Bat Outta Hell Bat Outta Hell
 C.A.P.P.E.R C.A.P.P.E.R
 Conscientious Objector Conscientious Objector
 Crossing Guard, festive Crossing Guard, festive
 Freedom Staff Freedom Staff
 Frying Pan Frying Pan
 Golden Frying Pan Golden Frying Pan
 Golden Wrench Golden Wrench
 Ham Shank Ham Shank
 Necro Smasher Necro Smasher
Finished weapons
 Air Strike Air Strike
 Ali Baba's Wee Booties Ali Baba's Wee Booties
 Ambassador: Multiple Skins Ambassador: Multiple Skins
 Amputator Amputator
 Ap-Sap Ap-Sap
 Apoco-Fists Apoco-Fists
 Atomizer Atomizer
 AWPer Hand AWPer Hand
 Axtinguisher: Multiple Skins Axtinguisher: Multiple Skins
 Baby Face's Blaster Baby Face's Blaster
 Backburner Backburner
 Back Scatter Back Scatter
 Back Scratcher Back Scratcher
 B.A.S.E. Jumper B.A.S.E. Jumper
 Bat: Multiple Skins Bat: Multiple Skins
 Bat Outta Hell Bat Outta Hell
 Batsaber Batsaber
 Battalion's Backup Battalion's Backup
 Bazaar Bargain Bazaar Bargain
 Beggar's Bazooka Beggar's Bazooka
 Big Earner Big Earner
 Big Kill Big Kill
 Black Box: Multiple Skins Black Box: Multiple Skins
 Black Rose Black Rose
 Blutsauger: Multiple Skins Blutsauger: Multiple Skins
 Bonesaw Bonesaw
 Bonk! Atomic Punch: Multiple Skins Bonk! Atomic Punch: Multiple Skins
 Bootlegger Bootlegger
 Boston Basher Boston Basher
 Bottle Bottle
 Brass Beast Brass Beast
 Bread Bite Bread Bite
 Buffalo Steak Sandvich Buffalo Steak Sandvich
 Buff Banner: Multiple Skins Buff Banner: Multiple Skins
 Bushwacka Bushwacka
 Candy Cane Candy Cane
 Chargin' Targe: Multiple Skins Chargin' Targe: Multiple Skins
 Claidheamh Mòr Claidheamh Mòr
 Classic Classic
 Cleaner's Carbine Cleaner's Carbine
 Cloak and Dagger Cloak and Dagger
 Concheror Concheror
 Conniver's Kunai Conniver's Kunai
 Conscientious Objector Conscientious Objector
 Cow Mangler 5000 Cow Mangler 5000
 Cozy Camper Cozy Camper
 Crit-a-Cola Crit-a-Cola
 Crossing Guard Crossing Guard
 Crusader's Crossbow: Multiple Skins Crusader's Crossbow: Multiple Skins
 Darwin's Danger Shield Darwin's Danger Shield
 Dead Ringer Dead Ringer
 Degreaser Degreaser
 Detonator Detonator
 Diamondback Diamondback
 Direct Hit Direct Hit
 Disciplinary Action Disciplinary Action
 Disguise Kit Disguise Kit
 Dragon's Fury Dragon's Fury
 Electro Sapper: Multiple Skins Electro Sapper: Multiple Skins
 Enforcer Enforcer
 Enthusiast's Timepiece Enthusiast's Timepiece
 Equalizer Equalizer
 Escape Plan Escape Plan
 Eureka Effect Eureka Effect
 Eviction Notice Eviction Notice
 Eyelander: Multiple Skins Eyelander: Multiple Skins
 Family Business Family Business
 Fan O'War Fan O'War
 Fire Axe Fire Axe
 Fishcake Fishcake
 Fists of Steel Fists of Steel
 Fists Fists
 Flame Thrower: Multiple Skins Flame Thrower: Multiple Skins
 Flare Gun: Multiple Skins Flare Gun: Multiple Skins
 Flying Guillotine Flying Guillotine
 Force-A-Nature: Multiple Skins Force-A-Nature: Multiple Skins
 Fortified Compound Fortified Compound
 Freedom Staff Freedom Staff
 Frontier Justice: Multiple Skins Frontier Justice: Multiple Skins
 Frying Pan Frying Pan
 Gas Passer Gas Passer
 Giger Counter Giger Counter
 Gloves of Running Urgently: Multiple Skins Gloves of Running Urgently: Multiple Skins
 Golden Frying Pan Golden Frying Pan
 Golden Wrench Golden Wrench
 Grenade Launcher: Multiple Skins Grenade Launcher: Multiple Skins
 Gunboats Gunboats
 Gunslinger Gunslinger
 Half-Zatoichi Half-Zatoichi
 Ham Shank Ham Shank
 Hitman's Heatmaker Hitman's Heatmaker
 Holiday Punch Holiday Punch
 Holy Mackerel: Multiple Skins Holy Mackerel: Multiple Skins
 Homewrecker Homewrecker
 Horseless Headless Horsemann's Headtaker Horseless Headless Horsemann's Headtaker
 Hot Hand Hot Hand
 Huntsman: Multiple Skins Huntsman: Multiple Skins
 Huo-Long Heater Huo-Long Heater
 Invisibility Watch Invisibility Watch
 Iron Curtain Iron Curtain
 Jag Jag
 Jarate: Multiple Skins Jarate: Multiple Skins
 Killing Gloves of Boxing Killing Gloves of Boxing
 Knife: Multiple Skins Knife: Multiple Skins
 Kritzkrieg Kritzkrieg
 Kukri Kukri
 L'Etranger L'Etranger
 Liberty Launcher Liberty Launcher
 Loch-n-Load Loch-n-Load
 Lollichop Lollichop
 Loose Cannon Loose Cannon
 Lugermorph Lugermorph
 Machina Machina
 Mad Milk Mad Milk
 Manmelter Manmelter
 Mantreads Mantreads
 Market Gardener Market Gardener
 Maul Maul
 Medi Gun: Multiple Skins Medi Gun: Multiple Skins
 Memory Maker Memory Maker
 Mutated Milk Mutated Milk
 Natascha Natascha
 Necro Smasher Necro Smasher
 Neon Annihilator Neon Annihilator
 Nessie's Nine Iron Nessie's Nine Iron
 Nostromo Napalmer Nostromo Napalmer
 Original Original
 Overdose Overdose
 Pain Train Pain Train
 PDA Build/Demolish Tool PDA Build/Demolish Tool
 Persian Persuader Persian Persuader
 Phlogistinator Phlogistinator
 Pistol Pistol
 Pomson 6000 Pomson 6000
 Postal Pummeler Postal Pummeler
 Powerjack Powerjack
 Pretty Boy's Pocket Pistol Pretty Boy's Pocket Pistol
 Prinny Machete Prinny Machete
 Quackenbirdt Quackenbirdt
 Quick-Fix Quick-Fix
 Rainblower Rainblower
 Razorback Razorback
 Red-Tape Recorder Red-Tape Recorder
 Rescue Ranger Rescue Ranger
 Reserve Shooter Reserve Shooter
 Revolver: Multiple Skins Revolver: Multiple Skins
 Righteous Bison Righteous Bison
 Robo-Sandvich Robo-Sandvich
 Rocket Jumper Rocket Jumper
 Rocket Launcher: Multiple Skins Rocket Launcher: Multiple Skins
 Sandman Sandman
 Sandvich: Multiple Skins Sandvich: Multiple Skins
 Sapper Sapper
 Saxxy Saxxy
 Scattergun: Multiple Skins Scattergun: Multiple Skins
 Scorch Shot Scorch Shot
 Scotsman's Skullcutter Scotsman's Skullcutter
 Scottish Handshake Scottish Handshake
 Scottish Resistance Scottish Resistance
 Second Banana Second Banana
 Self-Aware Beauty Mark Self-Aware Beauty Mark
 Shahanshah Shahanshah
 Sharp Dresser Sharp Dresser
 Sharpened Volcano Fragment Sharpened Volcano Fragment
 Short Circuit Short Circuit
 Shortstop Shortstop
 Shotgun: Multiple Skins Shotgun: Multiple Skins
 Shovel Shovel
 SMG: Multiple Skins SMG: Multiple Skins
 Snack Attack Snack Attack
 Sniper Rifle: Multiple Skins Sniper Rifle: Multiple Skins
 Soda Popper Soda Popper
 Solemn Vow Solemn Vow
 Southern Hospitality Southern Hospitality
 Splendid Screen Splendid Screen
 Spy-cicle Spy-cicle
 Sticky Jumper Sticky Jumper
 Sun-on-a-Stick Sun-on-a-Stick
 Sydney Sleeper Sydney Sleeper
 Syringe Gun Syringe Gun
 Thermal Thruster Thermal Thruster
 Third Degree Third Degree
 Three-Rune Blade Three-Rune Blade
 Tomislav: Multiple Skins Tomislav: Multiple Skins
 Tide Turner Tide Turner
 Toolbox Toolbox
 Tribalman's Shiv Tribalman's Shiv
 Übersaw: Multiple Skins Übersaw: Multiple Skins
 Ullapool Caber Ullapool Caber
 Unarmed Combat Unarmed Combat
 Vaccinator Vaccinator
 Vita-Saw Vita-Saw
 Wanga Prick Wanga Prick
 Warrior's Spirit Warrior's Spirit
 Widowmaker Widowmaker
 Winger Winger
 Wrangler: Multiple Skins Wrangler: Multiple Skins
 Wrap Assassin Wrap Assassin
 Wrench: Multiple Skins Wrench: Multiple Skins
 Your Eternal Reward Your Eternal Reward
Action Slot Items
Needed Action slot items
All Class Action Slot Items:
- None








