Template:Archived page history/Tool textures (GoldSrc)/en: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Language subpage}}
{{APH|Tool textures (GoldSrc)}}
{{tip|Most mappers should use {{mono|[[#ZHLT.WAD|ZHLT.WAD]]}}, as it contains all necessary tool textures used by [[ZHLT]], [[VHLT]], and derivatives.}}
{{ModernImportant|Most of the tool textures should not be mixed with regular textures, unless you know '''exactly''' what you're doing. Main exceptions to this rule are NULL, NOCLIP, and SOLIDHINT.
{{note|Other combinations are possible, but should be used with caution to avoid unexpected results. For example, texturing a regular brush CLIP face will allow bullets to be shot through the brush, while still preventing the brush from being walked through.}}
Additionally, tool textures should not be mixed with other tool textures. Main exceptions to this rule are hint with skip, and BLACK_HIDDEN with skip.}}
== HALFLIFE.WAD ==
{| class="standard-table" width="100%"
|- style="position:sticky; top:0"
! Image
! Name
! Usage / Notes
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-curlyBLUE.png|64px]]
| align="center" | {{Code| {BLUE }}
| An invisible brush face if attached to {{Ent|func_wall}} or similar brush entity with rendermode solid. {{ModernWarning|Faces using this texture are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-curlyINVISIBLE.png|64px]]
| align="center" | {{Code| {INVISIBLE }}
| Functions same as {{Code|{BLUE}}.
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-AAATRIGGER.png|64px]]
| align="center" | {{Code| AAATRIGGER }}
| Used for [[trigger]] brush entities. {{note|The version of this texture found in {{code|XENO.WAD}} uses a [[:File:Gaben.png|cropped image]] of [[gaben|Gabe Newell's]] face instead. }}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-BLACK.png|64px]]
| align="center" | {{Code| BLACK }}
| A plain black texture for unlit areas, such as the bottom of deep pits. {{ModernWarning|Faces using this texture are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}} {{tip|If the map does not have a skybox, it sometimes is also possible (depending upon map layout) to use the SKY texture and set BLACK in the map properties for the sky texture, saving allocblock.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-CLIP.png|64px]]
| align="center" | {{Code| CLIP }}
| See [[Clip texture]]
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-ORIGIN.png|64px]]
| align="center" | {{Code| ORIGIN }}
| Treated as the origin point for rotating entities, such as {{Ent|func_door_rotating}}. {{warning|If a brush with this texture is not tied to an entity, an error will be listed during compile.}}
{{note|If a brush is tied to an entity that requires an origin brush, and the origin brush does not exist, that brush will be placed on the 0 0 0 coordinate. To fix this, simply add an origin to the brush and tie the entire brushwork, origin included, to the brush entity of your choice.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-SKY.png|64px]]
| align="center" | {{Code| SKY }}
| Used for displaying the [[Skybox (2D)|skybox]]. {{ModernBug|[[VHLT]] expects the {{Code|sky}} tool texture to be lowercase and will not compile skies correctly if the tool texture does not fit these critera.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-TRANSLUCENT.png|64px]]
| align="center" | {{Code| TRANSLUCENT }}
| Blocks VIS, but not the player.
{{note|Mirrors the brush faces inside out (more precisely, it renders the backface the same way func_water does). It is different from CONTENTWATER in the sense that translucent '''cannot''' be tied to any entity whatsoever and '''cannot''' use more than 1 texture on all of its faces without the compiler logging an error and stopping the process. Additionally, it is visible in the world, but not solid, whereas CONTENTWATER is invisible. Walking into a brush with such texture will cause a HOM effect. Finally, translucent will block VIS. {{tip|Any texture can be given this effect. Prepend the texture name with {{code|@}} (e.g {{mono|@curtains}}).}} }}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-WHITE.png|64px]]
| align="center" | {{Code| WHITE }}
| Mainly used as texture light (texture that casts lighting).
|}
 
== HLBASICS.WAD ==
{{Code|HLBASICS.WAD}} is found in {{cscz|4}} and {{dod|4}}, and is used to avoid needing to load {{Code|HALFLIFE.WAD}} for maps that don't use base {{hl|3.1}} textures. {{Clarify}} Some of these are also in {{czds|4}}, via {{Code|RITUAL_STANDARD.WAD}}, as well as in {{cscz|4}}, via {{Code|CZRITUAL_STANDARD.WAD}}.
 
{| class="standard-table"  width="100%"
|- style="position:sticky; top:0"
! Image
! Name
! Usage / Notes
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-curlyblue.png|64px]]
| align="center" | {blue
| An invisible brush face if attached to {{Ent|func_wall}} or similar brush entity with rendermode solid. {{ModernWarning|Faces using this texture are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_1.png|64px]]
| align="center" | aaa_1 ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_2.png|64px]]
| align="center" | aaa_2 ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_3.png|64px]]
| align="center" | aaa_3 ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_hurt.png|64px]]
| align="center" | aaa_hurt
| Used for mapping organization purposes. Useful if the map is shared between multiple level designers. Used with trigger_hurt.
{{warning|Using any texture other than AAATRIGGER or NULL on a trigger entity will result in lightmaps being created for the entity! Use VHLT's {{code|-nullfile}} flag to automatically retexture applicable entites to NULL in HLCSG{{how}}, or use {{mess|3.1}} to automatically retexture specific textures with AAATRIGGER before compiling{{how}}.}}
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_multi.png|64px]]
| align="center" | aaa_multi
| Used for mapping organization purposes. Useful if the map is shared between multiple level designers. Used with trigger_multiple.
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_once.png|64px]]
| align="center" | aaa_once
| Used for mapping organization purposes. Useful if the map is shared between multiple level designers. Used with trigger_once.
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_push.png|64px]]
| align="center" | aaa_push
| Used for mapping organization purposes. Useful if the map is shared between multiple level designers. Used with trigger_push.
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-aaa_push2.png|64px]]
| align="center" | aaa_push2 ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-AAATRIGGER.png|64px]]
| align="center" | AAATRIGGER
| Used for [[Trigger|trigger]] brush entities.
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-clip.png|64px]]
| align="center" | clip
| See [[Clip texture]].
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-cr_matleaf.png|64px]]
| align="center" | cr_matleaf
| {{dod}} Makes leaf sounds when walked on, if present in {{Path|sound/materials|txt}}. Tie to a {{Ent|func_wall}} with {{code|rendermode}} set to solid and {{Code|renderamt}} set to {{Code|0}} (aka invisible) to use as a clip brush and shadow caster for leafy props. {{ModernWarning|Invisible faces are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-cr_matmetal.png|64px]]
| align="center" | cr_matmetal
| {{cscz}}{{czds}}{{dod}} Makes metal sounds when walked on, if present in {{Path|sound/materials|txt}}. Tie to a {{Ent|func_wall}} with {{code|rendermode}} set to solid and {{Code|renderamt}} set to {{Code|0}} (aka invisible) to use as a clip brush and shadow caster for metalic props. {{ModernWarning|Invisible faces are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-hint.png|64px]]
| align="center" | hint ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-ORIGIN.png|64px]]
| align="center" | ORIGIN
| Treated as the origin point for rotating entities, such as {{Ent|func_door_rotating}}. {{warning|If a brush with this texture is not tied to an entity, an error will be listed during compile.}}
{{note|If you tie a brush to an entity that requires an origin brush, and the origin does not exist, that brush will be placed on the 0 0 0 coordinate. To fix this, simply add an origin to the brush and tie the entire brushwork, origin included, to the brush entity of your choice.}}
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-SKIP.png|64px]]
| align="center" | SKIP ||
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-sky.png|64px]]
| align="center" | sky
| Used for displaying the [[Skybox (2D)|skybox]].
|}
 
