path: root/src/Entities/Pawn.cpp

#include "Globals.h"  // NOTE: MSVC stupidness requires this to be the same across all modules

#include "Pawn.h"
#include "Player.h"
#include "../BlockInfo.h"
#include "../World.h"
#include "../Bindings/PluginManager.h"
#include "../BoundingBox.h"
#include "../Blocks/BlockHandler.h"
#include "../Blocks/BlockFarmland.h"
#include "../EffectID.h"
#include "../Mobs/Monster.h"




cPawn::cPawn(eEntityType a_EntityType, float a_Width, float a_Height) :
	Super(a_EntityType, Vector3d(), a_Width, a_Height),
	m_EntityEffects(tEffectMap()),
	m_LastGroundHeight(0),
	m_bTouchGround(false)
{
	SetGravity(-32.0f);
	SetAirDrag(0.02f);
}





void cPawn::Tick(std::chrono::milliseconds a_Dt, cChunk & a_Chunk)
{
	std::vector<cEntityEffect *> EffectsToTick;

	// Iterate through this entity's applied effects
	for (tEffectMap::iterator iter = m_EntityEffects.begin(); iter != m_EntityEffects.end();)
	{
		// Copies values to prevent pesky wrong accesses and erasures
		cEntityEffect::eType EffectType = iter->first;
		cEntityEffect * Effect = iter->second.get();

		// Iterates (must be called before any possible erasure)
		++iter;

		// Remove effect if duration has elapsed
		if (Effect->GetDuration() - Effect->GetTicks() <= 0)
		{
			RemoveEntityEffect(EffectType);
		}
		// Call OnTick later to make sure the iterator won't be invalid
		else
		{
			EffectsToTick.push_back(Effect);
		}

		// TODO: Check for discrepancies between client and server effect values
	}


	for (auto * Effect : EffectsToTick)
	{
		Effect->OnTick(*this);
	}

	// Spectators cannot push entities around
	if ((!IsPlayer()) || (!static_cast<cPlayer *>(this)->IsGameModeSpectator()))
	{
		m_World->ForEachEntityInBox(
			GetBoundingBox(),
			[=](cEntity & a_Entity)
			{
				if (a_Entity.GetUniqueID() == GetUniqueID())
				{
					return false;
				}

				// we only push other mobs, boats and minecarts
				if ((a_Entity.GetEntityType() != etMonster) && (a_Entity.GetEntityType() != etMinecart) &&
					(a_Entity.GetEntityType() != etBoat))
				{
					return false;
				}

				// do not push a boat / minecart you're sitting in
				if (IsAttachedTo(&a_Entity))
				{
					return false;
				}

				Vector3d v3Delta = a_Entity.GetPosition() - GetPosition();
				v3Delta.y = 0.0;  // we only push sideways
				v3Delta *= 1.0 / (v3Delta.Length() + 0.01);  // we push harder if we're close
				// QUESTION: is there an additional multiplier for this? current shoving seems a bit weak

				a_Entity.AddSpeed(v3Delta);
				return false;
			}
		);
	}

	Super::Tick(a_Dt, a_Chunk);
	if (!IsTicking())
	{
		// The base class tick destroyed us
		return;
	}
	HandleFalling();

	// Handle item pickup
	if (m_Health > 0)
	{
		if (IsPlayer())
		{
			m_World->CollectPickupsByEntity(*this);
		}
		else if (IsMob())
		{
			cMonster & Mob = static_cast<cMonster &>(*this);
			if (Mob.CanPickUpLoot())
			{
				m_World->CollectPickupsByEntity(*this);
			}
		}
	}
}





void cPawn::KilledBy(TakeDamageInfo & a_TDI)
{
	ClearEntityEffects();

	// Is death eligible for totem reanimation?
	if (DeductTotem(a_TDI.DamageType))
	{
		m_World->BroadcastEntityAnimation(*this, EntityAnimation::PawnTotemActivates);

		AddEntityEffect(cEntityEffect::effAbsorption, 100, 1);
		AddEntityEffect(cEntityEffect::effRegeneration, 900, 1);
		AddEntityEffect(cEntityEffect::effFireResistance, 800, 0);

		m_Health = 1;
		return;
	}

	Super::KilledBy(a_TDI);
}





