Creating special shader maps for textures

2012-12-14T05:48:15Z

Chocolatepie33: /* Bump/Height */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.
*Bumpmaps, as described at the BlenderWiki, store an <b>intensity</b>.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which provides the illusion of depth by changing angles of light to create perspective. They are more realistic as they change with lighting direction.
*Normalmaps, according to the BlenderWiki, store <b>directions</b>.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures, while in Red Eclipse, decals are used to add burn and plasma marks.

===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-12-14T05:47:50Z

Chocolatepie33: /* Normal/Height/Displace */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.
*Bumpmaps, as described at the BlenderWiki, store an <b>intensity</b>.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which provides the illusion of depth by changing angles of light to create perspective. They are more realistic as they change with lighting direction.
*Normalmaps, according to the BlenderWiki, store <b>directions</b>.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures, while in Red Eclipse, decals are used to add burn and plasma marks.

===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-12-14T05:43:24Z

Chocolatepie33: /* Bump/Height */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.
*Bumpmaps, as described at the BlenderWiki, store an <b>intensity</b>.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which provides the illusion of depth by changing angles of light to create perspective.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures, while in Red Eclipse, decals are used to add burn and plasma marks.

===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-12-14T05:39:42Z

Chocolatepie33: /* Decal */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which provides the illusion of depth by changing angles of light to create perspective.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures, while in Red Eclipse, decals are used to add burn and plasma marks.

===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-12-14T05:33:09Z

Chocolatepie33: /* Normal/Height/Displace */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which provides the illusion of depth by changing angles of light to create perspective.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures.
===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-12-14T05:27:22Z

Chocolatepie33: /* Bump/Height */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps. Bumpmaps are designed for adding "scratches, dings and bumps" to models or textures.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which is more accurate than a bumpmap. It does the same purpose, but on a more accurate and better scale, changing light reflections of certain angles to provide perspective. It's also harder to make.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures.
===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Water Wars Guide

2012-12-10T02:07:48Z

Chocolatepie33: formatting

== Commands ==
/dm = drenchmatch (a free for all)

/tdm = team drenchmatch

/ctf = capture the flag (bananas actually, /newent flag makes sure to set the teams, 1 is blue, 2 is red)

/savethebanana = base capture mode (/newent base)

/capture = works now too

/idm = Insta drenchmatch

/itdm = Insta team drenchmatch

Entities - /newent nameoftheentity

flag
base
shells
bullets
rockets
riflerounds
grenades
cartridges
health
healthboost
greenarmour
yellowarmour
quaddamage

== Server Client Commands ==
/connect - connect to a server using the IP
/sendmap
/getmap
These two commands allow you to send other players maps they may not have while in multiplayer mode, and easily keep maps in sync while doing coop edit. "sendmap" reloads the current map you are on, then uploads it to the server and sends every other player a message about it. Other players can then simply type "getmap" to receive the current map, which is written to their local disk then reloaded. A second variant "sendmap name" is available which is particularly useful for coop editing, which first does a "savemap name" before performing the actual "sendmap". Thus in both cases you must already be on the map you want to send before issuing the command! (in some multiplayer that requires voting). Also note that "getmap" operates on the last map send by some other player, whatever it is.

Server admin:
/setmaster B - Attempts to set master status to B. 0 gives up master status, 1 claims master status, or the admin password may be specified to steal master status from the current master. If you specify a password, you are granted "admin" status, which allows you to enable server features that an ordinary master can't.

/mastermode N - Sets the server to master mode N. N can be (ranging from very open to very private):
0 (open): anyone can enter the server. This is the default mode. It is good for games with random people, if no cheaters appear to be around.
1 (veto): as 0, but now the master can force map changes. This is good when playing with new players who may not understand how to vote for map changes.
2 (locked): as 1, but anyone joining after this mode has been set will be forced to be spectator only. This mode is ideal for tournament play, or games with friends only.
3 (private): as 2, but now noone can join the server anymore. Good for games with friends when cheaters are around, cheaters wont even connect, so wont have the chance to try and screw things up.

/kick - kick a client by their # It is actually a ban. The Player's number is displayed in Tab (Cn)
/clearbans
/goto
/pausegame

Bots - Make sure to claim admin - They work but need some love
addbot [SKILL] - Adds a bot at skill level SKILL if provided, or defaults to a random skill level between 50 and 100 if not provided. You must be master or playing locally to use this command. Bots may only be added up to the server specified bot limit unless you are an admin or local player. This also causes waypoints to load if any are available for the current map. You need to place waypoints on a map for them to work.

delbot - Removes a bot. You must be master or playing locally to use this command.

botlimit N - Sets the bot limit for masters to N. This limit does not effect admins or local players. Only admins or local players can use this command.

botbalance B - Enables automatic team balancing for bots if B=1 and disables it if B=0. Only masters or local players can use this command.

== Waypoints ==
First load your map.
Type /showwaypoints 1
Then make sure your not in edit mode.
Then type /dropwaypoints 1
Then start running around the map placing the waypoints also third person helps.
Only jump when you need to jump.
Then type /savewaypoints
Then type /savemap
Now type /showwaypoints 0
Then your good to go.
You can load your map and play with bots now.
If you want to edit your waypoints go into edit mode and load your map.
Type /loadwaypoints
Then you can start adding more waypoints.
If you wish to start over type /clearwaypoints

How to add lava, water, glass and other materials to your map

2012-11-01T03:44:19Z

Chocolatepie33:

== Adding Materials ==
To add lava, water, glass, and other materials to you map you first have to select an area in editmode. After this you open the '''quickedit''' window, (''F3'') and go to the '''materials''' tab, then pick which material you wish to make this cube of. Click this material, exit edit mode and you have your very own block of lava, water, or glass.

