s&box

crop_din Fields 1

PhysicsTraceBuilder

functions Methods 30

Body (body, to)

Casts a PhysicsBody from its current position and rotation to desired end point.

Box (extents, from, to)

Casts a box from point A to point B.

Capsule (capsule)

Casts a capsule

Cone (height, baseRadius)

Casts a cone (base at bottom, apex at top).

Cylinder (height, radius)

Casts a cylinder

FromTo (from, to)

Sets the start and end positions of the trace request

HitTriggersOnly ()

Hit Only Triggers

IgnoreDynamic ()

Do not hit dynamic objects

IgnoreGameObject (obj)

Do not hit this object

IgnoreGameObjectHierarchy (obj)

Do not hit this object

IgnoreKeyframed ()

Do not hit keyframed objects

IgnoreStatic ()

Do not hit static objects

Radius (radius)

Makes this trace a sphere of given radius.

Casts a ray from point A to point B.

Rotated (rotation)

Makes this a rotated trace, for tracing rotated boxes and capsules.

SceneTraceResult

Run the trace and return the result. The result will return the first hit.

Run the trace and record everything we hit along the way. The result will be an array of hits.

Makes this trace an axis aligned box of given size. Extracts mins and maxs from the Bounding Box.

Sphere (radius, from, to)

Casts a sphere from point A to point B.

Sweep (body, from, to)

Sweeps each PhysicsShape of given PhysicsBody and returns the closest collision. Does not support Mesh PhysicsShapes. Basically 'hull traces' but with physics shapes. Same as tracing a body but allows rotation to change during the sweep.

UseHitboxes (hit)

Should we hit hitboxes

UseHitPosition (enabled)

Should we compute hit position.

UsePhysicsWorld (hit)

Should we hit physics objects?

UseRenderMeshes (hit)

Should we hit meshes too? This can be slow and only works for the editor.

WithAllTags (tags)

Only return entities with all of these tags

WithAnyTags (tags)

Only return entities with any of these tags

WithCollisionRules (tag, asTrigger)

Use the collision rules of an object with the given tags.

WithoutTags (tags)

Only return entities without any of these tags

Only return entities with this tag. Subsequent calls to this will add multiple requirements and they'll all have to be met (ie, the entity will need all tags).

arrow_back_ios 1 arrow_forward_ios

Sophie

Member

JoinedSep 2022 Posts69 Score4,288

Traces are imaginary lines. When you run a Trace you get a TraceResult - which tells you what the line hit.

So for example, if you, as the player, wanted to spawn a box. You'd run a Trace from the player's eyeball to 200 units in the direction that the player is looking. The TraceResult would show that it hit a point and now you know where to place the box.

Sыr

Member

JoinedMar 2026 Posts4 Score205

private void ShootRayFromEyesAndInteract(

PlayerController playerController,

float InteractDistance

)

{

var ray = playerController.EyeTransform.ForwardRay;

var trace = Scene

.Trace.Ray(in ray, InteractDistance)

.IgnoreGameObjectHierarchy(playerController.GameObject)

.Run();

if (!trace.Hit)

return;

IIntractable component = trace.GameObject.GetComponent<IIntractable>();

if (component == null)

return;

component.DoAction();

}

arrow_back_ios 1 arrow_forward_ios

people

Log in to reply

You can't reply if you're not logged in. That would be crazy.