bool cPawn::IsFireproof(void) const
{
	return Super::IsFireproof() || HasEntityEffect(cEntityEffect::effFireResistance);
}





bool cPawn::IsInvisible() const
{
	return HasEntityEffect(cEntityEffect::effInvisibility);
}





void cPawn::HandleAir(void)
{
	if (IsHeadInWater() && HasEntityEffect(cEntityEffect::effWaterBreathing))
	{
		// Prevent the oxygen from decreasing
		return;
	}

	Super::HandleAir();
}





void cPawn::AddEntityEffect(
	cEntityEffect::eType a_EffectType,
	int a_Duration,
	short a_Intensity,
	double a_DistanceModifier
)
{
	// Check if the plugins allow the addition:
	if (cPluginManager::Get()
			->CallHookEntityAddEffect(*this, a_EffectType, a_Duration, a_Intensity, a_DistanceModifier))
	{
		// A plugin disallows the addition, bail out.
		return;
	}

	// No need to add empty effects:
	if (a_EffectType == cEntityEffect::effNoEffect)
	{
		return;
	}
	a_Duration = static_cast<int>(a_Duration * a_DistanceModifier);

	// If we already have the effect, we have to deactivate it or else it will act cumulatively
	auto ExistingEffect = m_EntityEffects.find(a_EffectType);
	if (ExistingEffect != m_EntityEffects.end())
	{
		ExistingEffect->second->OnDeactivate(*this);
	}

	auto Res = m_EntityEffects.emplace(
		a_EffectType,
		cEntityEffect::CreateEntityEffect(a_EffectType, a_Duration, a_Intensity, a_DistanceModifier)
	);
	m_World->BroadcastEntityEffect(*this, a_EffectType, a_Intensity, a_Duration);
	cEntityEffect * Effect = Res.first->second.get();
	Effect->OnActivate(*this);
}





void cPawn::RemoveEntityEffect(cEntityEffect::eType a_EffectType)
{
	m_World->BroadcastRemoveEntityEffect(*this, a_EffectType);
	auto itr = m_EntityEffects.find(a_EffectType);
	if (itr != m_EntityEffects.end())
	{
		// Erase from effect map before calling OnDeactivate to allow metadata broadcasts (e.g. for invisibility effect)
		auto Effect = std::move(itr->second);
		m_EntityEffects.erase(itr);
		Effect->OnDeactivate(*this);
	}
}





bool cPawn::HasEntityEffect(cEntityEffect::eType a_EffectType) const
{
	return m_EntityEffects.find(a_EffectType) != m_EntityEffects.end();
}





void cPawn::ClearEntityEffects()
{
	// Iterate through this entity's applied effects
	for (tEffectMap::iterator iter = m_EntityEffects.begin(); iter != m_EntityEffects.end();)
	{
		// Copy values to prevent pesky wrong erasures
		cEntityEffect::eType EffectType = iter->first;

		// Iterates (must be called before any possible erasure)
		++iter;

		// Remove effect
		RemoveEntityEffect(EffectType);
	}
}





void cPawn::NoLongerTargetingMe(cMonster * a_Monster)
{
	ASSERT(IsTicking());  // Our destroy override is supposed to clear all targets before we're destroyed.
	for (auto i = m_TargetingMe.begin(); i != m_TargetingMe.end(); ++i)
	{
		cMonster * Monster = *i;
		if (Monster == a_Monster)
		{
			ASSERT(
				Monster->GetTarget() != this
			);  // The monster is notifying us it is no longer targeting us, assert if that's a lie
			m_TargetingMe.erase(i);
			return;
		}
	}
	ASSERT(false);  // If this happens, something is wrong. Perhaps the monster never called TargetingMe() or called
					// NoLongerTargetingMe() twice.
}





void cPawn::TargetingMe(cMonster * a_Monster)
{
	ASSERT(IsTicking());
	ASSERT(m_TargetingMe.size() < 10000);
	ASSERT(a_Monster->GetTarget() == this);
	m_TargetingMe.push_back(a_Monster);
}





