Material map compile flags: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (added language bar. also some formatting.)
m (→‎%NoPortal: Portal2series -> Portalseries)
Line 88: Line 88:


===%NoPortal===
===%NoPortal===
{{only|{{Portal2series}}}}<br>
{{Portalseries|only}}<br>
Makes the texture non-portalable unless [[Gel (Portal 2)|Conversion Gel]] is used.
Makes the texture non-portalable unless [[Gel (Portal 2)|Conversion Gel]] is used.



Revision as of 10:51, 19 July 2022

English (en)中文 (zh)Translate (Translate)

Several special shader parameters exist that start with a % sign instead of $. These are read by the compile tools to alter the properties of the face or the brush they are attached to. Most are intended to produce the special tools/ textures, but they may also be used for other materials. All are boolean properties. These cannot be affected by Proxies.

See also Tool Textures for more detail about the propeties of individual materials.

Example:

LightmappedGeneric
{
  $basetexture developer/custom_clip
  %compileclip 1
}

Exclusive Flags

Only one of the following flags may be set on any given material.

%CompileClip (toolsclip)

Toolsclip.gif Makes the brush block only players and NPCs. This is equivalent to a combination of PlayerClip and NPCClip.

%CompileNoChop

Prevents "subdividing patches" on the surface. This presumably affects how the face is converted to triangles.

%CompileNPCClip (toolsnpcclip)

Toolsnpcclip.gif Makes the brush block only NPCs. This implies NoLight and NoDraw.

Note.pngNote:Counter-Strike: Global Offensive Blocks bots, even though they are players.

%CompileOrigin (toolsorigin) Obsolete

Toolsorigin.gif Sets the origin of a brush entity. This is deprecated in Source Source and Source 2 Source 2. In GoldSrc GoldSrc, origin brushes were used to set the rotation origin of rotating entities.

%CompileTrigger (toolstrigger)

Toolstrigger.gif Makes the brush suitable for Triggers.

%CompileSkip(toolsskip)

Toolsskip.gif Removes the face during compilation, making the brush into sets of planes.

%CompileSky (toolsskybox)

Toolsskybox.gif Makes the face render the (2D/3D) Skybox and emit light_environment light.

%Compile2DSky (toolsskybox2d)

Toolsskybox2d.gif Makes the face render the 2D Skybox only, in addition to emitting light_environment light.

%PlayerClip (toolsplayerclip)

Toolsplayerclip.gif Makes the brush only block players.

%CompileNoLight (nolight)

Toolsblack.gif(in all games since Alien Swarm)(also in Source 2013)
Disables generating lightmaps for a brush face. Useful for materials that don't need lighting info or are always invisible. This is disabled on water materials. Valve introduced this parameter with Alien Swarm Alien Swarm, using it for the black areas you see in the levels.

Additive Flags

Multiple of the following flags may be applied to any given material.

%CompileBlockLOS (toolsblocklos)

Toolsblocklos.gif Makes the brush block only the line of sight for NPCs.

Note.pngNote:Also works for bots in Counter-Strike: Global Offensive.

%CompileDetail

Forces the brush to no longer cut visleafs, similar to func_detail.

%CompileHint (toolshint)

Toolshint.gif Makes the face hint-cut visleafs. This implies NoLight and NoDraw.

%CompileInvisible (toolsinvisible)

Toolsinvisible.gif Makes a surface behave like NoDraw, but still allows bullets to pass through it, except in Counter-Strike: Global Offensive Counter-Strike: Global Offensive. This also implies NoLight.

%CompileLadder (toolsladder)

Toolsladder.gif Makes the brush usable as a func_ladder.

%CompileNoDraw (toolsnodraw)

Toolsnodraw.gif Makes a brush behave like tools/toolsnodraw.

%CompileNonSolid

Makes the brush not solid to anything.

Icon-Bug.pngBug:Left 4 Dead 2 Turns brushes non-solid and invisible but still casts shadows.  [todo tested in ?]

%CompileNoShadows

Prevents shadows from being cast onto the texture.

%CompilePassBullets

Makes the brush behave like a grating, allowing bullets to pass through but blocking other objects. Useful for foliage or metal grates.

Icon-Bug.pngBug:Non-functional in Counter-Strike: Global Offensive Counter-Strike: Global Offensive and Counter-Strike: Source Counter-Strike: Source.  [todo tested in ?]

%CompileTeam

See also:  %compileteam

(only in Left 4 Dead 2)
Decides which team should be affected by this tool texture. Seen in climb_versus, a ladder for infected only.

%CompileWater, %CompileSlime

Marks the brush as a water-type material. Makes it non-solid, allows swimming inside, etc. The slime variant switches to green splash particles. If %CompileKeepLight is also set, the brush will retain its lighting data.

Icon-Bug.pngBug:Left 4 Dead 2 %CompileSlime uses default water splash particles.  [todo tested in ?]

%NoPortal

(only in Portal series)
Makes the texture non-portalable unless Conversion Gel is used.

%NoPaint

(only in Portal 2)
Makes the material unable to be painted by Gel.

%CompileStairs

(only in INFRA)
Makes brushwork traversable up to an angle of 63.4349488, as opposed to the usual 45°.