LightmappedGeneric

LightmappedGeneric is a pixel shader available in all Source games. It is the shader most commonly used to render lightmapped brushes and displacements.

Models cannot use this shader; lightmapped models use the VertexLitGeneric shader.

Supported Parameters

Basics

$basetexture <texture>

Defines an diffuse texture.

$decal <boolean>

Use this material as a decal.

$detail <texture>

Detail texturing.

$surfaceprop <string>

Links the surface to a set of physical properties.

Adjustment

$basetexturetransform <matrix>

Transforms the texture before use in the material. This does not affect lightmaps on the surface.

$color <RGB matrix>

Independently scales the red, green and blue channels of an albedo.

$decalscale <float>

Same as a brush face's texture scale value: the number of units that each texel covers. Normally 0.25 or lower.

$detailscale <float>

Fits the detail texture onto the material the given number of times (default = 4). Generally used instead of $detailtexturetransform with a value of around 7 or 8 for a 128px detail texture. To independently scale the X and Y coordinates, place your values in brackets: $detailscale "[ 4 8 ]"

$detailblendfactor <normal>

Controls the amount that the detail texture affects the base texture. The precise use of this depends on the blend factor; in most cases it acts similarly to $alpha. A value of 0 usually makes the detail texture have no effect, whilst a value of 1 applies the full effect.

$detailblendmode <integer>

How to combine the detail material with the albedo.

$modelmaterial <material>

A separate VertexLitGeneric material to that will replace this one if the decal hits a model.

$pointsamplemagfilter <boolean> (only in )

Disables texture filtering.

$seamless_scale <float> (in all games since )

Mitigation for displacement texture stretching.

Transparency

$alpha <float>

Scales the opacity of an entire material.

Important:Can result in alpha sorting issues if brush is flagged as detail or tied to an entity!

$alphatest <boolean>

Specifies a mask to use to determine binary opacity.

$distancealpha <boolean> (in all games since )

Vector-like edge filtering.

$nocull <boolean>

Disables backface culling.

$translucent <boolean>

Specifies that the material should be partially see-through.

Important:Can result in alpha sorting issues if brush is flagged as detail or tied to an entity!

Lighting

$bumpmap <texture>

Specifies a texture that will provide three-dimensional lighting information for a material.

$blendmodulatetexture <texture> (in all games since )

Control sharpness and bias of blend. See Blendmodulate

$lightwarptexture <texture> (in all games since )

Per-texel color modification via a warp texture.

Note:Does not appear to be featured on LightmappedGeneric in CS:GO engine branch.

$selfillum <boolean>

Determines whether the surface is self-illuminated independent of environment lighting.

$ssbump <boolean> (in all games since )

Flags the $bumpmap as being a self-shadowing bumpmap.

Reflection

$envmap <cubemap>

Specular reflections.

$phong <boolean> (in all games since ) (also in )

Diffuse reflections.

Note:Phong is reflected only from env_cascade_light.

Todo: Are there reflections from any other light sources?.

Warning:Standard phong color is always white and doesn't depend on the color of light_environment or env_cascade_light.

Bug:Normal map does not affect phong reflections if there is empty $envmap on the material, or if you haven't assigned any brush face on env_cubemap entity.  [todo tested in?]

$phong_exp <float> (only in )

Confirm:Is this for LW's Blinn–Phong reflections?

$phong_exp2 <float> (only in )

Confirm:Is this for LW's Blinn–Phong reflections?

Paint

$paintsplatnormalmap <texture>

The paint splat normal map to use when paint is applied to the material. Defaults to paint/splatnormal_default if not specified.

$paintsplatbubblelayout <texture>

The layout texture which defines the distribution of bubbles in the paint. Defaults to paint/bubblelayout if not specified.

$paintsplatbubble <texture>

The normal mapped texture of a single bubble. Defaults to paint/bubble if not specified.

$paintenvmap <texture>

The environment map reflected in the paint. Defaults to paint/paint_envmap_hdr if not specified.

Texture Organization

%keywords <string>

Sets keywords (comma separated) filter that can be filtered in hammer for easier texture finding.

Example:%keywords "wasteland,c17" place the material under the "wasteland" and "c17" filters.

%notooltexture <boolean>

Hides the material from Hammer's texture browser.

Warning:Non-functional in Hammer++.

%tooltexture <texture>

Used to blend texture previews in Hammer.

Effect

$nofog <boolean>

Prevents fog from overdrawing a material.

Caveats

Mapbase

LightmappedGeneric materials in Mapbase should have the shader SDK_LightmappedGeneric.

See also

• WorldVertexTransition, a shader used on displacements to blend two materials together.
• LightmappedTwoTexture, a brush shader that multiplies a texture on top of another one.
• Lightmapped_4WayBlend, a shader used on displacements to blend up to four materials together.