Added lua r/w access to AHuman upper body state

Author: garethyr

CHANGELOG.md

@@ -495,6 +495,8 @@ This can be accessed via the new Lua (R/W) `SettingsMan` property `AIUpdateInter
 - Added Lua convenience function `RoundToNearestMultiple(num, multiple)` which returns a number rounded to the nearest specified multiple.  
 	Note that this operates on integers, so fractional parts will be truncated towards zero by type conversion.
 
+- Added `AHuman` Lua property (R/W) `UpperBodyState`, that lets you get and set the `AHuman`'s `UpperBodyState`. If you don't know what this does, you probably don't need or want it.
+
 </details>
 
 <details><summary><b>Changed</b></summary>

Entities/AHuman.h

@@ -577,6 +577,18 @@ DefaultPieMenuNameGetter("Default Human Pie Menu");
 	/// </summary>
 	void UnequipArms() { UnequipFGArm(); UnequipBGArm(); }
 
+	/// <summary>
+	/// Gets this AHuman's UpperBodyState.
+	/// </summary>
+	/// <returns>This AHuman's UpperBodyState.</returns>
+	UpperBodyState GetUpperBodyState() const { return m_ArmsState; }
+
+	/// <summary>
+	/// Sets this AHuman's UpperBodyState to the new state.
+	/// </summary>
+	/// <param name="newUpperBodyState">This AHuman's new UpperBodyState.</param>
+	void SetUpperBodyState(UpperBodyState newUpperBodyState) { m_ArmsState = newUpperBodyState; }
+
 
 //////////////////////////////////////////////////////////////////////////////////////////
 // Method:  GetEquippedItem

Lua/LuaBindingsEntities.cpp

@@ -440,6 +440,7 @@ namespace RTE {
 		.property("LimbPathPushForce", &AHuman::GetLimbPathPushForce, &AHuman::SetLimbPathPushForce)
 		.property("IsClimbing", &AHuman::IsClimbing)
 		.property("ArmSwingRate", &AHuman::GetArmSwingRate, &AHuman::SetArmSwingRate)
+		.property("UpperBodyState", &AHuman::GetUpperBodyState, &AHuman::SetUpperBodyState)
 
 		.def("EquipFirearm", &AHuman::EquipFirearm)
 		.def("EquipThrowable", &AHuman::EquipThrowable)