void cPawn::HandleFalling(void)
{
	/* Not pretty looking, and is more suited to wherever server-sided collision detection is implemented.
	The following condition sets on-ground-ness if
	The player isn't swimming or flying (client hardcoded conditions) and
	they're on a block (Y is exact) - ensure any they could be standing on (including on the edges) is solid or
	they're on a slab (Y significand is 0.5) - ditto with slab check
	they're on a snow layer (Y divisible by 0.125) - ditto with snow layer check
	*/

	static const auto HalfWidth = GetWidth() / 2;
	static const auto EPS = 0.0001;

	/* Since swimming is decided in a tick and is asynchronous to this, we have to check for dampeners ourselves.
	The behaviour as of 1.8.9 is the following:
	- Landing in water alleviates all fall damage
	- Passing through any liquid (water + lava) and cobwebs "slows" the player down,
	i.e. resets the fall distance to that block, but only after checking for fall damage
	(this means that plummeting into lava will still kill the player via fall damage, although cobwebs
	will slow players down enough to have multiple updates that keep them alive)
	- Slime blocks reverse falling velocity, unless it's a crouching player, in which case they act as standard blocks.
	They also reset the topmost point of the damage calculation with each bounce,
	so if the block is removed while the player is bouncing or crouches after a bounce, the last bounce's zenith is
	considered as fall damage.

	With this in mind, we first check the block at the player's feet, then the one below that (because fences),
	and decide which behaviour we want to go with.
	*/
	const auto BlockAtFoot =
		(cChunkDef::IsValidHeight(POS_TOINT)) ? GetWorld()->GetBlock(POS_TOINT) : static_cast<BLOCKTYPE>(E_BLOCK_AIR);

	/* We initialize these with what the foot is really IN, because for sampling we will move down with the epsilon
	 * above */
	bool IsFootInWater = IsBlockWater(BlockAtFoot);
	bool IsFootOnSlimeBlock = false;

	/* The "cross" we sample around to account for the player width/girth */
	static const struct
	{
		int x, z;
	} CrossSampleCoords[] = {
		{0, 0},
		{1, 0},
		{-1, 0},
		{0, 1},
		{0, -1},
	};

	/* The blocks we're interested in relative to the player to account for larger than 1 blocks.
	This can be extended to do additional checks in case there are blocks that are represented as one block
	in memory but have a hitbox larger than 1 (like fences) */
	static const Vector3i BlockSampleOffsets[] = {
		{0, 0, 0},  // TODO: something went wrong here (offset 0?)
		{0, -1, 0},  // Potentially causes mis-detection (IsFootInWater) when player stands on block diagonal to water
					 // (i.e. on side of pool)
	};

	/* Here's the rough outline of how this mechanism works:
	We take the player's pointlike position (sole of feet), and expand it into a crosslike shape.
	If any of the five points hit a block, we consider the player to be "on" (or "in") the ground. */
	bool OnGround = false;
	for (size_t i = 0; i < ARRAYCOUNT(CrossSampleCoords); i++)
	{
		/* We calculate from the player's position, one of the cross-offsets above, and we move it down slightly so it's
		beyond inaccuracy. The added advantage of this method is that if the player is simply standing on the floor, the
		point will move into the next block, and the floor() will retrieve that instead of air. */
		Vector3d CrossTestPosition =
			GetPosition() + Vector3d(CrossSampleCoords[i].x * HalfWidth, -EPS, CrossSampleCoords[i].z * HalfWidth);

		/* We go through the blocks that we consider "relevant" */
		for (size_t j = 0; j < ARRAYCOUNT(BlockSampleOffsets); j++)
		{
			Vector3i BlockTestPosition = CrossTestPosition.Floor() + BlockSampleOffsets[j];

			if (!cChunkDef::IsValidHeight(BlockTestPosition))
			{
				continue;
			}

			BLOCKTYPE BlockType = GetWorld()->GetBlock(BlockTestPosition);
			NIBBLETYPE BlockMeta = GetWorld()->GetBlockMeta(BlockTestPosition);

			/* we do the cross-shaped sampling to check for water / liquids, but only on our level because water blocks
			 * are never bigger than unit voxels */
			if (j == 0)
			{
				IsFootInWater |= IsBlockWater(BlockType);
				IsFootOnSlimeBlock |= (BlockType == E_BLOCK_SLIME_BLOCK);
			}

			/* If the block is solid, and the blockhandler confirms the block to be inside, we're officially on the
			 * ground. */
			if ((cBlockInfo::IsSolid(BlockType)) &&
				(cBlockHandler::For(BlockType).IsInsideBlock(CrossTestPosition - BlockTestPosition, BlockMeta)))
			{
				OnGround = true;
			}
		}
	}

	/* So here's the use of the rules above: */
	/* 1. Falling in water absorbs all fall damage */
	bool FallDamageAbsorbed = IsFootInWater;

	/* 2. Falling in liquid (lava, water, cobweb) or hitting a slime block resets the "fall zenith".
	Note: Even though the pawn bounces back with no damage after hitting the slime block,
	the "fall zenith" will continue to increase back up when flying upwards - which is good */
	bool ShouldBounceOnSlime = true;

	if (IsPlayer())
	{
		auto Player = static_cast<cPlayer *>(this);

		/* 3. If the player is flying or climbing, absorb fall damage */
		FallDamageAbsorbed |= Player->IsFlying() || Player->IsClimbing();

		/* 4. If the player is about to bounce on a slime block and is not crouching, absorb all fall damage  */
		ShouldBounceOnSlime = !Player->IsCrouched();
		FallDamageAbsorbed |= (IsFootOnSlimeBlock && ShouldBounceOnSlime);
	}
	else
	{
		/* 5. Bouncing on a slime block absorbs all fall damage  */
		FallDamageAbsorbed |= IsFootOnSlimeBlock;
	}

	/* If the player is not crouching or is not a player, shoot them back up.
	NOTE: this will only work in some cases; should be done in HandlePhysics() */
	if (IsFootOnSlimeBlock && ShouldBounceOnSlime)
	{
		// TODO: doesn't work too well, causes dissatisfactory experience for players on slime blocks -
		// SetSpeedY(-GetSpeedY());
	}

	// TODO: put player speed into GetSpeedY, and use that.
	// If flying, climbing, swimming, or going up...
	if (FallDamageAbsorbed || ((GetPosition() - m_LastPosition).y > 0))
	{
		// ...update the ground height to have the highest position of the player (i.e. jumping up adds to the eventual
		// fall damage)
		m_LastGroundHeight = GetPosY();
	}

	if (OnGround)
	{
		const auto FallHeight = m_LastGroundHeight - GetPosY();
		auto Damage = static_cast<int>(FallHeight - 3.0);

		const auto Below = POS_TOINT.addedY(-1);
		const auto BlockBelow =
			(cChunkDef::IsValidHeight(Below)) ? GetWorld()->GetBlock(Below) : static_cast<BLOCKTYPE>(E_BLOCK_AIR);

		if ((Damage > 0) && !FallDamageAbsorbed)
		{
			if (IsElytraFlying())
			{
				Damage = static_cast<int>(static_cast<float>(Damage) * 0.33);
			}

			if (BlockBelow == E_BLOCK_HAY_BALE)
			{
				Damage = std::clamp(static_cast<int>(static_cast<float>(Damage) * 0.2), 1, 20);
			}

			// Fall particles
			// TODO: falling on a partial (e.g. slab) block shouldn't broadcast particles of the block below
			GetWorld()->BroadcastParticleEffect(
				"blockdust",
				GetPosition(),
				{0, 0, 0},
				(Damage - 1.f) * ((0.3f - 0.1f) / (15.f - 1.f)) +
					0.1f,  // Map damage (1 - 15) to particle speed (0.1 - 0.3)
				static_cast<int>(
					(Damage - 1.f) * ((50.f - 20.f) / (15.f - 1.f)) + 20.f
				),  // Map damage (1 - 15) to particle quantity (20 - 50)
				{{BlockBelow, 0}}
			);

			TakeDamage(dtFalling, nullptr, Damage, static_cast<float>(Damage), 0);
		}

		m_bTouchGround = true;
		m_LastGroundHeight = GetPosY();

		// Farmland trampling. Mobs smaller than 0.512 cubic blocks won't trample (Java Edition's behavior)
		// We only have width and height, so we have to calculate Width^2
		if (GetWorld()->IsFarmlandTramplingEnabled())
		{
			HandleFarmlandTrampling(FallHeight, BlockAtFoot, BlockBelow);
		}
	}
	else
	{
		m_bTouchGround = false;
	}

	/* Note: it is currently possible to fall through lava and still die from fall damage
	because of the client skipping an update about the lava block. This can only be resolved by
	somehow integrating these above checks into the tracer in HandlePhysics. */
}





