Package org.bukkit.util

Class RayTraceResult

java.lang.Object

org.bukkit.util.RayTraceResult

public class RayTraceResult
extends Object

The hit result of a ray trace.

Only the hit position is guaranteed to always be available. The availability of the other attributes depends on what got hit and on the context in which the ray trace was performed.

Constructor Summary

Constructors

Constructor	Description
RayTraceResult(Vector hitPosition)	Creates a RayTraceResult.
RayTraceResult(Vector hitPosition, BlockFace hitBlockFace)	Creates a RayTraceResult.
RayTraceResult(Vector hitPosition, Block hitBlock, BlockFace hitBlockFace)	Creates a RayTraceResult.
RayTraceResult(Vector hitPosition, Entity hitEntity)	Creates a RayTraceResult.
RayTraceResult(Vector hitPosition, Entity hitEntity, BlockFace hitBlockFace)	Creates a RayTraceResult.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
Block	getHitBlock()	Gets the hit block.
BlockFace	getHitBlockFace()	Gets the hit block face.
Entity	getHitEntity()	Gets the hit entity.
Vector	getHitPosition()	Gets the exact position of the hit.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

RayTraceResult

public RayTraceResult(@NotNull Vector hitPosition)

Creates a RayTraceResult.

Parameters:

hitPosition - the hit position

RayTraceResult

public RayTraceResult(@NotNull Vector hitPosition, @Nullable BlockFace hitBlockFace)

Creates a RayTraceResult.

Parameters:

hitPosition - the hit position

hitBlockFace - the hit block face

RayTraceResult

public RayTraceResult(@NotNull Vector hitPosition, @Nullable Block hitBlock, @Nullable BlockFace hitBlockFace)

Creates a RayTraceResult.

Parameters:

hitPosition - the hit position

hitBlock - the hit block

hitBlockFace - the hit block face

RayTraceResult

public RayTraceResult(@NotNull Vector hitPosition, @Nullable Entity hitEntity)

Creates a RayTraceResult.

Parameters:

hitPosition - the hit position

hitEntity - the hit entity

RayTraceResult

public RayTraceResult(@NotNull Vector hitPosition, @Nullable Entity hitEntity, @Nullable BlockFace hitBlockFace)

Creates a RayTraceResult.

Parameters:

hitPosition - the hit position

hitEntity - the hit entity

hitBlockFace - the hit block face

Method Details

getHitPosition

@NotNull public Vector getHitPosition()

Gets the exact position of the hit.

Returns:

a copy of the exact hit position

getHitBlock

@Nullable public Block getHitBlock()

Gets the hit block.

Returns:

the hit block, or null if not available

getHitBlockFace

@Nullable public BlockFace getHitBlockFace()

Gets the hit block face.

Returns:

the hit block face, or null if not available

getHitEntity

@Nullable public Entity getHitEntity()

Gets the hit entity.

Returns:

the hit entity, or null if not available

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object