Difference between revisions of "Itemtest"

From Valve Developer Community
Jump to: navigation, search
Line 116: Line 116:
once you're happy with how it looks on the character using the [[itemtest map]], enter the steam workshop to publish your file.
once you're happy with how it looks on the character, press the "steam workshop" button.

Revision as of 22:43, 14 October 2011

Itemtest is a utility for easily compiling a standard .obj and .tga file into a format that can published to the steam workshop. (it automatically generates a .zip archive containing .mdl, .vtf .vmt, .dmx and .qc files)

to get it on your machine you must first install and setup the Source Developement Kit.

Download and Installation

to access the item test utility, double click on "Source SDK" from the tools section of your steam library.

Image 00.png

this brings up the SDK application launcher. you should see itemtest in the list. be sure the set the current game the installed game you wish to submit your item to. for this example we'll assune Team Fortress 2.

Itemtest image 01.png

when the item test first launches, there are a series of empty forms to fill out. a red box mean that form is invalid.

Itemtest image 02.png

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.

Itemtest image 03.png

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.

Itemtest image 04.png

even though you have selected your model, the forms are still invalid, this is because you MUST create at least one level of detail. This is 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

Itemtest image 05.png

Select the Texture files. set weather the item is a primary, secondary or melee weapon. hats are primary.

Itemtest image 06.png

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. and set how you would like those alpha textures to be used. specular, paintable, nothing etc. once all forms are valid, click next

Itemtest image 07.png

Compile your model. press the compile button!

Itemtest image 08.png

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.

Itemtest image 09.png

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 menu. Itemtest image 9.1.jpg

press the "Load Test Map" button to enter the game in itemtest mode. Itemtest image 9.2.jpg Itemtest image 9.3.jpg

Once you are in the itemtest map, press the f7 key to bring up the item testing menu. Itemtest image 9.4.jpg

select the class and type of item you wish to equip. click the add button on the headgear row. Itemtest image 9.5.jpg

click the browse button and select your compiled .mdl file.

  • ...remember when I said you'll need this location later?

Itemtest image 9.6.jpg

choose the equip options for your item. be sure to hide intersecting parts of the characters if needed. Itemtest image 9.7.jpg

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. Itemtest image 9.8.jpg

once you're happy with how it looks on the character, press the "steam workshop" button.

Itemtest image 10.png

Title will be the name the item has in the store and in the steamworkshop. Description is a short sentence that makes people want to buy your item. be creative. 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!

Itemtest image 11.png

good luck! Tell your friends about your submission to help it get Valve's attention for consideration in the store!