Added setter for soundcontainer top level soundset, useful for changing gun sounds and such

Author: garethyr

CHANGELOG.md

@@ -631,7 +631,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 	Additionally, `AddSound` and `AddSoundSet` INI properties work for `SoundSets`. They are exactly the same as they are for `SoundContainers`.
 
-- You can get the top level `SoundSet` of a `SoundContainer` with `soundContainer:GetTopLevelSoundSet` and manipulate it as described above. This allows you full interaction with all levels of `SoundSets` in a `SoundContainer`.
+- You can get the top level `SoundSet` of a `SoundContainer` with `soundContainer:GetTopLevelSoundSet` and manipulate it as described above. You can also set it to fully overwrite it with `soundContainer:SetTopLevelSoundSet`. This allows you full interaction with all levels of `SoundSets` in a `SoundContainer`.
 
 </details>
 

Entities/SoundContainer.h

@@ -88,6 +88,12 @@ namespace RTE {
 		/// <returns>A reference to the top level SoundSet of this SoundContainer.</returns>
 		SoundSet & GetTopLevelSoundSet() { return m_TopLevelSoundSet; }
 
+		/// <summary>
+		/// Copies the passed in SoundSet reference into the top level SoundSet of this SoundContainer, effectively making that the new top level SoundSet.
+		/// </summary>
+		/// <param name="newTopLevelSoundSet">A reference to the new top level SoundSet for this SoundContainer.</param>
+		void SetTopLevelSoundSet(SoundSet &newTopLevelSoundSet) { m_TopLevelSoundSet = newTopLevelSoundSet; }
+
 		/// <summary>
 		/// Gets a vector of hashes of the sounds selected to be played next in this SoundContainer.
 		/// </summary>

Lua/LuaBindingsEntities.cpp

@@ -1113,6 +1113,7 @@ namespace RTE {
 
 		.def("HasAnySounds", &SoundContainer::HasAnySounds)
 		.def("GetTopLevelSoundSet", &SoundContainer::GetTopLevelSoundSet)
+		.def("SetTopLevelSoundSet", &SoundContainer::SetTopLevelSoundSet)
 		.def("IsBeingPlayed", &SoundContainer::IsBeingPlayed)
 		.def("Play", (bool (SoundContainer:: *)()) &SoundContainer::Play)
 		.def("Play", (bool (SoundContainer:: *)(const int player)) &SoundContainer::Play)