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.

Bug:Greyscale materials using $color as a sole source of tint will not appear colored under light cast by the player flashlight (or a projected texture). This results in textures appearing grey and desaturated. A workaround for this is to add a base grey $detail to the material and then and then use $detailtint to color it.  (tested in: , )

$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

These parameters can be used in any LightmappedGeneric material, and will affect the appearance of paint applied on top of that specific material. All materials that do not specify these will use the code-defined defaults.

$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.