raycast functions

[bicatcho11]

Describe Pull request

This code provides utility functions for game development in a 3D environment using Lua scripting. Here's a brief explanation:

GetForwardVector:
    This function calculates the forward vector based on the given rotation. It converts rotation angles to radians and computes the vector using trigonometric functions.

RayCast:
    This function performs a swept sphere raycast in the game world. It utilizes the StartShapeTestSweptSphere function with the provided origin, target, options, ignoreEntity, and radius parameters.

GetEntityPlayerIsLookingAt:

    This function determines the entity that the player is looking at within a specified distance. It calculates the forward vector of the player's camera and casts a ray in that direction. If a collision occurs, it retrieves information about the hit entity.

    The IsInVehicle condition adjusts the casting distance based on whether the player is in a vehicle or not.

    The results include the target entity, its type, and the coordinates of the hit point. The function also exports these functionalities, making them accessible from other parts of the game code.

These functions can be useful for game mechanics like targeting, interaction, or any feature where determining the player's line of sight and the entities in that direction is essential. The exported functions (GetForwardVector, RayCast, and GetEntityPlayerIsLookingAt) can be called from other scripts or game systems. If your PR is to fix an issue mention that issue here

Questions (please complete the following information):

• Have you personally loaded this code into an updated qbcore project and checked all it's functionality? [yes] (Be honest)
• Does your code fit the style guidelines? [yes]
• Does your PR fit the contribution guidelines? [yes]

[github-actions[bot]]

This PR has had 60 days of inactivity & will close within 7 days