feat(gamestate/server): ped AI node getter

code/components/citizen-server-impl/include/state/ServerGameState.h

@@ -757,6 +757,12 @@ struct CPedMovementGroupNodeData
 	bool isRagdolling;
 };
 
+struct CPedAINodeData
+{
+	int relationShip;
+	int decisionMaker;
+};
+
 enum ePopType
 {
 	POPTYPE_UNKNOWN = 0,
@@ -851,6 +857,8 @@ struct SyncTreeBase
 
 	virtual CPedMovementGroupNodeData* GetPedMovementGroup() = 0;
 
+	virtual CPedAINodeData* GetPedAI() = 0;
+
 	virtual void CalculatePosition() = 0;
 
 	virtual bool GetPopulationType(ePopType* popType) = 0;

code/components/citizen-server-impl/include/state/SyncTrees_Five.h

@@ -2466,9 +2466,20 @@ struct CPedMovementGroupDataNode
 
 		return true;
 	}
-};
+};
+
+struct CPedAIDataNode : GenericSerializeDataNode<CPedAIDataNode>
+{
+	CPedAINodeData data;
 
-struct CPedAIDataNode { };
+	template<typename Serializer>
+	bool Serialize(Serializer& s)
+	{
+		s.Serialize(32, data.relationShip);
+		s.Serialize(32, data.decisionMaker);
+		return true;
+	}
+};
 
 struct CPedAppearanceDataNode
 {
@@ -4068,6 +4079,13 @@ struct SyncTree : public SyncTreeBaseImpl<TNode, false>
 	{
 		auto [hasNode, node] = this->template GetData<CPedMovementGroupDataNode>();
 
+		return hasNode ? &node->data : nullptr;
+	}
+
+	virtual CPedAINodeData* GetPedAI() override
+	{
+		auto [hasNode, node] = this->template GetData<CPedAIDataNode>();
+
 		return hasNode ? &node->data : nullptr;
 	}
 

code/components/citizen-server-impl/include/state/SyncTrees_RDR3.h

@@ -1311,6 +1311,11 @@ struct SyncTree : public SyncTreeBaseImpl<TNode, true>
 		return nullptr;
 	}
 
+	virtual CPedAINodeData* GetPedAI() override
+	{
+		return nullptr;
+	}
+
 	virtual void CalculatePosition() override
 	{
 		// TODO: cache it?

code/components/citizen-server-impl/src/state/ServerGameState_Scripting.cpp

@@ -1862,6 +1862,12 @@ static void Init()
 		return 0;
 	}));
 
+	fx::ScriptEngine::RegisterNativeHandler("GET_PED_RELATIONSHIP_GROUP_HASH", makeEntityFunction([](fx::ScriptContext& context, const fx::sync::SyncEntityPtr& entity)
+	{
+		auto ped = entity->syncTree->GetPedAI();
+		return ped ? ped->relationShip : 0;
+	}));
+
 	fx::ScriptEngine::RegisterNativeHandler("GET_ENTITY_SPEED", makeEntityFunction([](fx::ScriptContext& context, const fx::sync::SyncEntityPtr& entity)
 	{
 		auto v = entity->syncTree->GetVelocity();

ext/native-decls/GetPedRelationshipGroupHash.md

@@ -0,0 +1,17 @@
+---
+ns: CFX
+apiset: server
+---
+## GET_PED_RELATIONSHIP_GROUP_HASH
+
+```c
+Hash GET_PED_RELATIONSHIP_GROUP_HASH(Ped ped);
+```
+
+Gets the current relationship group hash of a ped.
+
+## Parameters
+* **ped**: The target ped
+
+## Return value
+The relationship group hash.