3 files changed, 292 insertions, 93 deletions

diff --git a/src/Entities/Entity.cpp b/src/Entities/Entity.cpp
index bc66305b1..cd97c6766 100644
--- a/src/Entities/Entity.cpp
+++ b/src/Entities/Entity.cpp
@@ -629,11 +629,6 @@ void cEntity::HandlePhysics(float a_Dt, cChunk & a_Chunk)
 			{
 				fallspeed = m_Gravity * a_Dt / 3;  // Fall 3x slower in water.
 			}
-			else if (IsBlockRail(BlockBelow) && IsMinecart())  // Rails aren't solid, except for Minecarts
-			{
-				fallspeed = 0;
-				m_bOnGround = true;
-			}
 			else if (BlockIn == E_BLOCK_COBWEB)
 			{
 				NextSpeed.y *= 0.05;  // Reduce overall falling speed
@@ -648,41 +643,18 @@ void cEntity::HandlePhysics(float a_Dt, cChunk & a_Chunk)
 		}
 		else
 		{
-			if (IsMinecart())
+			// Friction
+			if (NextSpeed.SqrLength() > 0.0004f)
 			{
-				if (!IsBlockRail(BlockBelow))
+				NextSpeed.x *= 0.7f / (1 + a_Dt);
+				if (fabs(NextSpeed.x) < 0.05)
 				{
-					// Friction if minecart is off track, otherwise, Minecart.cpp handles this
-					if (NextSpeed.SqrLength() > 0.0004f)
-					{
-						NextSpeed.x *= 0.7f / (1 + a_Dt);
-						if (fabs(NextSpeed.x) < 0.05)
-						{
-							NextSpeed.x = 0;
-						}
-						NextSpeed.z *= 0.7f / (1 + a_Dt);
-						if (fabs(NextSpeed.z) < 0.05)
-						{
-							NextSpeed.z = 0;
-						}
-					}
+					NextSpeed.x = 0;
 				}
-			}
-			else
-			{
-				// Friction for non-minecarts
-				if (NextSpeed.SqrLength() > 0.0004f)
+				NextSpeed.z *= 0.7f / (1 + a_Dt);
+				if (fabs(NextSpeed.z) < 0.05)
 				{
-					NextSpeed.x *= 0.7f / (1 + a_Dt);
-					if (fabs(NextSpeed.x) < 0.05)
-					{
-						NextSpeed.x = 0;
-					}
-					NextSpeed.z *= 0.7f / (1 + a_Dt);
-					if (fabs(NextSpeed.z) < 0.05)
-					{
-						NextSpeed.z = 0;
-					}
+					NextSpeed.z = 0;
 				}
 			}
 		}
diff --git a/src/Entities/Minecart.cpp b/src/Entities/Minecart.cpp
index 710e033f0..be95b2128 100644
--- a/src/Entities/Minecart.cpp
+++ b/src/Entities/Minecart.cpp
@@ -2,6 +2,7 @@
 // Minecart.cpp
 
 // Implements the cMinecart class representing a minecart in the world
+// Handles physics when a minecart is on any type of rail (overrides simulator in Entity.cpp)
 // Indiana Jones!
 
 #include "Globals.h"
@@ -10,6 +11,7 @@
 #include "../ClientHandle.h"
 #include "../Chunk.h"
 #include "Player.h"
+#include "../BoundingBox.h"
 
 #define MAX_SPEED 8
 #define MAX_SPEED_NEGATIVE -MAX_SPEED
@@ -21,11 +23,15 @@
 cMinecart::cMinecart(ePayload a_Payload, double a_X, double a_Y, double a_Z) :
 	super(etMinecart, a_X, a_Y, a_Z, 0.98, 0.7),
 	m_Payload(a_Payload),
-	m_LastDamage(0)
+	m_LastDamage(0),
+	m_DetectorRailPosition(0, 0, 0),
+	m_bIsOnDetectorRail(false)
 {
 	SetMass(20.f);
 	SetMaxHealth(6);
 	SetHealth(6);
+	SetWidth(1.2);
+	SetHeight(0.9);
 }
 
 
