Material surface properties: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (Nescius moved page Material surface properties/en to Material surface properties without leaving a redirect)
(→‎Types: reformatted table to put "availability" to the side. Added bugnote to "Snow", added "not in l4d2" to all materials that were in hl2 but not in l4d2.)
Line 16: Line 16:
===Special===
===Special===
! Description
! Description
! Availability
|-
|-
|Blockbullets
|Blockbullets
|{{in|{{csgo}}}} Blocks bullets entirely, because the <code>Tools/ToolsBlockBullets</code> doesn't really block bullets
|Blocks bullets entirely, because the <code>Tools/ToolsBlockBullets</code> doesn't really block bullets
|{{in|{{csgo}}}}
|-
|-
|Default
|Default  
|
|
|
|-
|-
|Default_silent
|Default_silent  
|For invisible collision materials, like sky.
|For invisible collision materials, like sky.
|
|-
|-
|Floatingstandable
|Floatingstandable  
|This one is used for puzzles where we want something that floats but the player can stand on without it sinking beneath the water.
|This one is used for puzzles where we want something that floats but the player can stand on without it sinking beneath the water.
|
|-
|-
|Item
|Item  
|Small med kit, smaller tech items, battery.
|Small med kit, smaller tech items, battery.
|
|-
|-
|Ladder
|Ladder  
|Ladder is a fake material for walking on ladders.
|Ladder is a fake material for walking on ladders.
|
|-
|-
|No_decal
|No_decal  
|
|
|
|-
|-
|Player
|Player  
|Special materials for player controller.
|Special materials for player controller.
|
|-
|-
|Player_control_clip
|Player_control_clip  
|Special materials for player controller.
|Special materials for player controller.
|
|-
|-
|Bat<br>Blade<br>Chainsaw<br>Cricketbat<br>Crowbar<br>Fireaxe<br>Fryingpan<br>Golfclub<br>Guitar<br>Pitchfork<br>Shovel<br>Sword
|Bat<br>Blade<br>Chainsaw<br>Cricketbat<br>Crowbar<br>Fireaxe<br>Fryingpan<br>Golfclub<br>Guitar<br>Pitchfork<br>Shovel<br>Sword
| {{in|{{l4d2}}}} Like "Weapon" but used for the melee weapons to give specific sounds when they are dropped.
|Like "Weapon" but used for the melee weapons to give specific sounds when they are dropped.
|{{in|{{l4d2}}}} 
|-
|-
!
!
===Concrete/Rock===
===Concrete/Rock===
! Description
! Description
! Availability
|-
|-
|Baserock
|Baserock  
|''missing?''
|''missing?''
|{{not|{{l4d2}}}}
|-
|-
|Boulder
|Boulder  
|Will cause material glitches if used in models
|Will cause material glitches if used in models
|
|-
|-
|Brick
|Brick  
|
|
|
|-
|-
|Concrete
|Concrete  
|
|
|
|-
|-
|Concrete_block
|Concrete_block  
|9x12 prefabricated concrete cinder blocks.
|9x12 prefabricated concrete cinder blocks.
|
|-
|-
|Gravel
|Gravel  
|
|
|
|-
|-
|Rock
|Rock  
|Solid rock (small sounds).
|Solid rock (small sounds).
|
|-
|-
|Sheetrock
|Sheetrock  
|{{in|{{l4d2}}{{csgo}}}}
|
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
|Cavern_rock
|Cavern_rock
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
!
!
===Metal===
===Metal===
! Description
! Description
! Availability
|-
|-
|Canister
|Canister  
|Large oxygen tank, propane tank, welding tank.
|Large oxygen tank, propane tank, welding tank.
|
|-
|-
|Chain
|Chain  
|Metal chain.
|Metal chain.
|
|-
|-
|Chainlink
|Chainlink  
|Chainlink fencing material.
|Chainlink fencing material.
|
|-
|-
|Combine_metal
|Combine_metal  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Crowbar
|Crowbar  
|
|
|
|-
|-
|Floating_metal_barrel
|Floating_metal_barrel  
|
|
|
|-
|-
|Grenade
|Grenade  
|Solid hand grenade.
|Solid hand grenade.
|
|-
|-
|Gunship
|Gunship  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Metal
|Metal  
|
|
|
|-
|-
|Metal_barrel<br>metal_sand_barrel {{in|{{csgo}}}}
|Metal_barrel<br>metal_sand_barrel  
|Larger metal barrel, metal oil drum.
|Larger metal barrel, metal oil drum.
|{{in|{{csgo}}}}
|-
|-
|Metal_bouncy
|Metal_bouncy  
|
|
|
|-
|-
|Metal_Box
|Metal_Box  
|Smaller metal box (< 2' width/height/depth)
|Smaller metal box (< 2' width/height/depth)
|
|-
|-
|Metal_seafloorcar
|Metal_seafloorcar  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Metalgrate
|Metalgrate  
|Metal grating, used for decking
|Metal grating, used for decking
|
|-
|-
|Metalpanel
|Metalpanel  
|Thick solid steel panel - used for solid wall, floor, machine construction.
|Thick solid steel panel - used for solid wall, floor, machine construction.
|
|-
|-
|Metalvent
|Metalvent  
|~1mm thick metal
|~1mm thick metal
|
|-
|-
|Metalvehicle
|Metalvehicle  
|
|
|
|-
|-
|Paintcan
|Paintcan  
|Smaller metal can
|Smaller metal can
|
|-
|-
|Popcan
|Popcan  
|Small aluminum can, full.
|Small aluminum can, full.
|
|-
|-
|Roller
|Roller  
|Roller NPC
|Roller NPC
|
|-
|-
|Slipperymetal
|Slipperymetal  
|
|
|
|-
|-
|Solidmetal
|Solidmetal  
|{{note|Almost nothing is solid metal - so metal is sheet metal}}
|{{note|Almost nothing is solid metal - so metal is sheet metal}}
|
|-
|-
|Strider
|Strider  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Weapon
|Weapon  
|Sounds for when weapons drop.
|Sounds for when weapons drop.
|
|-
|-
|Strongman_bell
|Strongman_bell
|{{in|{{l4d2}}{{csgo}}}} Sounds like a boxing ring bell when hit.
| Sounds like a boxing ring bell when hit.
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
|Slipperyslide
|Slipperyslide
|{{in|{{l4d2}}{{csgo}}}} Like SlipperyMetal, but uses SolidMetal sounds.
| Like SlipperyMetal, but uses SolidMetal sounds.
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
|Metal_shield
|Metal_shield
|{{in|{{csgo}}}} Uses weapon sounds.
| Uses weapon sounds.
|{{in|{{csgo}}}}  
|-
|-
!
!
===Wood===
===Wood===
! Description
! Description
! Availability
|-
|-
|Wood
|Wood  
|Generic wood {{note|materials should use wood_box, wood_crate, wood_plank, wood_panel etc.}}
|Generic wood {{note|materials should use wood_box, wood_crate, wood_plank, wood_panel etc.}}
|
|-
|-
|Wood_Box
|Wood_Box  
|
|
|
|-
|-
|Wood_Crate
|Wood_Crate  
|Large crate, large wood furniture (bookcases, tables).{{Portal2|since}}{{also|{{tf2}}{{l4dseries}}}}
|Large crate, large wood furniture (bookcases, tables).
|{{Portal2|since}}
{{also|{{tf2}}{{l4dseries}}}}
|-
|-
|-
|-
|Wood_Dense
|Wood_Dense
|{{in|{{csgo}}}}
|
|{{in|{{csgo}}}}  
|-
|-
|Wood_Furniture
|Wood_Furniture
|small wood furniture - chairs, small tables.
|small wood furniture - chairs, small tables.
|
|-
|-
|Wood_LowDensity
|Wood_LowDensity
|Small crate.{{Portal2|since}} {{l4dseries|also}} {{tf2|also}}
|Small crate.  
|{{Portal2|since}}
{{also|{{l4dseries}}{{tf2}}}}
|-
|-
|Wood_Plank
|Wood_Plank  
|Wood board, floorboard, plank.
|Wood board, floorboard, plank.
|
|-
|-
|Wood_Panel
|Wood_Panel  
|Plywood panel, wood door panel.
|Plywood panel, wood door panel.
|
|-
|-
|Wood_Solid
|Wood_Solid  
|Solid 6x6 or greater block, post or tree.
|Solid 6x6 or greater block, post or tree.
|
|-
|-
|Woodladder
|Woodladder
|{{in|{{l4d2}}{{csgo}}}} A ladder that makes wood sounds when climbing.
| A ladder that makes wood sounds when climbing.
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
!
!
Line 202: Line 264:
===Terrain===
===Terrain===
! Description
! Description
! Availability
|-
|-
|Dirt
|Dirt  
|
|
|
|-
|-
|Grass
|Grass  
|
|
|
|-
|-
|Gravel
|Gravel  
|
|
|
|-
|-
|Mud
|Mud  
|
|
|
|-
|-
|Quicksand
|Quicksand  
|
|
|
|-
|-
|Sand
|Sand  
|
|
|
|-
|-
|Slipperyslime
|Slipperyslime  
|
|
|
|-
|-
|Antlionsand
|Antlionsand  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Sugarcane
|Sugarcane
|{{in|{{l4d2}}{{csgo}}}}
|
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
!
!
===Liquid===
===Liquid===
! Description
! Description
! Availability
|-
|-
|Slime
|Slime  
|
|
|
|-
|-
|Water
|Water  
|
|
|
|-
|-
|Wade
|Wade  
|Wade is a water material for walking in/on water at knee height.
|Wade is a water material for walking in/on water at knee height.
|
|-
|-
|Puddle
|Puddle  
|When shot, spawns refracting water splash particles
|
|
|-
|-
|Wet
|Wet
|{{in|{{l4d2}}{{csgo}}}} Doesn't actually do anything.
| Doesn't actually do anything.
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
!
!
===Frozen===
===Frozen===
! Description
! Description
! Availability
|-
|-
|Ice
|Ice  
|
|
|
|-
|-
|Snow
|Snow  
|{{bug|tested={{l4d2}}|Missing sound files for footsteps}}
|
|
|-
|-
Line 262: Line 343:
===Organic===
===Organic===
! Description
! Description
! Availability
|-
|-
|Alienflesh
|Alienflesh  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Antlion
|Antlion  
|
|
|{{not|{{l4d2}}}}
|-
|-
|Antlion_eggshell
|Antlion_eggshell
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Armorflesh
|Armorflesh  
|Flesh for physics, metal for bullet fx.
|Flesh for physics, metal for bullet fx.
|
|-
|-
|Bloodyflesh
|Bloodyflesh  
|
|
|
|-
|-
|Flesh
|Flesh  
|Medium-sized body.
|Medium-sized body.
|
|-
|-
|Foliage
|Foliage  
|
|
|
|-
|-
|Foliage_leaf
|Foliage_leaf
|{{in|{{l4d2}}}}Same as Foliage, but uses Foliage sounds, instead of Dirt sounds.
|Same as Foliage, but uses Foliage sounds, instead of Dirt sounds.
|{{in|{{l4d2}}}}
|-
|-
|Hunter
|Hunter
|{{in|{{hl2ep2}}}}
|
|-|-
|{{in|{{hl2ep2}}}}  
|-
|Watermelon
|Watermelon
|
|
|{{not|{{l4d2}}}}
|-
|-
|Zombieflesh
|Zombieflesh
|
|
|{{not|{{l4d2}}}}
|-
|-
!
!
===Manufactured===
===Manufactured===
! Description
! Description
! Availability
|-
|-
|Advisor_shield
|Advisor_shield
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Asphalt
|Asphalt  
|''missing?''
|''missing?''
|
|-
|-
|Glass
|Glass  
|Pane of glass, computer screen, window, glass door...
|Pane of glass, computer screen, window, glass door...
|
|-
|-
|Glassbottle
|Glassbottle  
|Glass soda bottle, cup, plate, jar...
|Glass soda bottle, cup, plate, jar...
|
|-
|-
|Glassfloor
|Glassfloor
|{{in|{{csgo}}}}Like Glass, but with a normal friction value.
|Like Glass, but with a normal friction value.
|{{in|{{csgo}}}}  
|-
|-
|Combine_glass
|Combine_glass  
|
|
|
|-
|-
|Tile
|Tile  
|
|
|
|-
|-
|Paper
|Paper  
|
|
|
|-
|-
|Papercup
|Papercup  
|
|
|
|-
|-
|Cardboard
|Cardboard  
|
|
|
|-
|-
|Plaster
|Plaster  
|Drywall, office wall material, sheetrock.
|Drywall, office wall material, sheetrock.
|
|-
|-
|Plastic_barrel
|Plastic_barrel  
|Larger plastic barrel, hollow, soft plastic.
|Larger plastic barrel, hollow, soft plastic.
|
|-
|-
|Plastic_barrel_buoyant
|Plastic_barrel_buoyant  
|
|
|
|-
|-
|Plastic_Box
|Plastic_Box  
|Small - Medium plastic box, hard plastic.
|Small - Medium plastic box, hard plastic.
|
|-
|-
|Plastic
|Plastic  
|Smaller generic hard plastic.
|Smaller generic hard plastic.
|
|-
|-
|Rubber
|Rubber  
|Solid rubber floor mat, solid rubber tire.
|Solid rubber floor mat, solid rubber tire.
|
|-
|-
|Rubbertire
|Rubbertire  
|Hollow rubber tire
|Hollow rubber tire
|
|-
|-
|Slidingrubbertire
|Slidingrubbertire  
|
|
|
|-
|-
|Slidingrubbertire_front
|Slidingrubbertire_front  
|
|
|
|-
|-
|Slidingrubbertire_rear
|Slidingrubbertire_rear  
|
|
|
|-
|-
|Jeeptire
|Jeeptire  
|
|
|
|-
|-
|Brakingrubbertire
|Brakingrubbertire  
|
|
|
|-
|-
|Jalopy
|Jalopy
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Jalopytire
|Jalopytire
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Slidingrubbertire_jalopyfront
|Slidingrubbertire_jalopyfront
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Slidingrubbertire_jalopyrear
|Slidingrubbertire_jalopyrear
|{{in|{{hl2ep2}}}}
|
|{{in|{{hl2ep2}}}}  
|-
|-
|Clay
|Clay
|{{in|{{l4d2}}{{csgo}}}} Ceramic jug, mug.
| Ceramic jug, mug.
|{{in|{{l4d2}}{{csgo}}}}  
|-
|-
|Porcelain
|Porcelain  
|Tubs, urinals, sinks
|Tubs, urinals, sinks
|
|-
|-
|Upholstery
|Upholstery  
|
|
|
|-
|-
!
!
===Miscellaneous===
===Miscellaneous===
! Description
! Description
! Availability
|-
|-
|Carpet
|Carpet  
|
|
|
|-
|-
|Ceiling_tile
|Ceiling_tile  
|Acoustic ceiling tiles, sound baffles, crumbly plaster.
|Acoustic ceiling tiles, sound baffles, crumbly plaster.
|
|-
|-
|Computer
|Computer  
|Computer case, tech equipment case.
|Computer case, tech equipment case.
|
|-
|-
|Pottery
|Pottery  
|
|
|
|}
|}

