Scripting API

Scripting API

Physics3DSettings

Struct in Abyss.Physics3D, from Abyss.Physics3D.

Physics 3D's settings, a page of Project Settings: the pull on every body, how many times Jolt works each step out, what queries find, and which layers' bodies meet which. Kept in settings/physics-3d.json, which a built game's pack carries; a game reads them with Res<Physics3DSettings>, and may change them for the run.

public struct Physics3DSettings

Fields

Gravity

public Vector3 Gravity

The pull on every body, in meters a second squared, a world unit being a meter: down, as the Earth's.

VelocitySteps

public int VelocitySteps

How many times Jolt works out each step's velocities: more holds stacks and joints steadier, and is slower.

PositionSteps

public int PositionSteps

How many times Jolt works out how far apart what overlaps is pushed each step.

AllowedPenetration

public float AllowedPenetration

How far bodies may sink into each other, in meters, before they are pushed apart: what rests on the ground is that far into it. Less looks truer, and steadies a stack less readily.

DefaultMaterial

public AssetRef<PhysicsMaterial3D> DefaultMaterial

What a collider is made of where it names no material of its own; none for Physics Material 3D's own.

QueriesHitTriggers

public bool QueriesHitTriggers

Whether a ray, a swept shape or an overlap asked of Physics3D finds triggers as it finds solid colliders; off, it passes through them.

QueriesStartInColliders

public bool QueriesStartInColliders

Whether a ray or a swept shape that starts inside a collider hits it there, at no distance; off, it passes over it to what is beyond, so a ray down from a body's middle finds what is under it.

Collisions

public LayerMatrix Collisions

Which layers' bodies meet which; those that do not pass through each other.