Difference between revisions of "Compiling:Surface sounds"

From Custom Map Makers Wiki
Jump to: navigation, search
(Adding the surface sounds to your map)
(Reworked article, make it newbie friendly, corrected error at the end (-se instead -si).)
Line 1: Line 1:
Surface sounds are sounds which can be added to the items in your map.
+
By default, Q3 engine does not recognize the material which are map made off. Wood, concrete, metal - for game it's only textures. However, the is simple tool for assigning textures to certain material types, which result with different sounds while player shoot at it and walk on it. Moreover,  bullets will leave different marks on surface.  Example with metal material before and after process:
 +
 
 +
[[File:Surfacesounds.jpg]]
 +
 
 +
The tool's name is BSP.
 +
 
 +
Windows version can be [[http://homepages.manx.net/urtstats/bsp.exe downloaded here.]]
 +
Linux one can be [[http://daffy.nerius.com/radiant/bsp-redone.zip downloaded here.]]
 +
 
 +
This tiny little program works with compiled version of your map - *.bsp . After successful compilation, you need to put BSP into the same folder where your *.bsp map is. BSP toll is command-line program - this means you have type commands in terminal in order to make it work. On Linux most of file managers allow You to open current folder in terminal by clicking RMB and selecting "open in terminal" option.
 +
 
 +
Note:
 +
Windows users use command bsp.exe. Linux users bsp-redone - which is simply linux version of bsp.exe.
  
In order to add surface sounds you'll need a utility called '''bsp-redone''' -
 
  
For linux You can download it here: [[http://daffy.nerius.com/radiant/bsp-redone.zip bsp-redone for Linux]]
 
For windows ...
 
For mac ...
 
  
 
==Create a surfaces file==
 
==Create a surfaces file==
First of all you'll need to create a basic surfaces file, to do this run bsp-redone with the following
+
First of all you'll need to create a basic surfaces file, to do this run BSP with the following arguments:
  
  bsp-redone -se bsp_file [surface_file]
+
  bsp.exe -se mapname.bsp mapname.surfaces
for example
 
bsp-redone -se YOURMAPNAME.bsp YOURMAPNAME.surfaces
 
  
This will create a file containing something like ..
+
 
 +
This will create a file mapname.surfaces, which is simple text files. It contains list of all textures used in a map, also the ones which are part of the models. -se means "surfaces export".
  
 
  textures/YOURMAPNAME/structure/dirtybrickstain = none
 
  textures/YOURMAPNAME/structure/dirtybrickstain = none
Line 23: Line 30:
  
 
==Edit the surfaces file==
 
==Edit the surfaces file==
You should edit this file and change all of the none values to be one of the following...
+
Value "none" means that texture material has not been specified yet. To change it, simple replace word "none" with any of the following list:
  
 
  none
 
  none
Line 67: Line 74:
 
*water - missing  
 
*water - missing  
  
These play the default or none sound when the player moves over them. It's worth noting that the grass sound is a good substitute for rug.
+
Some of the sound are missing in current Urban Terror version. You must remember that. If You use them, You'll get "ding-ding" replacement sound. It's worth noting that the grass sound is a good substitute for rug.
  
 
==Adding the surface sounds to your map==
 
==Adding the surface sounds to your map==
Line 74: Line 81:
 
To add the surface sounds to your map, the command is very similar to that used to extract the initial surface list.
 
To add the surface sounds to your map, the command is very similar to that used to extract the initial surface list.
  
  bsp-redone -se YOURMAPNAME.bsp YOURMAPNAME.surfaces
+
  bsp.exe -si mapname.bsp mapname.surfaces
 +
 
 +
-si means "surfaces import"
 +
 
 +
 
 +
Defining surfaces should be done at the end, when You are sure, you won't change anything and release your map as a alpha/beta/RC/release version.

Revision as of 15:23, 20 August 2011

By default, Q3 engine does not recognize the material which are map made off. Wood, concrete, metal - for game it's only textures. However, the is simple tool for assigning textures to certain material types, which result with different sounds while player shoot at it and walk on it. Moreover, bullets will leave different marks on surface. Example with metal material before and after process:

Surfacesounds.jpg

The tool's name is BSP.

Windows version can be [downloaded here.] Linux one can be [downloaded here.]

This tiny little program works with compiled version of your map - *.bsp . After successful compilation, you need to put BSP into the same folder where your *.bsp map is. BSP toll is command-line program - this means you have type commands in terminal in order to make it work. On Linux most of file managers allow You to open current folder in terminal by clicking RMB and selecting "open in terminal" option.

Note:
Windows users use command bsp.exe. Linux users bsp-redone - which is simply linux version of bsp.exe.


Create a surfaces file

First of all you'll need to create a basic surfaces file, to do this run BSP with the following arguments:

bsp.exe -se mapname.bsp mapname.surfaces


This will create a file mapname.surfaces, which is simple text files. It contains list of all textures used in a map, also the ones which are part of the models. -se means "surfaces export".

textures/YOURMAPNAME/structure/dirtybrickstain = none
textures/YOURMAPNAME/structure/dirtybrick = none
textures/YOURMAPNAME/decals/cokeycola = none
textures/YOURMAPNAME/decals/downwith = none
textures/YOURMAPNAME/grass/grass2 = none

Edit the surfaces file

Value "none" means that texture material has not been specified yet. To change it, simple replace word "none" with any of the following list:

none
tin
aluminum
iron
titanium
steel
copper
brass
cement
rock
gravel
pavement
brick
clay
grass
dirt
mud
snow
ice
sand
ceramictile
linoleum
rug
plaster
plastic
cardboard
hardwood
softwood
plank
glass
water
stucco

Please note: Not all surfaces sounds have a unique sound, most of the metal sounds share the same sound.

Missing sounds

  • ice - missing
  • rug - missing
  • sand - missing
  • water - missing

Some of the sound are missing in current Urban Terror version. You must remember that. If You use them, You'll get "ding-ding" replacement sound. It's worth noting that the grass sound is a good substitute for rug.

Adding the surface sounds to your map

To add the surface sounds to your map, the command is very similar to that used to extract the initial surface list.

bsp.exe -si mapname.bsp mapname.surfaces

-si means "surfaces import"


Defining surfaces should be done at the end, when You are sure, you won't change anything and release your map as a alpha/beta/RC/release version.