Added AHuman property EquippedMass

Author: fourZK

CHANGELOG.md

@@ -275,6 +275,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 - New `AEmitter` and `PEmitter` Lua (R) property `ThrottleFactor`, which gets the throttle strength as a multiplier value that factors in either the positive or negative throttle multiplier according to throttle.
 
+- New `AHuman` Lua (R) property `EquippedMass`, which returns the total mass of any `HeldDevice`s currently equipped by the actor.
+
 </details>
 
 <details><summary><b>Changed</b></summary>

Entities/AHuman.cpp

@@ -1464,6 +1464,19 @@ MovableObject * AHuman::GetEquippedBGItem() const
 	return 0;
 }
 
+//////////////////////////////////////////////////////////////////////////////////////////
+
+float AHuman::GetEquippedMass() const {
+	float equippedMass = 0;
+	if (MovableObject *fgDevice = GetEquippedItem()) {
+		equippedMass += fgDevice->GetMass();
+	}
+	if (MovableObject *bgDevice = GetEquippedBGItem()) {
+		equippedMass += bgDevice->GetMass();
+	}
+	return equippedMass;
+}
+
 //////////////////////////////////////////////////////////////////////////////////////////
 // Virtual Method:  FirearmIsReady
 //////////////////////////////////////////////////////////////////////////////////////////

Entities/AHuman.h

@@ -607,6 +607,13 @@ ClassInfoGetters;
 	MovableObject * GetEquippedBGItem() const;
 
 
+	/// <summary>
+	/// Gets the total mass of this AHuman's currently equipped devices.
+	/// </summary>
+	/// <returns>The mass of this AHuman's equipped devices.</returns>
+	float GetEquippedMass() const;
+
+
 //////////////////////////////////////////////////////////////////////////////////////////
 // Virtual Method:  FirearmIsReady
 //////////////////////////////////////////////////////////////////////////////////////////

Lua/LuaBindingsEntities.cpp

@@ -418,6 +418,7 @@ namespace RTE {
 		.property("ThrowProgress", &AHuman::GetThrowProgress)
 		.property("EquippedItem", &AHuman::GetEquippedItem)
 		.property("EquippedBGItem", &AHuman::GetEquippedBGItem)
+		.property("EquippedMass", &AHuman::GetEquippedMass)
 		.property("FirearmIsReady", &AHuman::FirearmIsReady)
 		.property("ThrowableIsReady", &AHuman::ThrowableIsReady)
 		.property("FirearmIsEmpty", &AHuman::FirearmIsEmpty)