Revision as of 12:26, 3 January 2025

English (en)Deutsch (de)Français (fr)日本語 (ja)Русский (ru)Translate (Translate)

This is the list of physical surface types that Source recognises, as defined by the files referenced in /scripts/surfaceproperties_manifest.txt.

Surface types define the physical properties of an object including friction and density, collision/footstep sounds, the effect of bullet impacts and, if the object is destructible, health and gib type.

Both materials and models define their surfaces with the $surfaceprop command.

Note.pngNote:For GoldSrc GoldSrc, use sounds/materials.txt. This file usually has documentation at the top dictating which surface types are available in the given mod.

Types

Special

Description Availability
Blockbullets Blocks bullets entirely, because the Tools/ToolsBlockBullets doesn't really block bullets (in Counter-Strike: Global Offensive)
Default
Default_silent For invisible collision materials, like sky.
Floatingstandable This one is used for puzzles where we want something that floats but the player can stand on without it sinking beneath the water.
Item Small med kit, smaller tech items, battery.
Ladder Ladder is a fake material for walking on ladders.
No_decal
Player Special materials for player controller.
Player_control_clip Special materials for player controller.
Bat
Blade
Chainsaw
Cricketbat
Crowbar
Fireaxe
Fryingpan
Golfclub
Guitar
Pitchfork
Shovel
Sword
Like "Weapon" but used for the melee weapons to give specific sounds when they are dropped. (in Left 4 Dead 2)