=== Condition Zero only ===
{| class="standard-table"  width="100%"
|- style="position:sticky; top:0"
! Image
! Name
! Usage / Notes
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-bark.png|64px]]
| align="center" | bark
| No special purpose; use cr_matbark instead.
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-black.png|64px]]
| align="center" | black
| A plain black texture for unlit areas, such as the bottom of deep pits. {{ModernWarning|Faces using this texture are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-cr_matbark.png|64px]]
| align="center" | cr_matbark
| {{cscz}} Makes wood sounds when walked on, if present in {{Path|sound/materials|txt}}. Tie to a {{Ent|func_wall}} with {{code|rendermode}} set to solid and {{Code|renderamt}} set to {{Code|0}} (aka invisible) to use as a clip brush and shadow caster for wooden props. {{ModernWarning|Invisible faces are still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-cr_matcard.png|64px]]
| align="center" | cr_matcard
| Unused, likely intended for non-existent "cardboard" material.
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-cull.png|64px]]
| align="center" | cull
| No purpose; likely used by unreleased in-house compilers.
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-leaf.png|64px]]
| align="center" | leaf ||
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-loc.png|64px]]
| align="center" | loc
| No purpose; likely used by unreleased in-house compilers.
|-
| align="center" style="user-select:none" | [[File:CZERO hlbasics-skycull.png|64px]]
| align="center" | skycull
| Functions like {{code|sky}}.
In {{czds|4}}, any exterior faces of skybox brushes must be textured with skycull for {{ent|env_rain (GoldSrc)|alt=env_rain}} and {{ent|env_snow (GoldSrc)|alt=env_snow}} to work properly.
|}
 