void cPawn::HandleFarmlandTrampling(
	const double a_FallHeight,
	const BLOCKTYPE a_BlockAtFoot,
	const BLOCKTYPE a_BlockBelow
)
{
	// No trampling if FallHeight <= 0.6875
	if (a_FallHeight <= 0.6875)
	{
		return;
	}
	// No trampling for mobs smaller than 0.512 cubic blocks
	if (GetWidth() * GetWidth() * GetHeight() < 0.512)
	{
		return;
	}

	auto AbsPos = POS_TOINT;

	// Check if the foot is "inside" a farmland - for 1.10.1 and newer clients
	// If it isn't, check if the block below is a farmland - for mobs and older clients
	if (a_BlockAtFoot != E_BLOCK_FARMLAND)
	{
		// These are probably the only blocks which:
		// - can be placed on a farmland and shouldn't destroy it
		// - will stop the player from falling down further
		// - are less than 1 block high
		if ((a_BlockAtFoot == E_BLOCK_HEAD) || (a_BlockAtFoot == E_BLOCK_FLOWER_POT))
		{
			return;
		}

		// Finally, check whether the block below is farmland
		if (a_BlockBelow != E_BLOCK_FARMLAND)
		{
			return;
		}

		// If we haven't returned, decrease the height
		AbsPos.y -= 1;
	}

	bool ShouldTrample = true;
	auto & Random = GetRandomProvider();

	// For FallHeight <= 1.5625 we need to get a random bool
	if (a_FallHeight <= 1.0625)
	{
		ShouldTrample = Random.RandBool(0.25);
	}
	else if (a_FallHeight <= 1.5625)
	{
		ShouldTrample = Random.RandBool(0.66);
	}
	// For FallHeight > 1.5625 we always trample - ShouldTrample remains true

	if (ShouldTrample)
	{
		GetWorld()->DoWithChunkAt(
			AbsPos,
			[&](cChunk & Chunk)
			{
				cBlockFarmlandHandler::TurnToDirt(Chunk, AbsPos);
				return true;
			}
		);
	}
}





