Function ValidBox

TombEngine/Game/control/box.cpp:1561–1587

* @brief Checks if a box is a valid pathfinding target for a creature. * * A box is valid if: * 1. It exists (not NO_VALUE). * 2. It's in the same zone as the creature (unless creature can fly/swim). * 3. It's not blocked by the creature's BlockMask. * 4. The creature is NOT currently standing inside it (prevents targeting current box). * * Used when selecting random boxes for Bored/Escape

 * @return true if the box is a valid target.
 */
bool ValidBox(ItemInfo* item, short zoneNumber, short boxNumber)
{
	if (boxNumber == NO_VALUE)
		return false;

	const auto& creature = *GetCreatureInfo(item);
	const auto& zone = g_Level.Zones[(int)creature.LOT.Zone][(int)FlipStatus].data();

	// Creatures that can move in 3D (fly/swim) bypass zone check.
	if (creature.LOT.Fly == NO_FLYING && zone[boxNumber] != zoneNumber)
		return false;

	const auto& box = g_Level.PathfindingBoxes[boxNumber];
	if (creature.LOT.BlockMask & box.flags)
		return false;

	// Don't target the box we're currently standing in.
	if (item->Pose.Position.z > (box.left * BLOCK(1)) &&
		item->Pose.Position.z < (box.right * BLOCK(1)) &&
		item->Pose.Position.x > (box.top * BLOCK(1)) &&
		item->Pose.Position.x < (box.bottom * BLOCK(1)))
	{
		return false;
	}

	return true;
}

/**
 * @brief Checks if a box is suitable for escaping from an enemy.