Team Fortress 2

Team Fortress 2

721 ratings
[Tool] TFMV 1.7 - Easily preview TF2 loadouts, take screenshots, test paints, item clipping, create backpack icons...
By neodos
This tutorial shows you how to use TFMV (for Windows), a tool created to make it easier to load items and attach them to a TF2 character in HLMV (model viewer), test workshop items, paints and combinations etc for workshop artists or TF2 players who want to preview loadouts.

TFMV will manage Valve's model viewer "HLMV", easily load models/materials, workshop items, vpk, qc, mdl, test paints, clipping, take screenshots, generate a chart of all the paints for items etc
Download & Installation

Download and install TFMV, you should find a shortcut to start TFMV in your desktop and start menu.

Using TFMV
Select a class and an item slot in the ITEMS section to load the list of items for that category, then select items from the list to be added into the Loadout section, once you have selected the items click "Loadout to HLMV" to load into the model viewer.

HLMV should open with your loadout and TFMV will switch to the Skins section where you can switch the team color and change the paints for each item.

Here's an example of using TFMV, first we pick some items then click "Loadout to HLMV" to preview it.

You can find advanced settings on a hidden tab, click the button [>>] to show the adv settings, when in the Skins section, the advanced settings will switch to the advanced tools.
Paints Chart Tool
This tool lets you generate a chart of all the paints, you'll find it in the advanced settings tab once you have a loadout in TFMV, click the button >> to open the advanced settings tab.

Set the character pose and framing in HLMV then click "start" in TFMV, do not touch the mouse or keyboard while TFMV is taking the screenshots, as it needs to focus on the HLMV window to refresh the paints, you can cancel at any time if needed.

Untick the box "merge screenshots into a mosaic" if you prefer to have separate images for each paint.

The image(s) will be saved in the screenshots folder, click the folder icon button to open the folder:
Using HLMV
This part of the guide only covers some basics of what you need to move a bit around HLMV.
For information on how to use HLMV see the SDK wiki article:

Camera controls:

LMB drag in the center of the viewport will orbit the camera.
LMB drag on the edge of the viewport will roll the camera.
Ctrl+LMB drag will orbit the light source.
RMB drag will dolly the camera back/forward.
Shift+LMB drag with pan the camera left/right up/down.

Changing the character animation:

1- Go to the Sequence tab.
2- Select the animation.
3- Set the animation play speed.
4- Scroll through the animation frames and stop at a frame.
Troubleshooting / FAQ
  • TFMV crashes when I start it!
    Make sure you have NetFramework 4[] installed.

  • Can't download the schema
    If you have an antivirus or firewall make sure its not blocking TFMV to download the schema.

  • How can you load Unusual effects? or weapon skins?
    Unfortunately its not possible, Valve's HLMV model viewer doesn't support particle effects aka unusual effects.
    You can however use to preview those :)

  • Problem/Solution is not listed here?
    Check the comments to see if your question has been answered if not asked there.

    If you found a bug and you see that it hasn't been already pointed out in the comments, post about it too! :)
< >
neodos  [author] 8 hours ago 
As far as I know you can't simulate ragdoll physics in HLMV, you probably have to test them ingame.
In HLMV you can view the model's properties and view/set the max angle rotation for the ragdoll joints.
OmegaKatze Aug 19 @ 2:43pm 
how do the ragdolls work in tf mv?
neodos  [author] Jul 18 @ 6:43am 
@ Acquaintance
Sorry, I removed support for badges a while ago because they were very tricky to handle and would make TFMV very slow, don't think I'll be adding back support for them.

You could load them manually into TFMV/HLMV though, it takes a bit of work but if you really need or want to see these badges, here's a little tutorial:

@ Bearnaut
Sorry for the late reply, that sort of issue is very tricky for me to troubleshoot on my end and very random/rare so I don't think I can fix it.

However as a quick fix, I have uploaded the latest schema and icons Here [ ]

Here how to install it:
In the windows file/folder browser, go to the folder: C:\Users\YourUserName\AppData\Roaming\TFMV\

To install the schema, open the zip file and extract the folder "tf2_schema" contained in the zip, onto the original tf2_schema (overwrite it and its files) located in "Roaming\TFMV\".

Close TFMV and restart it, it should load the schema now.
Acquaintance Jul 18 @ 1:34am 
I can't seem to find badges and such in the Cosmetics tab. Am I just looking at the wrong place or is it not there at all?
brnt Jun 5 @ 5:56am 
I made an exception for TFMV on both my antivirus and firewall but the schema still doesn't download
neodos  [author] May 29 @ 9:09am 
Select the item icon in the loadout list and click this icon (on the left of the loadout icons list)
Jimbob Doohicky May 27 @ 5:54pm 
Where is the "use as main" button in version 1.7? im trying to create a backpack icon
Jehovius May 25 @ 6:26am 
Does it have an application on mobile already?
neodos  [author] May 21 @ 2:30am 
I tried having TFMV control HLMV but it wasn't viable, doing so requires using a technique that most anti-viruses see as a threat and anyways is too slow and sometimes would cause HLMV to crash.
Ball Pit May 21 @ 1:41am 
I understand the problem with HLMV, but what if instead of having to manually setting the pose after changing background colors, have TFMV do it automaticly?