🔦 Raycast#

#bs.raycast:help

Cast rays and see if they collide with blocks or entities.

Note

Unlike traditional raycasts, this module uses a voxel traversal algorithm which is a lot more precise. Also, thanks to the bs.hitbox module, it supports all of the different hitboxes, including both blocks & entities.

“Reality only reveals itself when it is illuminated by a ray of poetry.”

—Georges Braque

🔧 Functions#

You can find below all functions available in this module.

Run the raycast#

#bs.raycast:run

Cast a ray from the execution position and check if it hits something.

Inputs:

Execution at <entity> or positioned <x> <y> <z> rotated <rot>: Origin of the ray.

Storage bs:in raycast:

`max_distance` [number]	Maximum ray travel distance (default: 16.0).
`block_collision` [bool]	Whether the ray should collide with blocks (default: true).
`entity_collision` [bool]	Whether the ray should collide with entities (default: false).
`ignored_blocks` [string]	Blocks to ignore (default: `#bs.hitbox:intangible`).
`solid_entities` [string]	Tag for entities to include (default: `bs.raycast.is_solid`).

Outputs:

Return: Whether the ray collides with a hitbox or not (1 or 0).

Storage bs:out raycast:

`distance` [double]	The distance from the ray’s origin to the impact point.
`hit_point` [array]	The coordintates of the impact point.
`hit_normal` [array]	The normal of the surface the ray hit.
`targeted_block` [array]	The coordinates of the block that was hit.
`targeted_entity` [array]	The UUID array of the entity that was hit.

Cast a ray from your eyes and see, if it stopped, where it stopped:

# Once (return 0 if no collision occured)
execute anchored eyes positioned ^ ^ ^ run function #bs.raycast:run

# If a collision occured, see the collision point
data get storage bs:out raycast.hit_point

Credits: Aksiome

💬 Did it help you?

Feel free to leave your questions and feedbacks below!