Function UpdateBadBoxes

TombEngine/Game/control/box.cpp:621–664

* @brief Updates the creature's bad box memory. * * Creature's bad box memory mechanism prevents softlocks against * problematic geometry while still allowing recovery if creature has * already left problematic area. * * @param item Pointer to the item representing a creature. */

 * @param item Pointer to the item representing a creature.
 */
static void UpdateBadBoxes(ItemInfo* item)
{
	if (!item->IsCreature())
		return;

	auto& LOT = GetCreatureInfo(item)->LOT;
	int penaltyThreshold = g_GameFlow->GetSettings()->Pathfinding.CollisionPenaltyThreshold * FPS;
	int penaltyCooldown  = g_GameFlow->GetSettings()->Pathfinding.CollisionPenaltyCooldown  * FPS;

	for (auto& badBox : LOT.BadBoxes)
	{
		if (badBox.BoxNumber == NO_VALUE)
			continue;

		if (badBox.Count > 0)
		{
			if (badBox.Count >= penaltyThreshold)
			{
				// If penalty has built up, flip into cooldown exactly at limit.
				badBox.Count = -penaltyCooldown;
				LOT.TargetBox = NO_VALUE;
				ClearLOT(&LOT);
				return;
			}
			else if (!badBox.Valid)
			{
				// If box wasn't queried for current loop, reduce penalty count.
				badBox.Count--;
			}
		}
		else if (badBox.Count < 0)
		{
			// Cooldown the bad box.
			badBox.Count++;
		}

		// Forget the bad box, if timeout has elapsed.
		if (badBox.Count == 0)
			badBox.BoxNumber = NO_VALUE;

		// Invalidate the bad box until the next query.
		badBox.Valid = false;
	}
}

/**
 * @brief Handles creature movement, collision, and positioning after animation.