Itemtest
Itemtest is a utility for easily compiling a standard .obj and .tga file into a format that can be published to the steam workshop. It automatically generates a .zip archive containing .mdl, .vtf .vmt, .dmx and .qc files. It's possible for the creator of the model to sell their item on the Steam workshop.
Note:At this time only Team Fortress 2 supports the Itemtest Tool.
Bug:If you run this without TF2 installed and run episode 2 or any ep2 based game the flashlight instead will be replaced with a [] square. The only to resolve this is to restart your computer, the cause of this bug is unknown. [todo tested in?]
Confirm:if this is really the cause and solution to this issueTo get it on your machine, you must first install and run the Source SDK from the tools section in your Steam library. See SDK Installation for more details.
Itemtest Editor
This brings up the SDK application launcher. You should see itemtest in the list. Be sure to set the current game the installed game you wish to submit your item to. For this example we'll assume Team Fortress 2.
When the item test first launches, there are a series of empty forms to fill out. A red box mean that form is invalid.
Set the item a name, this will be the asset name the game uses. Choose which class the item will be for, i.e. pyro. If it is a hat, check the box to skin it to the head bone. Once all the forms are valid, press next. You will not be able to press next if one of the forms is invalid.
Select the Geometry files. Click the "browse for lod0" button. This will bring up a file browser for you to browse to the location of your .obj 3d model file. "lod0" is the model that will be seen when you are close up to the character.
Even though you have selected your model, the forms are still invalid, this is because you MUST create at least one level of detail. LOD Models are a low resolution version of your model (lod1) to be seen from a distance. This model must be less polygons than lod0 and use the same texture (we usually remove at least half the polygons of lod0).
Once all forms are valid, click next.
Select the Texture files. Set whether the item is a primary, secondary or melee weapon. Hats are primary.
Choose the texture you want for the color of your model. Your model must have at least a color texture. Optionally you may choose a normal map. If so then set how you would like those alpha textures to be used (specular, paintable, nothing, etc.) Once all forms are valid, click next.
To compile your model press the compile button!
If you have done everything right, the items should have compiled. It's a good idea to press the "Dismiss and Continue button" and check that your model has compiled properly. Press the "Launch HLMV" button.
Your model is almost ready to publish!
To find the .zip you will be publishing and testing in the itemtest map, press "Explore to the models directory" button. It's a good idea to copy the path so you can use it from the in-game publishing tool*
- You'll need this location later...
It's also a good idea to save a snapshot of your model from HLMV at this point. You'll want to upload it when you publish.
Now it's time to launch Team Fortress 2 and see what your item looks like in the game!!
To do this, press the "Steam Workshop" button in the main Team Fortress 2 menu.
Press the "Load Test Map" button to enter the game in itemtest mode.
Once you are in the itemtest map, press the f7 key to bring up the item testing menu.
Select the class and type of item you wish to equip. Click the add button on the headgear row.
Click the browse button and select your compiled .mdl file.
- ...Remember when I said you'll need this location later?
Choose the equip options for your item, be sure to hide intersecting parts of the characters if needed.
Now you're finally ready to see the item in-game!! But only on your local machine at this point, press the "Apply Test Items" button.
Once you're happy with how it looks on the character, press the "Steam Workshop" button.
Title will be the name the item has in the store and in the Steam workshop. Description is a short sentence that makes people want to buy your item. Browse for a preview image that will be seen in the store (snapshots from HLMV are common) Browse for the .zip file that itemtest created. When you are ready for the world to see your item, push the publish button!
Good luck! Tell your friends about your submission to help it get Valve's attention for consideration in the store!
