Missing content: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 5: Line 5:
When distributing a map or mod, care must be taken to ensure that any custom content (sounds, materials, textures, models, etc.) is also distributed, or else players will have an unintended experience.
When distributing a map or mod, care must be taken to ensure that any custom content (sounds, materials, textures, models, etc.) is also distributed, or else players will have an unintended experience.


* Missing materials/textures show up as a black-and-magenta checkerboard (in {{csgo|3.1}}, simply display as black, {{cs2|3.1}}, shows up as a flashing black-and-red checkerboard, {{hla|3.1}} shows up as red wireframe that flashes and {{hammer|3.1}}, shows up as white texture, in Hammer's [[Texture Browser]] shows up as black texture with the text "No Image").
* Missing materials/textures show up as a black-and-magenta checkerboard (in {{csgo|3.1}}, simply display as black, {{cs2|3.1}}, shows up as a flashing black-and-red checkerboard, {{hla|3.1}} shows up as red wireframe that flashes, in {{hammer|3.1}} shows up as white texture or the black-and-magenta checkerboard, in it's [[Texture Browser]] shows up as black texture with the text "No Image", or as the black-and-magenta checkerboard).
** If the cubemaps are not built, it will fallback to generic textures (a desert with orange sunset sky), or show the current map skybox textures (without the world geometry/buildings/etc.), or shown as missing textures (black-and-magenta checkerboard), or simply display as black (which is the same as reflections being disabled using {{code|mat_specular 0}}).
** If the cubemaps are not built, it will fallback to generic textures (a desert with orange sunset sky), or show the current map skybox textures (without the world geometry/buildings/etc.), or shown as missing textures (black-and-magenta checkerboard), or simply display as black (which is the same as reflections being disabled using {{code|mat_specular 0}}).
* Missing models show up as flashing red 3D text saying "Error" (in {{p2|3.1}} the 3D Error text is a light blue, in [[CS:GO]] since new updates shows up as big red box with ERROR text textured on it, {{source2|3.1}} and {{strata|3.1}} games shows the text in orange color, with Source 2 games being in a slightly different font, and {{cof|3.1}} shows up as red text saying "Error cant find model") [[File:ERROR model example on background01.jpg|thumb|200px|Red "Errors" appear behind the camera on the {{Team Fortress 2|4}} map "background01.bsp".]]
* Missing models show up as flashing red 3D text saying "Error" (in {{p2|3.1}} the 3D Error text is a light blue, in [[CS:GO]] since new updates shows up as big red box with ERROR text textured on it, {{source2|3.1}} and {{strata|3.1}} games shows the text in orange color, with Source 2 games being in a slightly different font, and {{cof|3.1}} shows up as red text saying "Error cant find model") [[File:ERROR model example on background01.jpg|thumb|200px|Red "Errors" appear behind the camera on the {{Team Fortress 2|4}} map "background01.bsp".]]

Revision as of 00:13, 13 January 2025

English (en)Translate (Translate)

Stub

This article or section is a stub. You can help by expanding it.

An example of a missing textures checkerboard.
Same example as above, but in Counter-Strike: Global Offensive CS:GO, and for missing models.

When distributing a map or mod, care must be taken to ensure that any custom content (sounds, materials, textures, models, etc.) is also distributed, or else players will have an unintended experience.

  • Missing materials/textures show up as a black-and-magenta checkerboard (in Counter-Strike: Global Offensive, simply display as black, Counter-Strike 2, shows up as a flashing black-and-red checkerboard, Half-Life: Alyx shows up as red wireframe that flashes, in Hammer shows up as white texture or the black-and-magenta checkerboard, in it's Texture Browser shows up as black texture with the text "No Image", or as the black-and-magenta checkerboard).
    • If the cubemaps are not built, it will fallback to generic textures (a desert with orange sunset sky), or show the current map skybox textures (without the world geometry/buildings/etc.), or shown as missing textures (black-and-magenta checkerboard), or simply display as black (which is the same as reflections being disabled using mat_specular 0).
  • Missing models show up as flashing red 3D text saying "Error" (in Portal 2 the 3D Error text is a light blue, in CS:GO since new updates shows up as big red box with ERROR text textured on it, Source 2 and Strata Source games shows the text in orange color, with Source 2 games being in a slightly different font, and Cry of Fear shows up as red text saying "Error cant find model")
    Red "Errors" appear behind the camera on the Team Fortress 2 Team Fortress 2 map "background01.bsp".
  • Missing sounds are absent (in Portal 2, a missing sound is indicated by Dr. Kleiner saying "Oh, fiddlesticks. What now?".)
  • Missing particles (at least in Portal 2 and Team Fortress 2) appear as a spray of red X's.
  • Missing animations appear as A-Pose.
  • Missing entities in the FGD(s) that are placed on a map in Hammer will appear as the Obsolete sprite, missing entity icons appear as white squares, and missing entity models appear as white, blue or pink cubes.

If the missing contents shipped with the Source SDK, and are not custom creations, it is likely a problem with your game configuration. See Reset the Source SDK Game Configuration for more information.

Common Problems

One very common problem is when users see a black-and-magenta checkerboard/black textured "sheen" or reflection on surfaces. This is caused by a missing texture, generally due to missing cubemaps, which must be "built" in-game prior to distributing the map.