=== Day of Defeat only ===
{| class="standard-table"  width="100%"
|- style="position:sticky; top:0"
! Image
! Name
! Usage / Notes
|-
| align="center" style="user-select:none" | [[File:DOD hlbasics-cr_mathvymetal.png|64px]]
| align="center" | cr_mathvymetal
| {{dod}} Identical to CR_MATMETAL. {{ModernBug|Likely intended to be used for "Heavy Metal" material, available in DoD's {{Path|sound/materials|txt}}, but not used by this texture. Use IR_PIPEM8 instead.}}
|-
| align="center" style="user-select:none" | [[File:DOD hlbasics-cr_matsand.png|64px]]
| align="center" | cr_matsand
| {{dod}} Makes sand sounds when walked on, if present in {{Path|sound/materials|txt}}. Tie to a {{Ent|func_wall}} with {{code|rendermode}} set to solid and {{Code|renderamt}} set to {{Code|0}} (aka invisible) to use as a clip brush and shadow caster for sandy props, such as sandbags. {{ModernWarning|Invisible faces still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:DOD hlbasics-cr_matwood.png|64px]]
| align="center" | cr_matwood
| {{dod}} Makes wood sounds when walked on, if present in {{Path|sound/materials|txt}}. Tie to a {{Ent|func_wall}} with {{code|rendermode}} set to solid and {{Code|renderamt}} set to {{Code|0}} (aka invisible) to use as a clip brush and shadow caster for wooden props. {{ModernWarning|Invisible faces still have lightmap a created for them, despite not being noticeable. Increase texture scale to 4.0 or higher to avoid wasting allocblock.}}
|-
| align="center" style="user-select:none" | [[File:DOD hlbasics-NULL.png|64px]]
| align="center" | NULL
| Identical to ZHLT's NULL texture.
|}
 
== ZHLT.WAD ==
{{Code|ZHLT.WAD}} is used for the additional features provided by the [[ZHLT]] and [[VHLT]] compilers. It does not come with any vanilla first-party {{gldsrc|4}} title, but instead comes with ZHLT/VHLT.
 
{| class="standard-table" width="100%"
|- style="position:sticky; top:0"
! Image
! Name
! Usage / Notes
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-AAATRIGGER.png|64px]]
| align="center" | {{Code| AAATRIGGER }}
| Used for [[Trigger|trigger]] brush entities.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-BEVEL.png|64px]]
| align="center" | {{Code| BEVEL }}
|Fixes clipping errors caused by uneven terrain or brushes. This texture is experimental and is essentially replaced by the CSG parameter '''-cliptype precise'''. {{modernImportant|BEVEL is '''not''' an equivalent of NULL and can cause more clipnodes generation than NULL can! To quote Vluzacn: ''Bevel changes the clipnode of a brush in such a way that any player approaching the brush will not be blocked by the brush until his origin reached the plane that the BEVEL face lies on.'' Usage of BEVEL is not required in 99% of cases.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-BLACK.png|64px]]
| align="center" | {{Code| Black_HIDDEN }}
| Identical to {{Code|NULL}}, but has a lightmap. This texture is used to correct lightmap errors. Models get their lighting information from the lightmaps of world geometry directly below them. However, lightmaps from brush entities (like func_wall) are ignored, thereby causing the model to update its lighting information multiple times when transitioning from world geometry to brush entities (therefore taking the lightmap from world geometry below that brush entity) and vice versa (see the two zombies in Unforeseen Consequences crossing a set of grates on the floor). Additionally, light_environment overrides lightmaps completely, meaning that models will not update their lighting information properly between areas. While this is fine for models that stay within one lightmap, like an Osprey, for every other models that transition between light and dark areas, their lighting information doesn't get updated. BLACK_HIDDEN can fix lighting on those models when placed strategically, thereby eliminating incorrect updates of lighting information of models. {{ModernImportant|Proper usage of this texture is important. Set this texture to only the top face of the brush and all the other sides to skip. Tie this to a func_detail and set ''Passable'' to ''Yes''.}} {{bug|This texture is rendered in Sven Coop.}}
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-BOUNDINGBOX.png|64px]]
| align="center" | {{Code| BOUNDINGBOX }}
|Creates a bounding box around an object, thereby replacing an existing one, or creating one that doesn't exist.
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-CLIP.png|64px]]
| align="center" | {{Code| CLIP }}
| See [[Clip texture]].
{{tip|In ZHLT, VHLT, and derivatives, texturing the face of a brush with CLIP will result in allowing bullets to pass through, while still blocking everything else. This is effectively equivalent to a {{ent|func_detail|eng=goldsrc}} with {{code|zhlt_noclip}} set to 1 and a clip brush surrounding the brush.}}
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CLIPBEVEL.png|64px]]
| align="center" | {{Code| CLIPBEVEL }}
| Acts like BEVEL but for clipnodes.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CLIPBEVELBRUSH.png|64px]]
| align="center" | {{Code| CLIPBEVELBRUSH }}
| Acts like CLIPBEVEL, but affects every single face.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CLIPHULL1.png|64px]]
| align="center" | {{Code| CLIPHULL1 }}
| Like {{Code|CLIP}}, but only affects standing-up players and regular-sized NPCs.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CLIPHULL2.png|64px]]
| align="center" | {{Code| CLIPHULL2 }}
| Like {{Code|CLIP}}, but only affects large entities (including bullsquids).<br>Use to create collision for these entities when using {{code|[[HLBSP|-nohull2]]}}.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CLIPHULL3.png|64px]]
| align="center" | {{Code| CLIPHULL3 }}
| Like {{Code|CLIP}}, but only affects crouching players.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CONTENTEMPTY.png|64px]]
| align="center" | {{Code| CONTENTEMPTY }}
| Removes collision from a brush and marks it as an empty volume.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-CONTENTWATER.png|64px]]
| align="center" | {{Code| CONTENTWATER }}
| Not drawn in game, and inverts the [[normal]]s of all other faces of the brush. Usually used to simulate volumetric lighting.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-HINT.png|64px]]
| align="center" | {{Code| HINT }}
|Splits a visleaf. Applied to one or two faces. Used in combination with skip.
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-NOCLIP.png|64px]]
| align="center" | {{Code| NOCLIP }}
| Not drawn in game, and disables collision for all faces on the brush.
|-
| align="center" style="user-select:none" | [[File:DOD hlbasics-NULL.png|64px]]
| align="center" | {{Code| NULL }}
| Not drawn in game, seals [[leak]]s, and is skipped by HLRAD. Blocks visibility if used on all surfaces of the same brush. Optimally, every face that can't be seen during normal gameplay should have this texture.
 
