Sound Blocks

If you liked this item, please rate it up on Steam Workshop page.

Authors: DialY, Akyer :3, wizz6rd, 🎀Kuroko

Last revision: 13 Jan, 2019 at 20:06 UTC

File size: 10.26 MB

On Steam Workshop

Description:

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!

Features
  • 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).

Instructions for adding custom sounds:
  • 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):
    • …SteamAppsworkshopcontent3460101493925387SoundBlocksResources
  • Place your sound file (.wav and .ogg will work) in the "SoundBlocksResourcesSounds" 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="SoundsMySound.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!

To add more custom modes (the built-in "car" and "plane" modes):
  • Add the 3 sounds in the "Mod.xml" file as mentionned above
  • Also add the 3 sounds in the "SoundBlocksResourcesSounds" 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:

See Change Notes for information about changes made.