void cPawn::OnRemoveFromWorld(cWorld & a_World)
{
	StopEveryoneFromTargetingMe();
	Super::OnRemoveFromWorld(a_World);
}





void cPawn::StopEveryoneFromTargetingMe()
{
	std::vector<cMonster *>::iterator i = m_TargetingMe.begin();
	while (i != m_TargetingMe.end())
	{
		cMonster * Monster = *i;
		ASSERT(Monster->GetTarget() == this);
		Monster->UnsafeUnsetTarget();
		i = m_TargetingMe.erase(i);
	}
	ASSERT(m_TargetingMe.size() == 0);
}





std::map<cEntityEffect::eType, cEntityEffect *> cPawn::GetEntityEffects() const
{
	std::map<cEntityEffect::eType, cEntityEffect *> Effects;
	for (auto & Effect : m_EntityEffects)
	{
		Effects.insert({Effect.first, Effect.second.get()});
	}
	return Effects;
}





cEntityEffect * cPawn::GetEntityEffect(cEntityEffect::eType a_EffectType) const
{
	auto itr = m_EntityEffects.find(a_EffectType);
	return (itr != m_EntityEffects.end()) ? itr->second.get() : nullptr;
}





void cPawn::ResetPosition(Vector3d a_NewPosition)
{
	Super::ResetPosition(a_NewPosition);
	m_LastGroundHeight = GetPosY();
}





