# Skin (decl)

Skins are declarations that contain a list of material shaders coupled with a set of replacement material shaders.

Through use of a series of skin definitions one can assign a unique material to several instances of the same model.

An example would be a character with 3 different colored uniforms. A series of skin declarations would allow one to change the colored uniform that the character was textured with.

Skins are assigned to entities through the use of a “skin” key/value pair. This key/value pair can be set in the level editor or in an entity definition.

## Syntax

skin [name] {
model [model]
[original] [replacement]
}

The skin browser displays a matching skins folder containing skins intended for use with the selected model.

Skin declarations are started with a header which consists of the keyword skin followed by the location then name of the skin in the editor.

They are then followed by the body of the declaration which is enclosed in curly brackets, { and }.

An optional model keyword can be included in the declaration. This keyword defines what model the skin is intended to be used with.

When the model is defined, the skin will appear in the matching skins folder when selecting a skin in the level editor (See image).

The remainder of the skin declaration consists of a series of lines which define the name of the original material shader followed by the replacement material shader.

The original material of an object can found out by placing the object in your map then going in game and opening the console. Then type r_showSurfaceInfo 1 and look at the object. The top line will give you the model location and the second line will give you the material name in the editor.

An example for a monster’s skin declaration that uses two separate materials on its model:

skin skins/monsters/my_monster_with_green_skin
{
models/monsters/my_monster/my_monster_default_body models/monsters/my_monster/my_monster_green_body
}