VMT

A material is a .vmt text file that defines a two-dimensional surface. It contains all of the information needed for Source to simulate the surface visually, aurally, and physically. VMT stands for "Valve Material Type".

The contents of a material will fall into some or all of these categories:

1. Texture names
2. Physical surface types
3. Shader-specific parameters
4. Fallbacks
5. Proxies

A simple example

LightmappedGeneric
{
	$basetexture coast\shingle_01
	$surfaceprop gravel
}

This is a very basic shingle beach material.

1. The LightmappedGeneric shader is used, which means that the material is for use on surfaces with lightmaps - i.e. brushes.
2. The { character opens a set of parameters
3. The $basetexture parameter is given with coast\shingle_01 (a texture). This is what will be drawn on the screen.
4. $surfaceprop gives the material the physical properties of gravel.
5. The } character closes a set of parameters

It's important to remember that this material can only be used on brushes. If it needed to be used on models another version would need to be created using the VertexLitGeneric shader, for instance.

Most of the time switching materials from one shader to another is as simple as changing their first line, since a great number of parameters are shared between them. But some params only work with certain shaders - for instance, Phong effects are only available with VertexLitGeneric. The good news is that you won't encounter any critical errors if a param isn't understood by the shader.

Tip:If you ever need to use a space or tab character in a parameter value, you must wrap the whole value with "quote marks". You'll often see absolutely everything wrapped like this - save yourself some typing, as that's unnecessary.

Finding materials

Materials are stored in the materials\ folder of your game or mod. The best way to browse them is from Hammer's texture selection screen.

If you want to open Valve's material files you will first need to extract them from their GCF package with GCFScape. They tend to be stored in GCFs with 'materials' in their name.

See also

• Creating a Material
• Notepad++ syntax highlighting for materials