> For the complete documentation index, see [llms.txt](https://vc-docs.gitbook.io/engine/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vc-docs.gitbook.io/engine/home/doxygen_synced/classes/class_physics.md).
# Physics
**Usage:** `api.Physics.Raycast(origin, dir, 10)`
Raycast/overlap helpers. The last single-hit result is stored in [hit](/engine/home/doxygen_synced/classes/class_physics.md) because JS cannot consume C# out-parameters directly.
## Public Functions
| | Name |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| bool | Raycast(UnityEngine.Vector3 origin, UnityEngine.Vector3 direction, float maxDistance)
Casts a ray; the hit result is stored in hit.
|
| bool | Raycast(UnityEngine.Vector3 origin, UnityEngine.Vector3 direction, float maxDistance, int layermask)
Casts a ray filtered by layer mask; the hit result is stored in hit.
|
| RaycastHit\[] | RayCastAll(UnityEngine.Vector3 origin, UnityEngine.Vector3 direction, float maxDistance)
Returns all hits along the ray.
|
| UnityEngine.Collider\[] | OverlapSphere(UnityEngine.Vector3 origin, float radius)
Returns all colliders overlapping a sphere.
|
## Public Attributes
| | Name |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| RaycastHit | hit
Holds the hit info from the most recent single Raycast call.
|
## Public Functions Documentation
### function Raycast
```csharp
static bool Raycast(
UnityEngine.Vector3 origin,
UnityEngine.Vector3 direction,
float maxDistance
)
```
Casts a ray; the hit result is stored in [hit](/engine/home/doxygen_synced/classes/class_physics.md).
**Parameters**:
* **origin** Ray origin.
* **direction** Ray direction.
* **maxDistance** Maximum distance.
**Return**: True if something was hit.
### function Raycast
```csharp
static bool Raycast(
UnityEngine.Vector3 origin,
UnityEngine.Vector3 direction,
float maxDistance,
int layermask
)
```
Casts a ray filtered by layer mask; the hit result is stored in [hit](/engine/home/doxygen_synced/classes/class_physics.md).
**Parameters**:
* **origin** Ray origin.
* **direction** Ray direction.
* **maxDistance** Maximum distance.
* **layermask** Layer mask to filter against.
**Return**: True if something was hit.
### function RayCastAll
```csharp
static RaycastHit[] RayCastAll(
UnityEngine.Vector3 origin,
UnityEngine.Vector3 direction,
float maxDistance
)
```
Returns all hits along the ray.
**Parameters**:
* **origin** Ray origin.
* **direction** Ray direction.
* **maxDistance** Maximum distance.
**Return**: All raycast hits.
### function OverlapSphere
```csharp
static UnityEngine.Collider[] OverlapSphere(
UnityEngine.Vector3 origin,
float radius
)
```
Returns all colliders overlapping a sphere.
**Parameters**:
* **origin** Sphere center.
* **radius** Sphere radius.
**Return**: Overlapping colliders.
## Public Attributes Documentation
### variable hit
```csharp
static RaycastHit hit;
```
Holds the hit info from the most recent single Raycast call.
***
Updated on 2026-07-22 at 12:00:00 +0800