The other method to doing this is using the console. Hit ` (above TAB), and type /editmat (materialname). Typing just /(materialname) works as well. This method can be a lot faster sometimes.

== Effects of Each Material ==

Air: Creates a block of empty space! (Can be used to remove other materials.)

Clip: Creates an invisible wall. You can't go through this, and creatures can't either.

Glass: Creates a window effect.

Lava: Creates a burning wall of lava! (you will respawn if you walk into it.) Can also be used to make lavafalls.

Noclip: Allows you to make area (for example wall) penetrable (You can go though it!). You can lay this material over glass.

Water: Creates a swimming area! (What fun.) Also makes waterfalls.

Respawn: You will respawn from a playerstart. You can lay this material over water.

Gameclip: like clip, but it only affects creatures. You can go through this material while they can't.

== Other ==
Lava and Respawn can be changed so the player can go in and live (not respawn) with the /nastylava (1 or 0) commmand.

Tutorial by Nightmare2U, some fixes from Siimvuss, Chocolatepie33 added nastylava and falls info.

Tutorials List

2012-11-01T03:23:46Z

Chocolatepie33: /* 2D Art */

A list of tutorials created and edited by our contributors.
Contribute by improving the tutorials and creating tutorials for the red links
== Getting, Installing and opening Sandbox ==

* [[Downloading Sandbox]]
* [[Installing Sandbox]]
* [[Running Sandbox]]
* [[development|Obtaining the development version]]

== Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[RPG|RPG - Role Playing Game]]
** [[RPG tutorial|RPG Tutorial]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Learning the editor basics ==

* [[Map Editing Basics]]
* [[How to change textures in your map]]
* [[How to place 3D grass]]
* [[How to add lava, water, glass and other materials to your map]]
* [[How to make ramps, bridges, and angles]]
* [[How to make invisible boundaries]]
* [[Tips on making a good map]]
* [[Gridwork]]

=== Buildings ===

* [[How to make sloped roofs]]
* [[How to make secret doors, walls & floors]]
* [[How to make 1-way windows only you can see out of]]
* [[How to make 1-way doors]]
* [[How to create a hollow tower/tube]]
* [[How to make stairs you could walk up]]
* [[How to create set of glass stairs]]
* [[How to make a TV]]
* [[How to make various window shapes]]
* [[How to create a spiral staircase]]
* [[How to make a pyramid/four-sided sloped roof]]

=== Terrain editing ===

* [[How to create mountains, ponds, and oceans]]
* [[How to transfer parts of a map to a new one]]
* [[How to make a forest]]
* [[How to make a cave]]
* [[How to make a realistic river]]
* [[How to make a swimming pool]]
* [[How to make a fountain]]
* [[How to create smooth curvy pathways]]
* [[How to create fields with flower patches]]
* [[How to create a camp fire and fireplace]]
* [[How to make a bumpy road]]
* [[How to make various types of fences]]
* [[How to make a nice waterfall]]
* [[How to edit terrain properly]]
* [[How to fix bad terrain or geometry errors]]
* [[How to make railings]]
* [[Texture Blending]]

=== Advanced Editor Techniques===

* [[How to create a slide]]
* [[How to create a trampoline]]
* [[How to create electric fences]]
* [[How to make a sphere shapes in 'edit mode']]
* [[How to make curved shapes in 'edit mode']]
* [[How to create curved glass]]
* [[How to create climbable ladders and vertical walls]]
* [[How to make an endless slide]]
* [[How to create lens flares]]
* [[How to make a snowman]]
* [[How to make a boat]]
* [[How to create warp speed tunnels]]
* [[How to create hidden teleports]]
* [[How to create spinning palm trees]]
* [[How to change gravity]]

== Lighting and Particle effects ==

* [[How to add various lighting]]
* [[Lighting|How to light a map properly]]
* [[Tips to make a night time map]]
* [[Tips to make a morning map]]
* [[Tips to make a sunset map]]
* [[How to add particle effects]]
* [[How to create snow or rain]]
* [[How to put fog to a map]]

== Models and Sandbox ==

* [[Blender to Sandbox]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Mapmodels|Loading and adding mapmodels]]
** [[Importing .OBJ files]]
* [[How to add new models]]
* [[Creating 3D models with PAS]]

== Textures ==
* [[Adding custom textures to a new map]]
* [[Adding custom textures with normal maps]]

== Scripting/Trigger tutorials ==

=== Menu Editing - Cubescript ===
* [[Menu Editing|How to modify the menu]]
* [[Cubescript]]
* [[Creating easy spells]]
* [[Removing Editmode]]
* [[Adding Custom Skyboxes]]
=== Maptitle and authors ===
* [[How to add map title and author]]
* [[How to change color of text in maps welcome message]]

=== FPS Scripting ===

* [[Creating a shop script]]
* [[How to make characters talk with text pop-up windows]]
* [[How to make characters give you quests]]
* [[making picked up items visible in your inventory]]
* [[How to make a trigger load another map]]
* [[Making Echoes]]
* [[How to make triggered elevators/platforms]]
* [[How to make items that can be picked up]]

=== RPG Scripting ===
* [[RPG commands]]
* [[RPG configuration]]
* [[RPG script]]

== Source Code Modifying + Recompiling ==

* [[Compiling the source code]]
* [[How to get a mapsize greater than 16]]
* [[How to add creatures]]
* [[How to add more player character models]]

== Multiplayer tutorials ==

* [[How to host a coop edit session over the internet]]
* [[How to host a persistent world in Sandbox over the internet]]
* [[How to monitor your dedicated server without being in it]]

== Unsorted tutorials ==
* [[Transferring your Map to a new version of Sandbox]]
* [[How to save a map properly]]
* [[How to add projectiles to your game]]
* [[How to automatically save your map every x number of minutes]]

== Sandbox Related ==
=== Within Sandbox ===
* [[Guide to a good game]]
* [[Customizing Sandbox]]
* [[Adding custom songs to Sandbox]]
* [[Preparing your map for uploading]]
* [[Using Cullart]]
* [[How to capture screen shots and videos]]
* [[How to set up Sandbox for commercial use]]

=== Outside of Sandbox ===
* [[Licensing]]
* [http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=1493 Copyrighting your content]

==Content Creation==
* [[Why Create Content?]]
* [[Tips on creating content]]
* [[Good free programs for Sandbox]]
* [[Content Creation Software Tutorials List]]
===3D Art===
* [[Models Vs. Geometry]]
===2D Art===
* [[Making Seamless textures]]
* [[How to make new textures]]
* [[Creating special shader maps for textures]]
* [[Glowmaps]]
* [http://www.leighvanderbyl.com/texturing-for-dummies/ Texturing for Dummies]
* [http://www.cgsociety.org/index.php/CGSFeatures/CGSFeatureSpecial/the_top_ten_tips_of_texturing Top Ten Tips of Texturing]
* [http://forums.cgsociety.org/showthread.php?t=373024 Hard Surface Texture Painting]

== Meta-Sandbox ==
* [[How to contribute to Platinum Arts Sandbox]]
* [[Where to find inspiration]]
* [[Editing the wiki]]

* [[Creators of these tutorials]]

Tutorials List

2012-11-01T03:23:31Z

Chocolatepie33: /* Textures */

A list of tutorials created and edited by our contributors.
Contribute by improving the tutorials and creating tutorials for the red links
== Getting, Installing and opening Sandbox ==

* [[Downloading Sandbox]]
* [[Installing Sandbox]]
* [[Running Sandbox]]
* [[development|Obtaining the development version]]

== Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[RPG|RPG - Role Playing Game]]
** [[RPG tutorial|RPG Tutorial]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Learning the editor basics ==

* [[Map Editing Basics]]
* [[How to change textures in your map]]
* [[How to place 3D grass]]
* [[How to add lava, water, glass and other materials to your map]]
* [[How to make ramps, bridges, and angles]]
* [[How to make invisible boundaries]]
* [[Tips on making a good map]]
* [[Gridwork]]

=== Buildings ===

* [[How to make sloped roofs]]
* [[How to make secret doors, walls & floors]]
* [[How to make 1-way windows only you can see out of]]
* [[How to make 1-way doors]]
* [[How to create a hollow tower/tube]]
* [[How to make stairs you could walk up]]
* [[How to create set of glass stairs]]
* [[How to make a TV]]
* [[How to make various window shapes]]
* [[How to create a spiral staircase]]
* [[How to make a pyramid/four-sided sloped roof]]

=== Terrain editing ===

* [[How to create mountains, ponds, and oceans]]
* [[How to transfer parts of a map to a new one]]
* [[How to make a forest]]
* [[How to make a cave]]
* [[How to make a realistic river]]
* [[How to make a swimming pool]]
* [[How to make a fountain]]
* [[How to create smooth curvy pathways]]
* [[How to create fields with flower patches]]
* [[How to create a camp fire and fireplace]]
* [[How to make a bumpy road]]
* [[How to make various types of fences]]
* [[How to make a nice waterfall]]
* [[How to edit terrain properly]]
* [[How to fix bad terrain or geometry errors]]
* [[How to make railings]]
* [[Texture Blending]]

=== Advanced Editor Techniques===

* [[How to create a slide]]
* [[How to create a trampoline]]
* [[How to create electric fences]]
* [[How to make a sphere shapes in 'edit mode']]
* [[How to make curved shapes in 'edit mode']]
* [[How to create curved glass]]
* [[How to create climbable ladders and vertical walls]]
* [[How to make an endless slide]]
* [[How to create lens flares]]
* [[How to make a snowman]]
* [[How to make a boat]]
* [[How to create warp speed tunnels]]
* [[How to create hidden teleports]]
* [[How to create spinning palm trees]]
* [[How to change gravity]]

== Lighting and Particle effects ==

* [[How to add various lighting]]
* [[Lighting|How to light a map properly]]
* [[Tips to make a night time map]]
* [[Tips to make a morning map]]
* [[Tips to make a sunset map]]
* [[How to add particle effects]]
* [[How to create snow or rain]]
* [[How to put fog to a map]]

== Models and Sandbox ==

* [[Blender to Sandbox]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Mapmodels|Loading and adding mapmodels]]
** [[Importing .OBJ files]]
* [[How to add new models]]
* [[Creating 3D models with PAS]]

== Textures ==
* [[Adding custom textures to a new map]]
* [[Adding custom textures with normal maps]]

== Scripting/Trigger tutorials ==

=== Menu Editing - Cubescript ===
* [[Menu Editing|How to modify the menu]]
* [[Cubescript]]
* [[Creating easy spells]]
* [[Removing Editmode]]
* [[Adding Custom Skyboxes]]
=== Maptitle and authors ===
* [[How to add map title and author]]
* [[How to change color of text in maps welcome message]]

=== FPS Scripting ===

* [[Creating a shop script]]
* [[How to make characters talk with text pop-up windows]]
* [[How to make characters give you quests]]
* [[making picked up items visible in your inventory]]
* [[How to make a trigger load another map]]
* [[Making Echoes]]
* [[How to make triggered elevators/platforms]]
* [[How to make items that can be picked up]]

=== RPG Scripting ===
* [[RPG commands]]
* [[RPG configuration]]
* [[RPG script]]

== Source Code Modifying + Recompiling ==

* [[Compiling the source code]]
* [[How to get a mapsize greater than 16]]
* [[How to add creatures]]
* [[How to add more player character models]]

== Multiplayer tutorials ==

* [[How to host a coop edit session over the internet]]
* [[How to host a persistent world in Sandbox over the internet]]
* [[How to monitor your dedicated server without being in it]]

== Unsorted tutorials ==
* [[Transferring your Map to a new version of Sandbox]]
* [[How to save a map properly]]
* [[How to add projectiles to your game]]
* [[How to automatically save your map every x number of minutes]]

== Sandbox Related ==
=== Within Sandbox ===
* [[Guide to a good game]]
* [[Customizing Sandbox]]
* [[Adding custom songs to Sandbox]]
* [[Preparing your map for uploading]]
* [[Using Cullart]]
* [[How to capture screen shots and videos]]
* [[How to set up Sandbox for commercial use]]

=== Outside of Sandbox ===
* [[Licensing]]
* [http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=1493 Copyrighting your content]

==Content Creation==
* [[Why Create Content?]]
* [[Tips on creating content]]
* [[Good free programs for Sandbox]]
* [[Content Creation Software Tutorials List]]
===3D Art===
* [[Models Vs. Geometry]]
===2D Art===
* [[Making Seamless textures]]
* [[How to make new textures]]
* [[Creating special shader maps for textures]]
* [http://www.leighvanderbyl.com/texturing-for-dummies/ Texturing for Dummies]
* [http://www.cgsociety.org/index.php/CGSFeatures/CGSFeatureSpecial/the_top_ten_tips_of_texturing Top Ten Tips of Texturing]
* [http://forums.cgsociety.org/showthread.php?t=373024 Hard Surface Texture Painting]

== Meta-Sandbox ==
* [[How to contribute to Platinum Arts Sandbox]]
* [[Where to find inspiration]]
* [[Editing the wiki]]

* [[Creators of these tutorials]]

Tutorials List

2012-11-01T03:23:05Z

Chocolatepie33: /* Lighting and Particle effects */

A list of tutorials created and edited by our contributors.
Contribute by improving the tutorials and creating tutorials for the red links
== Getting, Installing and opening Sandbox ==

* [[Downloading Sandbox]]
* [[Installing Sandbox]]
* [[Running Sandbox]]
* [[development|Obtaining the development version]]

== Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[RPG|RPG - Role Playing Game]]
** [[RPG tutorial|RPG Tutorial]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Learning the editor basics ==

* [[Map Editing Basics]]
* [[How to change textures in your map]]
* [[How to place 3D grass]]
* [[How to add lava, water, glass and other materials to your map]]
* [[How to make ramps, bridges, and angles]]
* [[How to make invisible boundaries]]
* [[Tips on making a good map]]
* [[Gridwork]]

=== Buildings ===

* [[How to make sloped roofs]]
* [[How to make secret doors, walls & floors]]
* [[How to make 1-way windows only you can see out of]]
* [[How to make 1-way doors]]
* [[How to create a hollow tower/tube]]
* [[How to make stairs you could walk up]]
* [[How to create set of glass stairs]]
* [[How to make a TV]]
* [[How to make various window shapes]]
* [[How to create a spiral staircase]]
* [[How to make a pyramid/four-sided sloped roof]]

=== Terrain editing ===

* [[How to create mountains, ponds, and oceans]]
* [[How to transfer parts of a map to a new one]]
* [[How to make a forest]]
* [[How to make a cave]]
* [[How to make a realistic river]]
* [[How to make a swimming pool]]
* [[How to make a fountain]]
* [[How to create smooth curvy pathways]]
* [[How to create fields with flower patches]]
* [[How to create a camp fire and fireplace]]
* [[How to make a bumpy road]]
* [[How to make various types of fences]]
* [[How to make a nice waterfall]]
* [[How to edit terrain properly]]
* [[How to fix bad terrain or geometry errors]]
* [[How to make railings]]
* [[Texture Blending]]

=== Advanced Editor Techniques===

* [[How to create a slide]]
* [[How to create a trampoline]]
* [[How to create electric fences]]
* [[How to make a sphere shapes in 'edit mode']]
* [[How to make curved shapes in 'edit mode']]
* [[How to create curved glass]]
* [[How to create climbable ladders and vertical walls]]
* [[How to make an endless slide]]
* [[How to create lens flares]]
* [[How to make a snowman]]
* [[How to make a boat]]
* [[How to create warp speed tunnels]]
* [[How to create hidden teleports]]
* [[How to create spinning palm trees]]
* [[How to change gravity]]

== Lighting and Particle effects ==

* [[How to add various lighting]]
* [[Lighting|How to light a map properly]]
* [[Tips to make a night time map]]
* [[Tips to make a morning map]]
* [[Tips to make a sunset map]]
* [[How to add particle effects]]
* [[How to create snow or rain]]
* [[How to put fog to a map]]

== Models and Sandbox ==

* [[Blender to Sandbox]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Mapmodels|Loading and adding mapmodels]]
** [[Importing .OBJ files]]
* [[How to add new models]]
* [[Creating 3D models with PAS]]

== Textures ==

* [[Glowmaps]]
* [[Adding custom textures to a new map]]
* [[Adding custom textures with normal maps]]

== Scripting/Trigger tutorials ==

=== Menu Editing - Cubescript ===
* [[Menu Editing|How to modify the menu]]
* [[Cubescript]]
* [[Creating easy spells]]
* [[Removing Editmode]]
* [[Adding Custom Skyboxes]]
=== Maptitle and authors ===
* [[How to add map title and author]]
* [[How to change color of text in maps welcome message]]

=== FPS Scripting ===

* [[Creating a shop script]]
* [[How to make characters talk with text pop-up windows]]
* [[How to make characters give you quests]]
* [[making picked up items visible in your inventory]]
* [[How to make a trigger load another map]]
* [[Making Echoes]]
* [[How to make triggered elevators/platforms]]
* [[How to make items that can be picked up]]

=== RPG Scripting ===
* [[RPG commands]]
* [[RPG configuration]]
* [[RPG script]]

== Source Code Modifying + Recompiling ==

* [[Compiling the source code]]
* [[How to get a mapsize greater than 16]]
* [[How to add creatures]]
* [[How to add more player character models]]

== Multiplayer tutorials ==

* [[How to host a coop edit session over the internet]]
* [[How to host a persistent world in Sandbox over the internet]]
* [[How to monitor your dedicated server without being in it]]

== Unsorted tutorials ==
* [[Transferring your Map to a new version of Sandbox]]
* [[How to save a map properly]]
* [[How to add projectiles to your game]]
* [[How to automatically save your map every x number of minutes]]

== Sandbox Related ==
=== Within Sandbox ===
* [[Guide to a good game]]
* [[Customizing Sandbox]]
* [[Adding custom songs to Sandbox]]
* [[Preparing your map for uploading]]
* [[Using Cullart]]
* [[How to capture screen shots and videos]]
* [[How to set up Sandbox for commercial use]]

=== Outside of Sandbox ===
* [[Licensing]]
* [http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=1493 Copyrighting your content]

==Content Creation==
* [[Why Create Content?]]
* [[Tips on creating content]]
* [[Good free programs for Sandbox]]
* [[Content Creation Software Tutorials List]]
===3D Art===
* [[Models Vs. Geometry]]
===2D Art===
* [[Making Seamless textures]]
* [[How to make new textures]]
* [[Creating special shader maps for textures]]
* [http://www.leighvanderbyl.com/texturing-for-dummies/ Texturing for Dummies]
* [http://www.cgsociety.org/index.php/CGSFeatures/CGSFeatureSpecial/the_top_ten_tips_of_texturing Top Ten Tips of Texturing]
* [http://forums.cgsociety.org/showthread.php?t=373024 Hard Surface Texture Painting]

== Meta-Sandbox ==
* [[How to contribute to Platinum Arts Sandbox]]
* [[Where to find inspiration]]
* [[Editing the wiki]]

* [[Creators of these tutorials]]

Talk:PAS related websites

2012-11-01T02:26:42Z

Chocolatepie33: Created page with '"The following sites that are prohibited are listed Sites primarily for promotion or commercial purposes (advertising products, selling products, making someone noticed etc.…'

"The following sites that are prohibited are listed

Sites primarily for promotion or commercial purposes (advertising products, selling products, making someone noticed etc.)
Sites containing malware, spyware, viruses etc. that will harm your computer or compromise with your security
Sites used for phising or scamming
Sites not suitable for kids (contains violence, horror, pornography etc.)
Sites designed to attack (harassment, discrimination, spam etc.)
'''Sites that don't contain sandbox content'''
Sites that don't make sense or too difficult to understand
'''Sites written in a language other than English'''
Sites that require a sign up/ log in or a paid subscription (some exceptions apply)
Sites containing copyrighted content (some exceptions apply if original creator grants permission and licence is adhered to)
Illegal sites
'''Wiki pages (Sandbox has a wiki and you are reading it. If you find another wiki related to PAS please let us know)'''
'''Facebook/Twitter pages or accounts"'''

Heh, might as well just prohibit everything on the internet. Who ever said there should be rules for what can be put on a wiki? If there's spam, then it gets removed. Oh well. A lot of these are common sense, as well.

Main Page

2012-10-30T03:56:24Z

Chocolatepie33: Merged the Tutorials section with "Getting Started", as the two attempted (and failed) to share a video tutorial list, and seemed somewhat similar and redundant.

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open-source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [http://www.svn.kids.platinumarts.net/32pas32/trunk/LICENSE.txt License]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==
* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Coding Style]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[Todo|To do list]]
* [[content request| Content Request - Help us out!!]]

== Future Projects ==
=== Kid Friendly RPG ===

* [[Concept Document]]
* [[Brainstorming area]]

=== Master Chef Ogro 2 ===
* [[Brainstorming]]

=== Undercover Kids Game ===
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Tips on Making a Good Map]]
* [[Water Wars Guide]]
* [[Tutorials List | Text Tutorials List]]
* [[Video Tutorials List]]

== Advanced topics ==

* [[Cooperative Editing]] (General Server set up)
* [[Cooperative Editing 2]] (Easier way using Hamachi)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Modules ==

* [[FPS|FPS - First Person Shooter ]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Other ==
*[[Soundtrack]]
*[[PAS related websites]]
*[[Custom Content Websites]]

Creating special shader maps for textures

2012-10-15T19:26:27Z

Chocolatepie33: /* Scripting */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which is more accurate than a bumpmap. It does the same purpose, but on a more accurate and better scale, changing light reflections of certain angles to provide perspective. It's also harder to make.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures.
===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)

*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Creating special shader maps for textures

2012-10-15T19:26:02Z

Chocolatepie33: /* Scripting */

=About Shaders=
==What is a Shader?==
*In the Cube 2 engine (and many other engines), shaders are used to change a texture without actually changing the texture itself. How? A shader will take a 2nd texture, based off of the original, and will apply a special effect based on what kind of shader you use and the texture provided for it. '''Keep in mind that some textures won't really need shaders, and that adding a shader could end up making the texture look bad.
==What kind of shaders are there?==
*There are many different kinds of shaders, and you can combine some of them. Here's a basic list of common shaders:
===Bump/Height===
*A bumpmap (which may go by other names) is a greyscale image which bumps parts of a texture up or down (raising or lowering parts), based on the color. In a bumpmap, white (rgb 255, 255, 255) rises and black (rgb 0, 0, 0) lowers, while grey (rgb 127, 127, 127) is even. Bumpmaps can be combined with virtually any other shader, and some only work with bumpmaps.

===Normal/Height/Displace===
*A normalmap is a red-green-pinkish purple colored [http://www.bencloward.com/images/shaders_offest_normalmap.jpg image] which is more accurate than a bumpmap. It does the same purpose, but on a more accurate and better scale, changing light reflections of certain angles to provide perspective. It's also harder to make.

===Decal===
*A decal is an image which is added to an image after something happens to that texture. In Cube 2: Sauerbraten, decals are used to add bullet holes to textures.
===Glow===
*A glowmap allows a texture to glow in the dark.
===Pulse===
*Like a glowmap, but the glowing "pulses". It's like a light being turned on and off, back and forth.
===Specular===
*A specular map, or specmap, controls the amount of light a texture, or an area of a texture, receives or reflects. Specular maps are lighter (closer to white) when they reflect more light, while they are usually darker (closer to black) when they receive light and don't reflect it. A specular map of rock, for example, would be relatively dark.

=Creating and Adding Shaders=
*There are two parts to creating a shader and applying it to a texture: actually creating the shader map (based off of your diffuse, or color, map) and scripting it in (so the shader is applied to the texture within Sandbox).
==Actually creating the texture==
===Bump/Height===
*Bumpmaps can be made in a variety of ways.
**Note: if you test your texture with shaders and see something really weird, check to see if your bumpmap, not your normalmap, may be too strong. While checking both helps, I've noticed it's usually the bumpmap which causes problems. Should your bumpmap be too strong, open it up in GIMP and lower the contrast. Also, make sure that your bumpmap is seamless before and after you make a normalmap with it.
====Using GIMP====
*Desaturate the texture
*Change contrast/brightness as required
*invert as necessary (remember - light areas raise, darks depress/lower and grey is neutral)
*If preferred, copy the layer, use threshold, apply opacity/transparency as wanted, then merge layers
*save as texture_Bump.jpg
====Using SSBump====
//to be done

===Normal/Height===
*Normalmaps usually requires special tools such as the [http://code.google.com/p/gimp-normalmap/ GIMP Normal-map Plugin], [http://www.smart-page.net/smartnormal/ Smart Normal], [http://sourceforge.net/projects/ssbumpgenerator/ SSBump Generator], or other bump-to-normal converters to work.
*Before you make a normal map, make sure your bumpmap is seamless.
*Load the bumpmap into whatever you're going to use, and then convert. See below for instructions on the given sources above.
*Once you've made your Normal map, save it as texture_Normal.jpg and test it in Sandbox (see below). If you see random straight lines in places, then use GIMP to make the texture seamless.
*If you want, follow up by following [http://www.cgtextures.com/content.php?action=tutorial&name=normalmap this] great tutorial on enhancing normalmaps.
====Using a photo-editor plugin====
*To use a plugin for a photo editor (e.g. the GIMP, Paint.net, Photoshop), find and download the plugin, install it into the program that uses it, then find and execute it within the editor. A tutorial for paint.net can be found here: [[Making Seamless textures]].
====Using SmartNormal====
*First: What is SmartNormal?
**SmartNormal is an online program which converts bumpmaps to normalmaps. While you can always use it online, you can also download and install SmartNormal. SmartNormal is incredibly useful in its speed and it also keeps your settings from your previous texture and applies it to your newly loaded texture.
*Using SmartNormal is incredibly easy. Just visit the site, load your image, then move the bias (strength) and blur sliders as you like. When picking a filter, Sobel seems to be a lot stronger while Condensed is the exact same as the default (no-filter) look. I recommend you invert the source as well, as the normal map should look the opposite of what it does (so rocks jutting out would actually look like they're pointing in, and vice-versa).
*I believe SmartNormal has a habit of messing with a texture's borders; with that in mind, open up your normalmap and make sure it's seamless.

====Using SSBump====
//to be done

===Decal===
*A decal only needs to be a transparent .png. Alternatively, you could just use texture blending and painting, unless you want a specific shape.

===Glow===
*We have a great glowmap tutorial made by Hirato here on the wiki @ [[Glowmaps]].

===Pulse===
*Pulse shaders can use just diffuse textures to start, and are made primarily by scripting. However, you can also throw in a glowmap texture and a specmap texture if you would like.

===Specular===
*You can edit a bumpmap to create a specular map. As previously mentioned, lighter colors (yes, colors, you're not limited to greyscale, so experiment) tend to reflect more light while darker colors absorb light. You can change an image's brightness and contrast to get the result you want.

==Scripting==
*In order to utilize a shader on your map, you need to add it to your package.cfg, which is later executed to add your textures to Sandbox. The basic code to execute a shader is like this:

<font size=2>
setshader [shadername]
texture 0 "[texturepath]/[diffusetexturename.jpg]
texture ? "[texturepath]/[shadertexturename.jpg]
//(repeat above line as needed)
</font>
*There are many combinations of shaders out there. Lots of them combine individual shaders. A very good list of all texture shaders can be found on [http://www.quadropolis.us/node/3224 Quadropolis.] NOTE: Quadropolis may not be appropriate for children.

*A very basic example:

<font size=2>
setshader bumpspecmapparallaxworld //bump-, spec-, and normal-map textures.
setshaderparam "specscale" 0.2 0.2 0.2 //reduce the specularity
setshaderparam "parallaxscale" 0.2 0.2 0.2 //reduce parallax
texture 0 "textures/textureX.jpg" //diffuse, or color, texture
texture z "textures/textureX_Bump.jpg" //bump map
texture n "textures/textureX_Normal.jpg" //normal map
texture s "textures/textureX_Spec.jpg" //specular map
</font>

*As you can see, setshader determines the type of shader used. This is in effect until the next setshader line. The setshaderparam command changes the scale of each shader, so you don't get a dizzyingly strong texture. Each individual texture is then called up by its respective command, based on the type of shader map it is. This specific example would call up textureX in Sandbox, and then apply a bumpmap, normalmap, and specular map (bump, parallax and spec shaders) to textureX.

Why Create Content?

2012-10-15T19:23:41Z

Chocolatepie33:

==Overview==

*Sometimes, you may find yourself in need of a different kind of texture set or environment than Sandbox can provide. If you find a suitable alternative, it may be unusable due to licensing, quality or compatibility issues. Your last option is to make your own content.

==Should I try to make content?==

*This depends on your skill level with graphics software and the amount of time you're willing to spend on your project. If you feel like you're good enough to make what you want, then go ahead.

==I'm sure I want to try this. Where should I start?==

*If you haven't already, check [[Custom Content Websites]] and see if there's anything out there that you're willing to use. If you can find content you want or like and can use, then use that. It will save you a lot of time and effort.

*You should have tools to make your content with. It's your job to find software that you can work with. Check out [[Good free programs for Sandbox]] as a starter.

*From there, learn about using those programs in order to make what you want.

How to make new textures

2012-10-15T19:17:08Z

Chocolatepie33:

2012-10-14T00:55:05Z

Chocolatepie33: Created page with '=Overview= *Before you attempt to make your own content for Sandbox, it's a good idea to look around and see if there's something else that is close enough to what you want. This…'

How to make new textures

2012-10-14T00:54:56Z

Chocolatepie33:

*Before making your own textures, you should check out
[[Custom Content Websites]] for textures. Otherwise, you can try to make your own.
=Using GIMP=
*First, download [http://www.gimp.org/downloads/ The Gimp]
**It isn't possible to tell you how to make any texture you want in one tutorial.
**Instead, google how to make the texture you want in gimp, there almost certainly is a tutorial out there somewhere. You may want to try the Gimp Talk forums to begin with.
***With some textures, there are things you should do to them to make them more realistic, such as [http://tutorials.texturama.com/tut_dirty.html adding dirt]. Keep that in mind.

*Then you will probably want to make it seamless.
**In Gimp go to '''Filters → Map → Make Seamless''', and Gimp will make the texture seamless by modifying the corners.

*An alternate way to make textures seamless can be found [http://www.coniserver.net/wiki/index.php/Seamless_Texture_Tutorial here] and a different version of the same tutorial can be found [http://www.photoshoptextures.com/texture-tutorials/seamless-textures.htm here]
*As for size: your texture should be 512x512 at a bare minimum. If the texture is too large within Sandbox, you can always use /vscale to fix it. Always use powers of 2 (512, 1024, 2048) for dimensions, and your textures should generally be square.

*Now you should save it and you are done!

*If you want, you can continue and make shader maps for your texture.

=Using a generator=
*There are many great texture generators out there to use. Here's a list of some good texture generators, all should be free.
**[http://sourceforge.net/projects/fxgen/ FXGen]
**[http://sourceforge.net/projects/neotextureedit/ Neo Texture Edit]
**[http://www.blender.org/ Blender] also has a very good texture creation program.
**[http://www.mapzoneeditor.com/ Allegorithmic MaPZone] is a very powerful texture creator. If the site does not load, it's likely down, as it was for a few months. You may have to wait and check later.

Main Page

2012-10-14T00:43:53Z

Chocolatepie33: /* Other */

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open-source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==
* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Coding Style]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[Todo|To do list]]
* [[content request| Content Request - Help us out!!]]

== Future Projects ==
=== Kid Friendly RPG ===

* [[Concept Document]]
* [[Brainstorming area]]

=== Master Chef Ogro 2 ===
* [[Brainstorming]]

=== Undercover Kids Game ===
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]
* [[Water Wars Guide]]

== Advanced topics ==

* [[Cooperative Editing]] (General Server set up)
* [[Cooperative Editing 2]] (Easier way using Hamachi)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Modules ==

* [[FPS|FPS - First Person Shooter ]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Tutorials ==
*[[Tips on Making a Good Map]]
*[[Tutorials List | Text Tutorials List]]
*[[Video Tutorials List]]

== Other ==
*[[Soundtrack]]
*[[PAS related websites]]
*[[Custom Content Websites]]

Good free programs for Sandbox

2012-10-14T00:42:57Z

Chocolatepie33: /* 3D Art */

==2D Art==

*Artweaver, a 2d paint program like photoshop. It supports layers. Some texture artist like to paint on the flat 2D uv map image for textuing and other texturing usage.
**http://www.artweaver.de/index.php?en_version

*Inkscape, a vector graphics editor
**http://inkscape.org/

*GIMP, or the GNU Image Manipulation Program, a photo editing program that can be used for texture making.
**http://www.gimp.org/

*Paint.net, a different alternative to Photoshop or the GIMP.
**http://www.getpaint.net/

*NeoTextureEdit, a procedural texture generator.
**http://neotextureedit.sourceforge.net/

*FXGen, another procedural generator.
**http://sourceforge.net/projects/fxgen/

*Allegorithmic MaPZone, another free texture generator.
**http://www.mapzoneeditor.com/

*Spiral Graphics Wood Workshop, a free texture creator which specializes in wood textures.
**http://www.spiralgraphics.biz/ww_overview.htm

==3D Art==
*Make sure to also look at [[3D Modelling Programs]].
===Modelling/Animation===
*Wings3d, a great modeler with a outstanding uv mapper.
**http://www.wings3d.com/

*Misfit Model 3D, to add bones and animations for your NPC or other models, plus to save your model as a md3 file with the animation data. be sure to get the lastest beta version
**http://www.misfitcode.com/misfitmodel3d/

*CharactorFx, for adding bones and animation to your models. It's a little older program but works great and saves to md2 files.
**http://www.insanesoftware.de/

*Blender, a 3D modeling program with support for animation and UV texturing with a large community behind it.
**http://www.blender.org/

*Arbaro, a tree generator written in Java which can export Wavefront OBJ files, which are supported by Sandbox.
**http://arbaro.sourceforge.net/

*Pixologic Sculptris, a sculpting-based 3D modelling program.
**http://www.pixologic.com/sculptris/

*MD3Compile, a very quick and easy converter for md2,3ds files to a md3 file. I use it for converting my static 3ds models into a md3 file plus to rebuild my 3ds model's normals.
**http://www.quakeunity.com/file=481

===Painting===
*Tattoo 3D, This was my first 3D texturing program. It great for fast texturing but limited on more powerfull functions as it a older program. Free to use for non-commerical work.
**http://www.terabit-software.co.uk/

*Blacksmith 3D, You can paint your models in realtime 3D. The "freeware" 3D painter limits your export image size to 1024 x1024 which is more than enough for Sandbox
**http://www.blacksmith3d.com/blacksmith3D-3d-paint-software.php

==Other==
*Notepad Plus (++), unique text tool built mainly for scripting of many different types. This can be used to edit/make CFGs in Sandbox.
**http://notepad-plus.sourceforge.net/uk/site.htm

*Audacity, a program useful for editing audio or converting audio files such as mp3 wav ogg
**http://audacity.sourceforge.net/download/

*Linux Multimedia Studio, a Linux AND Windows music making program.
**http://lmms.sourceforge.net/

For many more free programs, look at http://sourceforge.net/ and http://portableapps.com/

Good free programs for Sandbox

2012-10-14T00:40:48Z

Chocolatepie33: /* 3D Modelling or Related */

==2D Art==

*Artweaver, a 2d paint program like photoshop. It supports layers. Some texture artist like to paint on the flat 2D uv map image for textuing and other texturing usage.
**http://www.artweaver.de/index.php?en_version

*Inkscape, a vector graphics editor
**http://inkscape.org/

*GIMP, or the GNU Image Manipulation Program, a photo editing program that can be used for texture making.
**http://www.gimp.org/

*Paint.net, a different alternative to Photoshop or the GIMP.
**http://www.getpaint.net/

*NeoTextureEdit, a procedural texture generator.
**http://neotextureedit.sourceforge.net/

*FXGen, another procedural generator.
**http://sourceforge.net/projects/fxgen/

*Allegorithmic MaPZone, another free texture generator.
**http://www.mapzoneeditor.com/

*Spiral Graphics Wood Workshop, a free texture creator which specializes in wood textures.
**http://www.spiralgraphics.biz/ww_overview.htm

==3D Art==
===Modelling/Animation===
*Wings3d, a great modeler with a outstanding uv mapper.
**http://www.wings3d.com/

*Misfit Model 3D, to add bones and animations for your NPC or other models, plus to save your model as a md3 file with the animation data. be sure to get the lastest beta version
**http://www.misfitcode.com/misfitmodel3d/

*CharactorFx, for adding bones and animation to your models. It's a little older program but works great and saves to md2 files.
**http://www.insanesoftware.de/

*Blender, a 3D modeling program with support for animation and UV texturing with a large community behind it.
**http://www.blender.org/

*Arbaro, a tree generator written in Java which can export Wavefront OBJ files, which are supported by Sandbox.
**http://arbaro.sourceforge.net/

*Pixologic Sculptris, a sculpting-based 3D modelling program.
**http://www.pixologic.com/sculptris/

*MD3Compile, a very quick and easy converter for md2,3ds files to a md3 file. I use it for converting my static 3ds models into a md3 file plus to rebuild my 3ds model's normals.
**http://www.quakeunity.com/file=481

===Painting===
*Tattoo 3D, This was my first 3D texturing program. It great for fast texturing but limited on more powerfull functions as it a older program. Free to use for non-commerical work.
**http://www.terabit-software.co.uk/

*Blacksmith 3D, You can paint your models in realtime 3D. The "freeware" 3D painter limits your export image size to 1024 x1024 which is more than enough for Sandbox
**http://www.blacksmith3d.com/blacksmith3D-3d-paint-software.php

==Other==
*Notepad Plus (++), unique text tool built mainly for scripting of many different types. This can be used to edit/make CFGs in Sandbox.
**http://notepad-plus.sourceforge.net/uk/site.htm

*Audacity, a program useful for editing audio or converting audio files such as mp3 wav ogg
**http://audacity.sourceforge.net/download/

*Linux Multimedia Studio, a Linux AND Windows music making program.
**http://lmms.sourceforge.net/

For many more free programs, look at http://sourceforge.net/ and http://portableapps.com/

Good free programs for Sandbox

2012-10-14T00:38:56Z

Chocolatepie33:

==2D Art==

*Artweaver, a 2d paint program like photoshop. It supports layers. Some texture artist like to paint on the flat 2D uv map image for textuing and other texturing usage.
**http://www.artweaver.de/index.php?en_version

*Inkscape, a vector graphics editor
**http://inkscape.org/

*GIMP, or the GNU Image Manipulation Program, a photo editing program that can be used for texture making.
**http://www.gimp.org/

*Paint.net, a different alternative to Photoshop or the GIMP.
**http://www.getpaint.net/

*NeoTextureEdit, a procedural texture generator.
**http://neotextureedit.sourceforge.net/

*FXGen, another procedural generator.
**http://sourceforge.net/projects/fxgen/

*Allegorithmic MaPZone, another free texture generator.
**http://www.mapzoneeditor.com/

*Spiral Graphics Wood Workshop, a free texture creator which specializes in wood textures.
**http://www.spiralgraphics.biz/ww_overview.htm

==3D Modelling or Related==
*Wings3d, a great modeler with a outstanding uv mapper.
**http://www.wings3d.com/

*Tattoo 3D, This was my first 3D texturing program. It great for fast texturing but limited on more powerfull functions as it a older program. Free to use for non-commerical work.
**http://www.terabit-software.co.uk/

*Blacksmith 3D, You can paint your models in realtime 3D. The "freeware" 3D painter limits your export image size to 1024 x1024 which is more than enough for Sandbox
**http://www.blacksmith3d.com/blacksmith3D-3d-paint-software.php

*Misfit Model 3D, to add bones and animations for your NPC or other models, plus to save your model as a md3 file with the animation data. be sure to get the lastest beta version
**http://www.misfitcode.com/misfitmodel3d/

*CharactorFx, for adding bones and animation to your models. It's a little older program but works great and saves to md2 files.
**http://www.insanesoftware.de/

*MD3Compile, a very quick and easy converter for md2,3ds files to a md3 file. I use it for converting my static 3ds models into a md3 file plus to rebuild my 3ds model's normals.
**http://www.quakeunity.com/file=481

*Blender, a 3D modeling program with support for animation and UV texturing with a large community behind it.
**http://www.blender.org/

*Arbaro, a tree generator written in Java which can export Wavefront OBJ files, which are supported by Sandbox.
**http://arbaro.sourceforge.net/

*Pixologic Sculptris, a sculpting-based 3D modelling program.
**http://www.pixologic.com/sculptris/

==Other==
*Notepad Plus (++), unique text tool built mainly for scripting of many different types. This can be used to edit/make CFGs in Sandbox.
**http://notepad-plus.sourceforge.net/uk/site.htm

*Audacity, a program useful for editing audio or converting audio files such as mp3 wav ogg
**http://audacity.sourceforge.net/download/

*Linux Multimedia Studio, a Linux AND Windows music making program.
**http://lmms.sourceforge.net/

For many more free programs, look at http://sourceforge.net/ and http://portableapps.com/