Concrete/Rock

Description Availability
Baserock missing? (not in Left 4 Dead 2)
Boulder Will cause material glitches if used in models
Brick
Concrete
Concrete_block 9x12 prefabricated concrete cinder blocks.
Gravel
Rock Solid rock (small sounds).
Sheetrock (in Left 4 Dead 2Counter-Strike: Global Offensive)
Cavern_rock (in Half-Life 2: Episode Two)

Metal

Description Availability
Canister Large oxygen tank, propane tank, welding tank.
Chain Metal chain.
Chainlink Chainlink fencing material.
Combine_metal (not in Left 4 Dead 2)
Crowbar
Floating_metal_barrel
Grenade Solid hand grenade.
Gunship (not in Left 4 Dead 2)
Metal
Metal_barrel
metal_sand_barrel
Larger metal barrel, metal oil drum. (in Counter-Strike: Global Offensive)
Metal_bouncy
Metal_Box Smaller metal box (< 2' width/height/depth)
Metal_seafloorcar (not in Left 4 Dead 2)
Metalgrate Metal grating, used for decking
Metalpanel Thick solid steel panel - used for solid wall, floor, machine construction.
Metalvent ~1mm thick metal
Metalvehicle
Paintcan Smaller metal can
Popcan Small aluminum can, full.
Roller Roller NPC
Slipperymetal
Solidmetal
Note.pngNote:Almost nothing is solid metal - so metal is sheet metal
Strider (not in Left 4 Dead 2)
Weapon Sounds for when weapons drop.
Strongman_bell Sounds like a boxing ring bell when hit. (in Left 4 Dead 2Counter-Strike: Global Offensive)
Slipperyslide Like SlipperyMetal, but uses SolidMetal sounds. (in Left 4 Dead 2Counter-Strike: Global Offensive)
Metal_shield Uses weapon sounds. (in Counter-Strike: Global Offensive)

Wood

Description Availability
Wood Generic wood
Note.pngNote:materials should use wood_box, wood_crate, wood_plank, wood_panel etc.
Wood_Box
Wood_Crate Large crate, large wood furniture (bookcases, tables). (in all games since Portal 2)

(also in Team Fortress 2Left 4 Dead seriesLeft 4 Dead series)

Wood_Dense (in Counter-Strike: Global Offensive)
Wood_Furniture small wood furniture - chairs, small tables.
Wood_LowDensity Small crate. (in all games since Portal 2)

(also in Left 4 Dead seriesLeft 4 Dead seriesTeam Fortress 2)

Wood_Plank Wood board, floorboard, plank.
Wood_Panel Plywood panel, wood door panel.
Wood_Solid Solid 6x6 or greater block, post or tree.
Woodladder A ladder that makes wood sounds when climbing. (in Left 4 Dead 2Counter-Strike: Global Offensive)

Terrain

Description Availability
Dirt
Grass
Gravel
Mud
Quicksand
Sand
Slipperyslime
Antlionsand (not in Left 4 Dead 2)
Sugarcane (in Left 4 Dead 2Counter-Strike: Global Offensive)

Liquid

Description Availability
Slime
Water
Wade Wade is a water material for walking in/on water at knee height.
Puddle When shot, spawns refracting water splash particles
Wet Doesn't actually do anything. (in Left 4 Dead 2Counter-Strike: Global Offensive)

Frozen

Description Availability
Ice
Snow
Icon-Bug.pngBug:Missing sound files for footsteps  (tested in: Left 4 Dead 2)

Organic

Description Availability
Alienflesh (not in Left 4 Dead 2)
Antlion (not in Left 4 Dead 2)
Antlion_eggshell (in Half-Life 2: Episode Two)
Armorflesh Flesh for physics, metal for bullet fx.
Bloodyflesh
Flesh Medium-sized body.
Foliage
Foliage_leaf Same as Foliage, but uses Foliage sounds, instead of Dirt sounds. (in Left 4 Dead 2)
Hunter (in Half-Life 2: Episode Two)
Watermelon (not in Left 4 Dead 2)
Zombieflesh (not in Left 4 Dead 2)

Manufactured

Description Availability
Advisor_shield (in Half-Life 2: Episode Two)
Asphalt missing?
Glass Pane of glass, computer screen, window, glass door...
Glassbottle Glass soda bottle, cup, plate, jar...
Glassfloor Like Glass, but with a normal friction value. (in Counter-Strike: Global Offensive)
Combine_glass
Tile
Paper
Papercup
Cardboard
Plaster Drywall, office wall material, sheetrock.
Plastic_barrel Larger plastic barrel, hollow, soft plastic.
Plastic_barrel_buoyant
Plastic_Box Small - Medium plastic box, hard plastic.
Plastic Smaller generic hard plastic.
Rubber Solid rubber floor mat, solid rubber tire.
Rubbertire Hollow rubber tire
Slidingrubbertire
Slidingrubbertire_front
Slidingrubbertire_rear
Jeeptire
Brakingrubbertire
Jalopy (in Half-Life 2: Episode Two)
Jalopytire (in Half-Life 2: Episode Two)
Slidingrubbertire_jalopyfront (in Half-Life 2: Episode Two)
Slidingrubbertire_jalopyrear (in Half-Life 2: Episode Two)
Clay Ceramic jug, mug. (in Left 4 Dead 2Counter-Strike: Global Offensive)
Porcelain Tubs, urinals, sinks
Upholstery

Miscellaneous

Description Availability
Carpet
Ceiling_tile Acoustic ceiling tiles, sound baffles, crumbly plaster.
Computer Computer case, tech equipment case.
Pottery

See also