🎯 Raycast

What is it?

Raycast() allows you to cast a ray between two points in the world to detect collisions with solid objects. It is useful for enemy vision, shooting, sensors, or physical interactions.

📖 Syntax

Raycast(x1, y1, x2, y2, maxDistance, debugDraw, ignoreObject)

📍 Parameters

• x1, y1: origin point (world coordinates).
• x2, y2: destination point (world coordinates).
• maxDistance: maximum ray distance (optional, infinite by default).
• debugDraw: if true, the ray is visually drawn in the scene (green or red depending on collision).
• ignoreObject: object to ignore (e.g., the one casting the ray).

📦 Returns

A hitInfo object, or null if nothing is hit:

{
  hit: true,
  object: referenceToObject,
  x: 350,
  y: 180,
  distance: 220.5
}

✅ Example

// Cast a ray from an enemy toward the player
const hit = Raycast(enemy.x, enemy.y, player.x, player.y, 800, true, enemy);

if (hit) {
  console.log("Hit:", hit.object.name);
}

📌 Notes