Subscribe to download
Sound Blocks

Special Effects Mod works well with this one!

After about a week of work on this mod, I am finally happy to have it working the way I want.
Not only can you play with preloaded sounds, you can also add your own!
Refer to the instructions for more information.
Additionally, you can use the mod in multiplayer to play the preloaded sounds for your friends to hear! (custom sounds not supported in MP)
Sound format requirements are a bit less restrictive than the previous mod: both wav and ogg work, but maybe others do too.

Oh, by the way, there is no mute option in multiplayer... Have fun!

• Play preloaded and custom sounds.
  
• Multiplayer compatible.
  
• Toggle/Push mode (on/off): press key once to play the audio clip entirely or push-to-play.
  
• Loop mode (on/off): replay audio clip.
  
  • when in toggle mode: will loop until you press the key again.
    
  • when in push mode: will loop while the key is down.
• Time Dependency (on/off): sound pitch will change with respect to the timescale (i.e. Slow-mo audio!)
  
• Distance Dependency (on/off): the further you are, the quieter the sound will be.
  
  • Max distance: distance at which sound will completely stop.
• Velocity Dependency (on/off): the faster you move, the higher the pitch.
  
  • Min Velocity Pitch (any value): pitch value when you don't move.
    
  • Max Velocity Pitch (any value): pitch value when you move very fast.
• Burn effect (on/off): if the block catches fire, pitch will increase and volume decrease until you cannot hear the block.
  
• Special mode: press and hold to start the engine sound, which then goes into a sound loop of the engine running. If you depress the key, a third sound of the engine shutting down will play. Car and plane special mode available.
  
• Volume (0 to 1): volume of the sound.
  
• Pitch (any value): adjust the pitch of the clip (use this to scale the Velocity Dependency option to your liking).

• Go to the mod's steam workshop folder (you may need to launch Besiege once for the mod to download, then close it to add sounds):
  
  • ...\SteamApps\workshop\content\346010\1493925387\SoundBlocks\Resources
• Place your sound file (.wav and .ogg will work) in the "\SoundBlocks\Resources\Sounds" folder.
  
• Please Backup these sound files somewhere as they will be deleted everytime I make an update to the mod!
  
• Go back two folders and open these two files with Notepad: "Mod.xml" and "SoundBlock.xml"
  
• In the "Mod.xml" file add your sound's name and path. Example: "MySound.ogg" would be:
  <AudioClip name="MySound" path="Sounds\MySound.ogg" />
  
• In the "SoundBlock.xml" file add just the sound's name. Following the example:
  <AudioClip name="MySound" />
  
• Save both files.
  
• Launch Besiege and it should be good!

• Add the 3 sounds in the "Mod.xml" file as mentionned above
  
• Also add the 3 sounds in the "\SoundBlocks\Resources\Sounds" folder
  
• Open the "SoundBlock.xml" file
  
• In the section starting with <CustomMode> add your own mode with its name and the 3 sounds it is made up of:
  <Mode name="MyMode" Sound_1="ClipA" Sound_2="ClipB" Sound_3="ClipC" />
  
• Save both files, launch Besiege

For modders:
You CANNOT use the module I have in the "SoundBlock.xml".
The reason you can't is because your mod would ask this mod to load files in this mod's folder. Thus you would be unable to make a mod with your own sounds. You could however use the preloaded sounds present in this mod in your mods (then go for it, I don't mind)

Thanks to the following who helped me make this mod:

• Kuroko: For the wonderful texture and model of the block!
  
• DialY and Akyer: for being my test subjects!

See Change Notes for information about changes made.