(01) //========================================================
(02) // myrock.shader
(03) //========================================================
(04) textures/myrock/wall01
(05) {
(06) 	q3map_nonplanar
(07) 	q3map_shadeangle 60
(08) 	qer_editorimage textures/myrock/wall01_phong.tga
(09) 	{
(10) 		map $lightmap
(11) 		rgbGen identity
(12) 	}
(13) 	{
(14) 		map textures/myrock/wall01.tga
(15) 		blendFunc filter
(16) 	}
(17) }

• Lines 1-3 : are just comments which can be ignored for the moment.
  
  
• Line 4 : is the name of the shader and is applied to all brushwork surfaces which use this shader. Always use the full path when referring to shaders in the editor.
  
  
• Line 5,17 : The Q3 shader language is very strict on layout. The curly brackets are used to specify where a section starts and finish and needs to be used in pairs. If you use an open curly bracket to start something, then a closed curly bracket will be required to finish it.
  
  
• Line 6 : lets the compiler know that its OK to merge triangles that don't lie in the same plane. (ie not at the same angle to each other) The default settings for the compiler is to not merge triangles in different planes. Once the triangles are merged together the shadows can be cast correctly across the edges.
  
  
• Line 7 : specifies the triangle edge angle at which the light will be diffused. ie. The larger the specified value the more smooth all the triangles will appear as it affects more edges. (Brushwork is always broken down into triangles by the compiler)
  
  
• Line 8 : is the image used to represent this shader in the editor. (2d, 3d and texture preview panel) It is not used by the engine and often contains useful information for the Level Designer only.
  
  
• Line 9-12 : is the light stage of the shader. If not specified the shader will not have any light information (shadows) drawn.
  
  
• Line 13-16 : is the base texture used on the brushwork. Should always specify TGA file format in Shaders regardless if the file exists or not. If the engine cannot find a TGA file it will search for a JPG version instead.
  

• The organic texture needs to be put into the textures directory and stored in a sub-directory with a unique name. Often the sub-directory is named after the map it is being used in so that it does not conflict with anyone else's work.
  
  ie. textures \ myrockmap \ myrock.tga
  
  
• The Phong shader needs to be created and stored in the scripts directory. Take the example shader listed above and change lines 4, 8 and 14 to point to the texture above. Save the shader in a shader file and name it after the map in which it will be used. (Like the sub-directory for the texture)
  
  The file must have the correct extension of '.shader' so that it is recognised by the compiler and engine as a valid shader file.
  
  ie. scripts \ myrockmap.shader
  
  
• Every scripts directory has a text file which contains a list of all the other shader files used by the game. This file is usually called 'shaderlist.txt'. Open this file up and add the name of your new shader file to the list. Save the changes back to the original file.
  
  The file 'shaderlist.txt' is unique to your game / editor setup and does not need to be distributed with your final work.