@@ -56,6 +62,11 @@ void cMinecart::SpawnOn(cClientHandle & a_ClientHandle)
 
 void cMinecart::HandlePhysics(float a_Dt, cChunk & a_Chunk)
 {
+	if (IsDestroyed()) // Mainly to stop detector rails triggering again after minecart is dead
+	{
+		return;
+	}
+
 	int PosY = (int)floor(GetPosY());
 	if ((PosY <= 0) || (PosY >= cChunkDef::Height))
 	{
@@ -80,31 +91,45 @@ void cMinecart::HandlePhysics(float a_Dt, cChunk & a_Chunk)
 
 	if (!IsBlockRail(InsideType))
 	{
-		Chunk->GetBlockTypeMeta(RelPosX, PosY + 1, RelPosZ, InsideType, InsideMeta);
-		if (IsBlockRail(InsideType)) AddPosY(1);
+		Chunk->GetBlockTypeMeta(RelPosX, PosY + 1, RelPosZ, InsideType, InsideMeta); // When an descending minecart hits a flat rail, it goes through the ground; check for this
+		if (IsBlockRail(InsideType)) AddPosY(1); // Push cart upwards
 	}
 
 	if (IsBlockRail(InsideType))
 	{
+		bool WasDetectorRail = false;
 		SnapToRail(InsideMeta);
 
 		switch (InsideType)
 		{
-			case E_BLOCK_RAIL: HandleRailPhysics(InsideMeta); break;
-			case E_BLOCK_DETECTOR_RAIL: break;
+			case E_BLOCK_RAIL: HandleRailPhysics(InsideMeta, a_Dt); break;
 			case E_BLOCK_ACTIVATOR_RAIL: break;
 			case E_BLOCK_POWERED_RAIL: HandlePoweredRailPhysics(InsideMeta); break;
+			case E_BLOCK_DETECTOR_RAIL:
+			{
+				HandleDetectorRailPhysics(InsideMeta, a_Dt);
+				WasDetectorRail = true;
+				break;
+			}
 			default: VERIFY(!"Unhandled rail type despite checking if block was rail!"); break;
 		}
 
-		AddPosition(GetSpeed() * (a_Dt / 1000));
+		AddPosition(GetSpeed() * (a_Dt / 1000)); // Commit changes; as we use our own engine when on rails, this needs to be done, whereas it is normally in Entity.cpp
+
+		if (m_bIsOnDetectorRail && !WasDetectorRail)
+		{
+			m_World->SetBlock(m_DetectorRailPosition.x, m_DetectorRailPosition.y, m_DetectorRailPosition.z, E_BLOCK_DETECTOR_RAIL, m_World->GetBlockMeta(m_DetectorRailPosition) & 0x07);
+			m_bIsOnDetectorRail = false;
+		}
 	}
 	else
 	{
+		// Not on rail, default physics
 		SetPosY(floor(GetPosY()) + 0.35); // HandlePhysics overrides this if minecart can fall, else, it is to stop ground clipping minecart bottom when off-rail
 		super::HandlePhysics(a_Dt, *Chunk);
 	}
 	
+	// Broadcast positioning changes to client
 	BroadcastMovementUpdate();
 }
 
@@ -112,7 +137,7 @@ void cMinecart::HandlePhysics(float a_Dt, cChunk & a_Chunk)
 
 
 
-void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta)
+void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta, float a_Dt)
 {
 	/*
 	NOTE: Please bear in mind that taking away from negatives make them even more negative,
@@ -127,6 +152,8 @@ void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta)
 			SetPosY(floor(GetPosY()) + 0.55);
 			SetSpeedY(0); // Don't move vertically as on ground
 			SetSpeedX(0); // Correct diagonal movement from curved rails
+
+			if (TestBlockCollision(a_RailMeta)) return;
 			
 			if (GetSpeedZ() != 0) // Don't do anything if cart is stationary
 			{
@@ -150,6 +177,8 @@ void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta)
 			SetSpeedY(0);
 			SetSpeedZ(0);
 
+			if (TestBlockCollision(a_RailMeta)) return;
+
 			if (GetSpeedX() != 0)
 			{
 				if (GetSpeedX() > 0)
@@ -250,60 +279,94 @@ void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta)
 		case E_META_RAIL_CURVED_ZM_XM: // Ends pointing NORTH and WEST
 		{
 			SetRotation(315); // Set correct rotation server side
-			SetPosY(floor(GetPosY()) + 0.3); // Levitate dat cart
+			SetPosY(floor(GetPosY()) + 0.55); // Levitate dat cart
+
+			if (TestBlockCollision(a_RailMeta)) return;
 
 			if (GetSpeedZ() > 0) // Cart moving south
 			{
-				SetSpeedX(-GetSpeedZ()); // Diagonally move southwest (which will make cart hit a southwest rail)
+				int OldX = (int)floor(GetPosX());
+				AddSpeedX(-GetSpeedZ() + 0.5); // See below
+				AddPosX(-GetSpeedZ() * (a_Dt / 1000)); // Diagonally move southwest (which will make cart hit a southwest rail)
+				// If we are already at southwest rail, set Z speed to zero as we can be moving so fast, MCS doesn't tick fast enough to active the handle for the rail...
+				// ...and so we derail unexpectedly.
+				if (GetPosX() <= OldX - 1) SetSpeedZ(0);
 			}
 			else if (GetSpeedX() > 0) // Cart moving east
 			{
-				SetSpeedZ(-GetSpeedX()); // Diagonally move northeast
+				int OldZ = (int)floor(GetPosZ());
+				AddSpeedZ(-GetSpeedX() + 0.5);
+				AddPosZ(-GetSpeedX() * (a_Dt / 1000)); // Diagonally move northeast
+				if (GetPosZ() <= OldZ - 1) SetSpeedX(0);
 			}
 			break;
 		}
 		case E_META_RAIL_CURVED_ZM_XP: // Curved NORTH EAST
 		{
 			SetRotation(225);
-			SetPosY(floor(GetPosY()) + 0.3);
+			SetPosY(floor(GetPosY()) + 0.55);
+
+			if (TestBlockCollision(a_RailMeta)) return;
 
 			if (GetSpeedZ() > 0)
 			{
-				SetSpeedX(GetSpeedZ());
+				int OldX = (int)floor(GetPosX());
+				AddSpeedX(GetSpeedZ() - 0.5);
+				AddPosX(GetSpeedZ() * (a_Dt / 1000));
+				if (GetPosX() >= OldX + 1) SetSpeedZ(0);
 			}
 			else if (GetSpeedX() < 0)
 			{
-				SetSpeedZ(GetSpeedX());
+				int OldZ = (int)floor(GetPosZ());
+				AddSpeedZ(GetSpeedX() + 0.5);
+				AddPosZ(GetSpeedX() * (a_Dt / 1000));
+				if (GetPosZ() <= OldZ - 1) SetSpeedX(0);
 			}
 			break;
 		}
 		case E_META_RAIL_CURVED_ZP_XM: // Curved SOUTH WEST
 		{
 			SetRotation(135);
-			SetPosY(floor(GetPosY()) + 0.3);
+			SetPosY(floor(GetPosY()) + 0.55);
+
+			if (TestBlockCollision(a_RailMeta)) return;
 
 			if (GetSpeedZ() < 0)
 			{
-				SetSpeedX(GetSpeedZ());
+				int OldX = (int)floor(GetPosX());
+				AddSpeedX(GetSpeedZ() + 0.5);
+				AddPosX(GetSpeedZ() * (a_Dt / 1000));
+				if (GetPosX() <= OldX - 1) SetSpeedZ(0);
 			}
 			else if (GetSpeedX() > 0)
 			{
-				SetSpeedZ(GetSpeedX());
+				int OldZ = (int)floor(GetPosZ());
+				AddSpeedZ(GetSpeedX() - 0.5);
+				AddPosZ(GetSpeedX() * (a_Dt / 1000));
+				if (GetPosZ() >= OldZ + 1) SetSpeedX(0);
 			}
 			break;
 		}
 		case E_META_RAIL_CURVED_ZP_XP: // Curved SOUTH EAST
 		{
 			SetRotation(45);
-			SetPosY(floor(GetPosY()) + 0.3);
+			SetPosY(floor(GetPosY()) + 0.55);
+
+			if (TestBlockCollision(a_RailMeta)) return;
 
 			if (GetSpeedZ() < 0)
 			{
-				SetSpeedX(-GetSpeedZ());
+				int OldX = (int)floor(GetPosX());
+				AddSpeedX(-GetSpeedZ() - 0.5);
+				AddPosX(-GetSpeedZ() * (a_Dt / 1000));
+				if (GetPosX() >= OldX + 1) SetSpeedZ(0);
 			}
 			else if (GetSpeedX() < 0)
 			{
-				SetSpeedZ(-GetSpeedX());
+				int OldZ = (int)floor(GetPosZ());
+				AddSpeedZ(-GetSpeedX() - 0.5);
+				AddPosZ(-GetSpeedX() * (a_Dt / 1000));
+				if (GetPosZ() >= OldZ + 1) SetSpeedX(0);
 			}
 			break;
 		}
@@ -320,52 +383,62 @@ void cMinecart::HandleRailPhysics(NIBBLETYPE a_RailMeta)
 
 void cMinecart::HandlePoweredRailPhysics(NIBBLETYPE a_RailMeta)
 {
+	// Initialise to 'slow down' values
+	int AccelDecelSpeed = -1;
+	int AccelDecelNegSpeed = 1;
+
 	if ((a_RailMeta & 0x8) == 0x8)
 	{
-		switch (a_RailMeta & 0x07)
+		// Rail powered - set variables to 'speed up' values
+		AccelDecelSpeed = 1;
+		AccelDecelNegSpeed = -1;
+	}
+
+	switch (a_RailMeta & 0x07)
+	{
+		case E_META_RAIL_ZM_ZP: // NORTHSOUTH
 		{
-			case E_META_RAIL_ZM_ZP: // NORTHSOUTH
-			{
-				SetRotation(270);
-				SetPosY(floor(GetPosY()) + 0.55);
-				SetSpeedY(0); // Don't move vertically as on ground
-				SetSpeedX(0); // Correct diagonal movement from curved rails
+			SetRotation(270);
+			SetPosY(floor(GetPosY()) + 0.55);
+			SetSpeedY(0);
+			SetSpeedX(0);
+
+			if (TestBlockCollision(a_RailMeta)) return;
 			
-				if (GetSpeedZ() != 0) // Don't do anything if cart is stationary
+			if (GetSpeedZ() != 0)
+			{
+				if (GetSpeedZ() > 0)
 				{
-					if (GetSpeedZ() > 0)
-					{
-						// Going SOUTH, slow down
-						AddSpeedZ(1);
-					}
-					else
-					{
-						// Going NORTH, slow down
-						AddSpeedZ(-1);
-					}
+					AddSpeedZ(AccelDecelNegSpeed);
+				}
+				else
+				{
+					AddSpeedZ(AccelDecelSpeed);
 				}
-				break;
 			}
-			case E_META_RAIL_XM_XP: // EASTWEST
-			{
-				SetRotation(180);
-				SetPosY(floor(GetPosY()) + 0.55);
-				SetSpeedY(0);
-				SetSpeedZ(0);
+			break;
+		}
+		case E_META_RAIL_XM_XP: // EASTWEST
+		{
+			SetRotation(180);
+			SetPosY(floor(GetPosY()) + 0.55);
+			SetSpeedY(0);
+			SetSpeedZ(0);
 
-				if (GetSpeedX() != 0)
+			if (TestBlockCollision(a_RailMeta)) return;
+
+			if (GetSpeedX() != 0)
+			{
+				if (GetSpeedX() > 0)
 				{
-					if (GetSpeedX() > 0)
-					{
-						AddSpeedX(-1);
-					}
-					else
-					{
-						AddSpeedX(1);
-					}
+					AddSpeedX(AccelDecelSpeed);
+				}
+				else
+				{
+					AddSpeedX(AccelDecelNegSpeed);
 				}
-				break;
 			}
+			break;
 		}
 	}
 }
@@ -374,6 +447,20 @@ void cMinecart::HandlePoweredRailPhysics(NIBBLETYPE a_RailMeta)
 
 
 
+void cMinecart::HandleDetectorRailPhysics(NIBBLETYPE a_RailMeta, float a_Dt)
+{
+	m_bIsOnDetectorRail = true;
+	m_DetectorRailPosition = Vector3i((int)floor(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()));
+
+	m_World->SetBlockMeta(m_DetectorRailPosition, a_RailMeta | 0x08);
+
+	HandleRailPhysics(a_RailMeta & 0x07, a_Dt);
+}
+
+
+
+
+
 void cMinecart::SnapToRail(NIBBLETYPE a_RailMeta)
 {
 	switch (a_RailMeta)
@@ -383,7 +470,7 @@ void cMinecart::SnapToRail(NIBBLETYPE a_RailMeta)
 		case E_META_RAIL_XM_XP:
 		{
 			SetSpeedZ(0);
-			SetPosZ(floor(GetPosZ()) + 0.3);
+			SetPosZ(floor(GetPosZ()) + 0.5);
 			break;
 		}
 		case E_META_RAIL_ASCEND_ZM:
@@ -391,7 +478,7 @@ void cMinecart::SnapToRail(NIBBLETYPE a_RailMeta)
 		case E_META_RAIL_ZM_ZP:
 		{
 			SetSpeedX(0);
-			SetPosX(floor(GetPosX()) + 0.3);
+			SetPosX(floor(GetPosX()) + 0.5);
 			break;
 		}
 		default: break;
@@ -402,6 +489,114 @@ void cMinecart::SnapToRail(NIBBLETYPE a_RailMeta)
 
 
 
+bool cMinecart::TestBlockCollision(NIBBLETYPE a_RailMeta)
+{
+	switch (a_RailMeta)
+	{
+		case E_META_RAIL_ZM_ZP:
+		{
+			if (GetSpeedZ() > 0)
+			{
+				BLOCKTYPE Block = m_World->GetBlock((int)floor(GetPosX()), (int)floor(GetPosY()), (int)ceil(GetPosZ()));
+				if (!IsBlockRail(Block) && g_BlockIsSolid[Block])
+				{
+					// We could try to detect a block in front based purely on coordinates, but xoft made a bounding box system - why not use? :P
+					cBoundingBox bbBlock(Vector3d((int)floor(GetPosX()), (int)floor(GetPosY()), (int)ceil(GetPosZ())), 0.5, 1);
+					cBoundingBox bbMinecart(Vector3d(GetPosX(), floor(GetPosY()), GetPosZ()), GetWidth() / 2, GetHeight());
+
+					if (bbBlock.DoesIntersect(bbMinecart))
+					{
+						SetSpeed(0, 0, 0);
+						SetPosZ(floor(GetPosZ()) + 0.4);
+						return true;
+					}
+				}
+			}
+			else
+			{
+				BLOCKTYPE Block = m_World->GetBlock((int)floor(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()) - 1);
+				if (!IsBlockRail(Block) && g_BlockIsSolid[Block])
+				{
+					cBoundingBox bbBlock(Vector3d((int)floor(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()) - 1), 0.5, 1);
+					cBoundingBox bbMinecart(Vector3d(GetPosX(), floor(GetPosY()), GetPosZ() - 1), GetWidth() / 2, GetHeight());
+
+					if (bbBlock.DoesIntersect(bbMinecart))
+					{
+						SetSpeed(0, 0, 0);
+						SetPosZ(floor(GetPosZ()) + 0.65);
+						return true;
+					}
+				}
+			}
+			break;
+		}
+		case E_META_RAIL_XM_XP:
+		{
+			if (GetSpeedX() > 0)
+			{
+				BLOCKTYPE Block = m_World->GetBlock((int)ceil(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()));
+				if (!IsBlockRail(Block) && g_BlockIsSolid[Block])
+				{
+					cBoundingBox bbBlock(Vector3d((int)ceil(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ())), 0.5, 1);
+					cBoundingBox bbMinecart(Vector3d(GetPosX(), floor(GetPosY()), GetPosZ()), GetWidth() / 2, GetHeight());
+
+					if (bbBlock.DoesIntersect(bbMinecart))
+					{
+						SetSpeed(0, 0, 0);
+						SetPosX(floor(GetPosX()) + 0.4);
+						return true;
+					}
+				}
+			}
+			else
+			{
+				BLOCKTYPE Block = m_World->GetBlock((int)floor(GetPosX()) - 1, (int)floor(GetPosY()), (int)floor(GetPosZ()));
+				if (!IsBlockRail(Block) && g_BlockIsSolid[Block])
+				{
+					cBoundingBox bbBlock(Vector3d((int)floor(GetPosX()) - 1, (int)floor(GetPosY()), (int)floor(GetPosZ())), 0.5, 1);
+					cBoundingBox bbMinecart(Vector3d(GetPosX() - 1, floor(GetPosY()), GetPosZ()), GetWidth() / 2, GetHeight());
+
+					if (bbBlock.DoesIntersect(bbMinecart))
+					{
+						SetSpeed(0, 0, 0);
+						SetPosX(floor(GetPosX()) + 0.65);
+						return true;
+					}
+				}
+			}
+			break;
+		}			
+		case E_META_RAIL_CURVED_ZM_XM:
+		case E_META_RAIL_CURVED_ZM_XP:
+		case E_META_RAIL_CURVED_ZP_XM:
+		case E_META_RAIL_CURVED_ZP_XP:
+		{
+			BLOCKTYPE BlockXM = m_World->GetBlock((int)floor(GetPosX()) - 1, (int)floor(GetPosY()), (int)floor(GetPosZ()));
+			BLOCKTYPE BlockXP = m_World->GetBlock((int)floor(GetPosX()) + 1, (int)floor(GetPosY()), (int)floor(GetPosZ()));
+			BLOCKTYPE BlockZM = m_World->GetBlock((int)floor(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()) + 1);
+			BLOCKTYPE BlockZP = m_World->GetBlock((int)floor(GetPosX()), (int)floor(GetPosY()), (int)floor(GetPosZ()) + 1);
+			if (
+				(!IsBlockRail(BlockXM) && g_BlockIsSolid[BlockXM]) ||
+				(!IsBlockRail(BlockXP) && g_BlockIsSolid[BlockXP]) ||
+				(!IsBlockRail(BlockZM) && g_BlockIsSolid[BlockZM]) ||
+				(!IsBlockRail(BlockZP) && g_BlockIsSolid[BlockZP])
+				)
+			{
+				SetSpeed(0, 0, 0);
+				SetPosition((int)floor(GetPosX()) + 0.5, GetPosY(), (int)floor(GetPosZ()) + 0.5);
+				return true;
+			}
+			break;
+		}
+		default: break;
+	}
+	return false;
+}
+
+
+
+
+
 void cMinecart::DoTakeDamage(TakeDamageInfo & TDI)
 {
 	if (TDI.Attacker->IsPlayer() && ((cPlayer *)TDI.Attacker)->IsGameModeCreative())
@@ -464,6 +659,18 @@ void cMinecart::DoTakeDamage(TakeDamageInfo & TDI)
 
 
 
+void cMinecart::Destroyed()
+{
+	if (m_bIsOnDetectorRail)
+	{
+		m_World->SetBlock(m_DetectorRailPosition.x, m_DetectorRailPosition.y, m_DetectorRailPosition.z, E_BLOCK_DETECTOR_RAIL, m_World->GetBlockMeta(m_DetectorRailPosition) & 0x07);
+	}
+}
+
+
+
+
+
 ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
 // cEmptyMinecart:
 
diff --git a/src/Entities/Minecart.h b/src/Entities/Minecart.h
index e353e18d9..feb700b71 100644
--- a/src/Entities/Minecart.h
+++ b/src/Entities/Minecart.h
@@ -51,6 +51,7 @@ public:
 	virtual void SpawnOn(cClientHandle & a_ClientHandle) override;
 	virtual void HandlePhysics(float a_Dt, cChunk & a_Chunk) override;
 	virtual void DoTakeDamage(TakeDamageInfo & TDI) override;
+	virtual void Destroyed() override;
 	
 	int LastDamage(void) const { return m_LastDamage; }
 	ePayload GetPayload(void) const { return m_Payload; }
@@ -58,11 +59,30 @@ public:
 protected:
 	ePayload m_Payload;
 	int m_LastDamage;
+	Vector3i m_DetectorRailPosition;
+	bool m_bIsOnDetectorRail;
 	
 	cMinecart(ePayload a_Payload, double a_X, double a_Y, double a_Z);
-	void HandleRailPhysics(NIBBLETYPE a_RailMeta);
+
+	/** Handles physics on normal rails
+		For each tick, slow down on flat rails, speed up or slow down on ascending/descending rails (depending on direction), and turn on curved rails
+	*/
+	void HandleRailPhysics(NIBBLETYPE a_RailMeta, float a_Dt);
+
+	/** Handles powered rail physics
+		Each tick, speed up or slow down cart, depending on metadata of rail (powered or not)
+	*/
 	void HandlePoweredRailPhysics(NIBBLETYPE a_RailMeta);
+
+	/** Handles detector rail activation
+		Activates detector rails when a minecart is on them. Calls HandleRailPhysics() for physics simulations
+	*/
+	void HandleDetectorRailPhysics(NIBBLETYPE a_RailMeta, float a_Dt);
+
+	/** Snaps a minecart to a rail's axis, resetting its speed */
 	void SnapToRail(NIBBLETYPE a_RailMeta);
+	/** Tests is a solid block is in front of a cart, and stops the cart (and returns true) if so; returns false if no obstruction*/
+	bool TestBlockCollision(NIBBLETYPE a_RailMeta);
 
 } ;