{{Note|While no lightmap data is generated on NULL faces, NULL brushes still cast shadows, unless tied to a {{Ent|func_wall}}.}}
 
{{ModernTip|Despite common misconception, it is not necessary to use NULL on faces that don't touch [[visleaves]], as these are automatically removed by HLCSG. This means faces that are outside the map and faces that are flush with another one.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-ORIGIN.png|64px]]
| align="center" | {{Code| ORIGIN }}
| Treated as the origin point for rotating entities, such as {{Ent|func_door_rotating}}.
|-
| align="center" style="user-select:none" | [[File:CZERO+DOD hlbasics-SKIP.png|64px]]
| align="center" | {{Code| SKIP }}
|Tells the compiler to completely skip this face.
{{modernImportant|It is different from NULL! Skip does '''not''' seal the world and is non solid. Null still creates a plane and is solid in the world.}}
|-
| align="center" style="user-select:none" | [[File:HalflifeWad-SKY.png|64px]]
| align="center" | {{Code| sky }}
| Used for displaying the [[Skybox (2D)|skybox]].
 
{{ModernBug|[[VHLT]] expects the {{Code|sky}} tool texture to be lowercase and will not compile skies correctly if the tool texture does not fit these critera.}}
|-
| align="center" style="user-select:none" | [[File:ZHLTwad-SOLIDHINT.png|64px]]
| align="center" | {{Code| SOLIDHINT }}
|SOLIDHINT can be used to fix faces getting split by the visibility engine (can be seen with '''gl_wireframe 2''') due to uneven, rotated or more generally, complex brushwork that is not nicely square. Usually useful on terrain where a lot of vertex manipulation happens. Apply SOLIDHINT to the unseen part of the brush, where NULL would normally go.
|}
 
=== Missing ZHLT tool textures ===
ZHLT supports some additional tool textures that aren't found in {{Code|ZHLT.WAD}} or any official [[WAD]] file.
 
{| class="standard-table"
|-
! Image
! Name
! Usage / Notes
|-
| align="center" | N/A
| align="center" | {{Code|!cur_0}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on +X (going east). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code|!cur_90}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on +Y (going north). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code|!cur_180}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on -X (going west). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code|!cur_270}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on -Y (going south). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code|!cur_dwn}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on -Z (going down). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code|!cur_up}}
| Combines CONTENTWATER and func_pushable with a speed of 2048 units on +Z (going up). Always fullbright.
|-
| align="center" | N/A
| align="center" | {{Code| SPLITFACE }}
| Brushes with this texture will subdivide faces they touch. It can be used to eliminate bad lighting caused by opaque entities.
|}
 
== External links ==
* {{twhl|category:Tool_Textures|Tool Textures category on TWHL Wiki}}

Latest revision as of 17:34, 15 July 2024

Note.pngNote:Archived rest of page history of page Tool textures (GoldSrc)
Icon-Important.pngImportant:These pages are linked often from page history logs so Special:WhatLinksHere will not show anything.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Template:Archived_page_history/Tool_textures_(GoldSrc)/en&oldid=436652"