bool cPawn::DeductTotem(const eDamageType a_DamageType)
{
	if ((a_DamageType == dtAdmin) || (a_DamageType == dtInVoid))
	{
		// Beyond saving:
		return false;
	}

	if (!IsPlayer())
	{
		// TODO: implement when mobs will be able to pick up items based on CanPickUpLoot attribute:
		return false;
	}

	// If the player is holding a totem of undying in their off-hand or
	// main-hand slot and receives otherwise fatal damage, the totem saves the player from death.

	auto & inv = static_cast<cPlayer *>(this)->GetInventory();
	if (inv.GetEquippedItem().m_ItemType == E_ITEM_TOTEM_OF_UNDYING)
	{
		inv.SetEquippedItem({});
		return true;
	}
	if (inv.GetShieldSlot().m_ItemType == E_ITEM_TOTEM_OF_UNDYING)
	{
		inv.SetShieldSlot({});
		return true;
	}
	return false;
}





bool cPawn::FindTeleportDestination(
	cWorld & a_World,
	const int a_HeightRequired,
	const unsigned int a_NumTries,
	Vector3d & a_Destination,
	const Vector3i a_MinBoxCorner,
	const Vector3i a_MaxBoxCorner
)
{
	/*
	Algorithm:
	Choose random destination.
	Seek downwards, regardless of distance until the block is made of movement-blocking material:
	https://minecraft.wiki/w/Materials Succeeds if no liquid or solid blocks prevents from standing at destination.
	*/
	auto & Random = GetRandomProvider();

	for (unsigned int i = 0; i < a_NumTries; i++)
	{
		const int DestX = Random.RandInt(a_MinBoxCorner.x, a_MaxBoxCorner.x);
		int DestY = Random.RandInt(a_MinBoxCorner.y, a_MaxBoxCorner.y);
		const int DestZ = Random.RandInt(a_MinBoxCorner.z, a_MaxBoxCorner.z);

		// Seek downwards from initial destination until we find a solid block or go into the void
		BLOCKTYPE DestBlock = a_World.GetBlock({DestX, DestY, DestZ});
		while ((DestY >= 0) && !cBlockInfo::IsSolid(DestBlock))
		{
			DestBlock = a_World.GetBlock({DestX, DestY, DestZ});
			DestY--;
		}

		// Couldn't find a solid block so move to next attempt
		if (DestY < 0)
		{
			continue;
		}

		// Succeed if blocks above destination are empty
		bool Success = true;
		for (int j = 1; j <= a_HeightRequired; j++)
		{
			BLOCKTYPE TestBlock = a_World.GetBlock({DestX, DestY + j, DestZ});
			if (cBlockInfo::IsSolid(TestBlock) || IsBlockLiquid(TestBlock))
			{
				Success = false;
				break;
			}
		}

		if (!Success)
		{
			continue;
		}

		// Offsets for entity to be centred and standing on solid block
		a_Destination = Vector3d(DestX + 0.5, DestY + 1, DestZ + 0.5);
		return true;
	}
	return false;
}





bool cPawn::FindTeleportDestination(
	cWorld & a_World,
	const int a_HeightRequired,
	const unsigned int a_NumTries,
	Vector3d & a_Destination,
	const cBoundingBox a_BoundingBox
)
{
	return FindTeleportDestination(
		a_World,
		a_HeightRequired,
		a_NumTries,
		a_Destination,
		a_BoundingBox.GetMin(),
		a_BoundingBox.GetMax()
	);
}





bool cPawn::FindTeleportDestination(
	cWorld & a_World,
	const int a_HeightRequired,
	const unsigned int a_NumTries,
	Vector3d & a_Destination,
	Vector3i a_Centre,
	const int a_HalfCubeWidth
)
{
	Vector3i MinCorner(a_Centre.x - a_HalfCubeWidth, a_Centre.y - a_HalfCubeWidth, a_Centre.z - a_HalfCubeWidth);
	Vector3i MaxCorner(a_Centre.x + a_HalfCubeWidth, a_Centre.y + a_HalfCubeWidth, a_Centre.z + a_HalfCubeWidth);
	return FindTeleportDestination(a_World, a_HeightRequired, a_NumTries, a_Destination, MinCorner, MaxCorner);
}