Function GetCreatureMood

TombEngine/Game/control/box.cpp:2780–2902

* @brief Determines the creature's mood based on its situation. * * MOOD TYPES: * - Bored: Wandering randomly, not actively engaged. * - Attack: Directly pursuing and attacking the enemy. * - Escape: Fleeing from the enemy. * - Stalk: Following the enemy at a distance, waiting to attack. * * MOOD TRANSITIONS: * - Bored/Stalk -> Attack: When in same zone as enemy and close enough. * - Att

 * @param isViolent If true, creature is aggressive (no stalking behavior).
 */
void GetCreatureMood(ItemInfo* item, AI_INFO* AI, bool isViolent)
{
	if (!item->IsCreature())
		return;

	auto* creature = GetCreatureInfo(item);
	auto* enemy = creature->Enemy;
	auto* LOT = &creature->LOT;

	// Clear target if creature is in a blocked box.
	if (item->BoxNumber == NO_VALUE || creature->LOT.Node[item->BoxNumber].searchNumber == (creature->LOT.SearchNumber | SEARCH_BLOCKED))
		creature->LOT.RequiredBox = NO_VALUE;

	// Clear target if it's no longer valid (different zone, blocked, etc.)
	if (creature->Mood != MoodType::Attack && creature->LOT.RequiredBox != NO_VALUE && !ValidBox(item, AI->zoneNumber, creature->LOT.TargetBox))
	{
		if (AI->zoneNumber == AI->enemyZone)
			creature->Mood = MoodType::Bored;

		creature->LOT.RequiredBox = NO_VALUE;
	}

	// Store current mood to detect changes later.
	auto mood = creature->Mood;

	// MOOD DECISION LOGIC
	// Based on enemy state, creature state, and zone relationships.
	if (enemy)
	{
		// Enemy is dead - go back to idle wandering.
		if (enemy->HitPoints <= 0 && enemy == LaraItem) // TODO: deal with LaraItem global !
		{
			creature->Mood = MoodType::Bored;
		}
		else if (isViolent)
		{
			// VIOLENT CREATURE BEHAVIOR
			// These creatures are highly aggressive - they don't stalk, only attack or flee.
			switch (creature->Mood)
			{
			case MoodType::Bored:
			case MoodType::Stalk:
				// Same zone = can reach enemy, so attack immediately.
				if (AI->zoneNumber == AI->enemyZone)
					creature->Mood = MoodType::Attack;
				// Got hit but can't reach enemy - flee instead.
				else if (item->HitStatus)
					creature->Mood = MoodType::Escape;

				break;

			case MoodType::Attack:
				// Lost access to enemy's zone - give up and wander.
				if (AI->zoneNumber != AI->enemyZone)
					creature->Mood = MoodType::Bored;

				break;