Function TargetNearestEntity

TombEngine/Game/control/lot.cpp:325–369

* @brief Finds and sets the nearest valid entity as the creature's enemy. * * Searches through all active creatures and the player to find the closest * valid target. Used for creature-vs-creature combat and targeting systems. * * @param item The creature looking for a target. * @param keyObjectIds List of object IDs to specifically target or ignore. * @param ignoreKeyObjectIds If true, ign

 * @param ignoreKeyObjectIds If true, ignores objects in keyObjectIds; if false, ONLY targets them.
 */
void TargetNearestEntity(ItemInfo& item, const std::vector<GAME_OBJECT_ID>& keyObjectIds, bool ignoreKeyObjectIds)
{
	auto& creature = *GetCreatureInfo(&item);
	creature.Enemy = nullptr;

	float closestDistSqr = FLT_MAX;
	for (auto creatureIndex : ActiveCreatures)
	{
		// Don't target itself.
		if (creatureIndex == item.Index)
			continue;

		auto& targetItem = g_Level.Items[creatureIndex];

		// Don't target same object type.
		if (item.ObjectNumber == targetItem.ObjectNumber)
			continue;

		// Ignore or specifically target key object IDs.
		if (!keyObjectIds.empty() && (ignoreKeyObjectIds ? Contains(keyObjectIds, targetItem.ObjectNumber) : !Contains(keyObjectIds, targetItem.ObjectNumber)))
			continue;

		// Ignore undead enemies (can't be damaged normally).
		if (Objects[targetItem.ObjectNumber].damageType != DamageMode::Any)
			continue;

		if (&targetItem != &item && targetItem.HitPoints > 0 && targetItem.Status != ITEM_INVISIBLE)
		{
			float distSqr = Vector3i::DistanceSquared(item.Pose.Position, targetItem.Pose.Position);
			if (distSqr < closestDistSqr)
			{
				creature.Enemy = &targetItem;
				closestDistSqr = distSqr;
			}
		}
	}

	// Handle player as special case (not in ActiveCreatures list).
	if (!keyObjectIds.empty() && (ignoreKeyObjectIds ? Contains(keyObjectIds, ID_LARA) : !Contains(keyObjectIds, ID_LARA)))
		return;

	float distToPlayerSqr = Vector3i::DistanceSquared(item.Pose.Position, LaraItem->Pose.Position);
	if (distToPlayerSqr < closestDistSqr)
		creature.Enemy = LaraItem;
}

/**
 * @brief Sets a specific item as the creature's AI target.