feat: Add raycasting from players perspective.

EXILED/Exiled.API/Features/Player.cs

@@ -3973,6 +3973,50 @@ public bool TryGetComponent<T>(Type type, out T component)
             return component is not null;
         }
 
+        /// <summary>
+        /// Gets the raycast hit information from player.
+        /// </summary>
+        /// <param name="maxDistance">The max distance the raycast can reach.</param>
+        /// <param name="layerMask">Layers that are included in the raycast.</param>
+        /// <returns><see cref="RaycastHit"/> if any.</returns>
+        public RaycastHit? GetRaycast(float maxDistance, LayerMasks layerMask)
+            => GetRaycast(maxDistance, (int)layerMask);
+
+        /// <summary>
+        /// Gets the raycast hit information from player.
+        /// </summary>
+        /// <param name="maxDistance">The max distance the raycast can reach.</param>
+        /// <param name="layerMask">Layers that are included in the raycast.</param>
+        /// <returns><see cref="RaycastHit"/> if any.</returns>
+        public RaycastHit? GetRaycast(float maxDistance, int layerMask)
+        {
+            if (!Physics.Raycast(CameraTransform.position, CameraTransform.forward, out RaycastHit raycastHit, maxDistance, layerMask))
+            {
+                // The raycast was out of bounds.
+                return null;
+            }
+
+            return raycastHit;
+        }
+
+        /// <summary>
+        /// Gets the player hitbox currently looking at if any.
+        /// </summary>
+        /// <param name="maxDistance">The max distance the raycast can reach.</param>
+        /// <returns><see cref="HitboxIdentity"/> if any.</returns>
+        public HitboxIdentity GetRaycastedHitbox(float maxDistance)
+        {
+            return GetRaycast(maxDistance, LayerMasks.Hitbox)?.collider.gameObject.GetComponent<HitboxIdentity>();
+        }
+
+        /// <summary>
+        /// Gets the player currently looking at if any.
+        /// </summary>
+        /// <param name="maxDistance">The max distance the raycast can reach.</param>
+        /// <returns><see cref="Player"/> if any.</returns>
+        public Player GetRaycastedPlayer(float maxDistance) =>
+             Get(GetRaycast(maxDistance, LayerMasks.Hitbox)?.collider);
+
         /// <inheritdoc/>
         public bool HasComponent<T>(bool depthInheritance = false) => depthInheritance
             ? componentsInChildren.Any(comp => typeof(T).IsSubclassOf(comp.GetType()))