Version: 2022.3
LanguageEnglish
  • C#

Physics

class in UnityEngine

/

Implemented in:UnityEngine.PhysicsModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Global physics properties and helper methods.

Static Properties

AllLayersLayer mask constant to select all layers.
autoSyncTransformsWhether or not to automatically sync transform changes with the physics system whenever a Transform component changes.
bounceThresholdTwo colliding objects with a relative velocity below this will not bounce (default 2). Must be positive.
clothGravityCloth Gravity setting. Set gravity for all cloth components.
defaultContactOffsetThe default contact offset of the newly created colliders.
defaultMaxAngularSpeedDefault maximum angular speed of the dynamic Rigidbody, in radians (default 50).
defaultMaxDepenetrationVelocityThe maximum default velocity needed to move a Rigidbody's collider out of another collider's surface penetration. Must be positive.
defaultPhysicsSceneThe PhysicsScene automatically created when Unity starts.
DefaultRaycastLayersLayer mask constant to select default raycast layers.
defaultSolverIterationsThe defaultSolverIterations determines how accurately Rigidbody joints and collision contacts are resolved. (default 6). Must be positive.
defaultSolverVelocityIterationsThe defaultSolverVelocityIterations affects how accurately the Rigidbody joints and collision contacts are resolved. (default 1). Must be positive.
gravityThe gravity applied to all rigid bodies in the Scene.
IgnoreRaycastLayerLayer mask constant to select ignore raycast layer.
improvedPatchFrictionEnables an improved patch friction mode that guarantees static and dynamic friction do not exceed analytical results.
interCollisionDistanceSets the minimum separation distance for cloth inter-collision.
interCollisionStiffnessSets the cloth inter-collision stiffness.
invokeCollisionCallbacksWhether or not MonoBehaviour collision messages will be sent by the physics system.
queriesHitBackfacesWhether physics queries should hit back-face triangles.
queriesHitTriggersSpecifies whether queries (raycasts, spherecasts, overlap tests, etc.) hit Triggers by default.
reuseCollisionCallbacksDetermines whether the garbage collector should reuse only a single instance of a Collision type for all collision callbacks.
simulationModeControls when Unity executes the physics simulation.
sleepThresholdThe mass-normalized energy threshold, below which objects start going to sleep.

Static Methods

BakeMeshPrepares the mesh for use with a MeshCollider and uses default cooking options.
BoxCastCasts the box along a ray and returns detailed information on what was hit.
BoxCastAllLike Physics.BoxCast, but returns all hits.
BoxCastNonAllocCast the box along the direction, and store hits in the provided buffer.
CapsuleCastCasts a capsule against all colliders in the Scene and returns detailed information on what was hit.
CapsuleCastAllLike Physics.CapsuleCast, but this function will return all hits the capsule sweep intersects.
CapsuleCastNonAllocCasts a capsule against all colliders in the Scene and returns detailed information on what was hit into the buffer.
CheckBoxCheck whether the given box overlaps with other colliders or not.
CheckCapsuleChecks if any colliders overlap a capsule-shaped volume in world space.
CheckSphereReturns true if there are any colliders overlapping the sphere defined by position and radius in world coordinates.
ClosestPointReturns a point on the given collider that is closest to the specified location.
ComputePenetrationCompute the minimal translation required to separate the given colliders apart at specified poses.
GetIgnoreCollisionChecks whether the collision detection system will ignore all collisions/triggers between collider1 and collider2 or not.
GetIgnoreLayerCollisionAre collisions between layer1 and layer2 being ignored?
IgnoreCollisionMakes the collision detection system ignore all collisions between collider1 and collider2.
IgnoreLayerCollisionMakes the collision detection system ignore all collisions between any collider in layer1 and any collider in layer2.Note that IgnoreLayerCollision will reset the trigger state of affected colliders, so you might receive OnTriggerExit and OnTriggerEnter messages in response to calling this.
LinecastReturns true if there is any collider intersecting the line between start and end.
OverlapBoxFind all colliders touching or inside of the given box.
OverlapBoxNonAllocFind all colliders touching or inside of the given box, and store them into the buffer.
OverlapCapsuleCheck the given capsule against the physics world and return all overlapping colliders.
OverlapCapsuleNonAllocCheck the given capsule against the physics world and return all overlapping colliders in the user-provided buffer.
OverlapSphereComputes and stores colliders touching or inside the sphere.
OverlapSphereNonAllocComputes and stores colliders touching or inside the sphere into the provided buffer.
RaycastCasts a ray, from point origin, in direction direction, of length maxDistance, against all colliders in the Scene.
RaycastAllCasts a ray through the Scene and returns all hits. Note that order of the results is undefined.
RaycastNonAllocCast a ray through the Scene and store the hits into the buffer.
RebuildBroadphaseRegionsRebuild the broadphase interest regions as well as set the world boundaries.
SimulateSimulate physics in the Scene.
SphereCastCasts a sphere along a ray and returns detailed information on what was hit.
SphereCastAllLike Physics.SphereCast, but this function will return all hits the sphere sweep intersects.
SphereCastNonAllocCast sphere along the direction and store the results into buffer.
SyncTransformsApply Transform changes to the physics engine.

Events

ContactEventSubscribe to this event to read all collisions that occurred during the physics simulation step.
ContactModifyEventSubscribe to this event to be able to customize the collision response for contact pairs.
ContactModifyEventCCDSubscribe to this event to be able to customize the collision response of CCD generated contact pairs.