# PhysicsWorld > A world is a container for all other physics objects such as PhysicsBody, PhysicsShape, PhysicsJoint etc. A world can be simulated in isolation from all other worlds. The maximum number of worlds that can be created at one time is defined by _maximumWorlds. A world is completely isolated from all other worlds. ## Definition * **Type:** Struct * **Namespace:** [Unity.U2D.Physics](/engine/6000.5/script-reference/unity/u2d/physics.md) * **Assembly:** UnityEngine.PhysicsCore2DModule * **Implements:** [IEquatable\](https://learn.microsoft.com/dotnet/api/system.iequatable-1) ```csharp public readonly struct PhysicsWorld : IEquatable ``` ## Properties | Property | Description | | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [autoBodyUpdateCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autobodyupdatecallbacks.md) | Controls if body update callback targets are automatically called. See [PhysicsWorld.SendBodyUpdateCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendbodyupdatecallbacks.md) | | [autoContactCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autocontactcallbacks.md) | Controls if shape contact callback targets are automatically called. See [PhysicsWorld.SendContactCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendcontactcallbacks.md) | | [autoJointThresholdCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autojointthresholdcallbacks.md) | Controls if joint threshold callback targets are automatically called. See [PhysicsWorld.SendJointThresholdCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendjointthresholdcallbacks.md) | | [autoTriggerCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autotriggercallbacks.md) | Controls if shape trigger callback targets are automatically called. See [PhysicsWorld.SendTriggerCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendtriggercallbacks.md) | | [awakeBodyCount](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/awakebodycount.md) | Get the number of awake bodies in the world. | | [bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md) | Get the body events from the last simulation. The [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/isvalid.md)). Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.BodyUpdateEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/bodyupdateevent.md). | | [bounceThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bouncethreshold.md) | Adjust the bounce threshold, usually in meters per second. It is recommended not to make this value very small because it will prevent bodies from sleeping. | | [capacity](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/capacity.md) | Get the current world capacities reached since the world was created. This reflects the peak object counts and can be used to presize a [\_capacity](/engine/6000.5/script-reference/unity/u2d/physics/physicsworlddefinition/capacity.md) for similar worlds. Peaks are not capped, so a peak above 65535 is clamped to that maximum when used to presize another world. | | [contactBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactbeginevents.md) | Get the contact begin events from the last simulation. The [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)). The [PhysicsShape.Contact](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contact.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced. Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.ContactBeginEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/contactbeginevent.md). | | [contactDamping](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactdamping.md) | The contact bounciness with 1 being critical damping (non-dimensional). | | [contactEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactendevents.md) | Get the contact end events from the last simulation. The [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)). The [PhysicsShape.Contact](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contact.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced. Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.ContactEndEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/contactendevent.md). | | [contactFilterCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactfiltercallbacks.md) | Controls if contact filter callbacks will be called. A contact filter callback allows direct control over whether a contact will be created between a pair of shapes. This applies to both triggers and non-triggers but only with Dynamic bodies. These are relatively expensive so disabling them can provide a significant performance benefit. A contact filter callback will call the [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md) for both shapes involved if they implement [PhysicsCallbacks.IContactFilterCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/icontactfiltercallback.md). | | [contactFrequency](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactfrequency.md) | The contact stiffness, in cycles per second. | | [contactHitEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contacthitevents.md) | Get the contact hit events from the last simulation. The [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)). Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.ContactHitEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/contacthitevent.md). | | [contactHitEventThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contacthiteventthreshold.md) | The contact hit event threshold controls the collision speed needed to generate a contact hit event, usually in meters per second. See [PhysicsEvents.ContactHitEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/contacthitevent.md). | | [contactRecycleDistance](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactrecycledistance.md) | The contact recycle distance, in meters. Setting this to zero disables contact point recycling. Contact recycling reuses contact points across simulation time-steps when the relative movement is small. This feature improves stability and performance by around 25% (approximately). Contact points are not recalculated until shapes move more than 5cm (default) relative to each other. Contact recycling skips some updates such as friction, pre-solve (etc) until the contacts are no longer recycled. | | [contactSpeed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactspeed.md) | The contact speed used to solve overlaps, in meters per second. | | [continuousAllowed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/continuousallowed.md) | Controls if continuous collision detection will be used between Dynamic and Static bodies. Generally you should keep continuous collision enabled to prevent fast moving objects from going through Static objects. The performance gain from disabling continuous collision is minor. | | [counters](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/counters.md) | Get the world counters. | | [definition](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/definition.md) | Get/Set a world definition by accessing all of its current properties. This is provided as convenience only and should not be used when performance is important as all the properties defined in the definition are accessed sequentially. You should try to only use the specific properties you need rather than using this feature. | | [drawColors](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcolors-1.md) | Controls what colors are used to draw [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md), [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md), [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) etc. | | [drawContactType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcontacttype-1.md) | Controls the [PhysicsWorld.DrawContactType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcontacttype.md) used when drawing contact points. | | [drawFillAlpha](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfillalpha.md) | Controls the draw fill alpha. This is used to scale the interior fill alpha and is only used when [PhysicsWorld.DrawFillOptions.Outline](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfilloptions/outline.md) is used so that the interior color can be distinguished from the outline color by transparency. | | [drawFillOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfilloptions-1.md) | Controls how shape geometry is filled when drawing. See [PhysicsWorld.DrawFillOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfilloptions.md). | | [drawFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfilter.md) | Limits what gets drawn to a narrow selection. This only affects [PhysicsWorld.DrawOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawoptions.md) that are drawing all bodies, shapes etc. It does not affect selected elements or custom drawing. See [PhysicsWorld.IgnoreFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/ignorefilter.md). | | [drawForceScale](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawforcescale.md) | Controls the joint contact force scale used when drawing contact forces. | | [drawNormalScale](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawnormalscale.md) | Controls the joint contact normal scale used when drawing contact normals. | | [drawOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawoptions-1.md) | Limits what gets drawn to a broad selection. See [PhysicsWorld.DrawOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawoptions.md). | | [drawPointScale](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawpointscale.md) | Controls the draw point scale used when drawing points. | | [drawThickness](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawthickness.md) | Controls the draw thickness (outline and orientation). | | [elementDepth](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/elementdepth.md) | Controls the element depth. | | [generation](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/generation.md) | Get the world handle generation. | | [gravity](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/gravity.md) | Get/Set the gravity vector applied to all bodies in the world, usually in m/s^2. | | [index](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/index.md) | Get the world handle index. | | [isDefaultWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isdefaultworld.md) | Check if this is the default [PhysicsWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld.md). The default world is automatically created at start-up. | | [isEmpty](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isempty.md) | Check if the world is empty as defined by having no bodies, shapes or joints. | | [isOwned](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isowned.md) | Get if the world is owned. See [PhysicsWorld.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md). | | [isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isvalid.md) | Check if the world is valid. | | [jointThresholdEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/jointthresholdevents.md) | Get the joint events from the last simulation. An event is produced by a Joint which exceeds either its [\_forceThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/forcethreshold.md) or [\_torqueThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/torquethreshold.md). The [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/isvalid.md)). Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.JointThresholdEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/jointthresholdevent.md). | | [lastSimulationDeltaTime](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lastsimulationdeltatime.md) | Get the delta-time used for the last simulation run. | | [lastSimulationTimestamp](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lastsimulationtimestamp.md) | Get the timestamp when the last simulation was run. | | [maximumLinearSpeed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/maximumlinearspeed.md) | Get/Set the maximum linear speed. | | [ownerUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/owneruserdata.md) | Get [PhysicsUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsuserdata.md) that can be used for any purpose, typically by the owner only. | | [paused](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/paused.md) | Get/Set if the world is paused. When paused, any simulation attempted will be ignored whether it be automatic or manual. | | [preSolveCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/presolvecallbacks.md) | Controls if pre-solve callbacks will be called. This only applies to Dynamic bodies and is ignored for triggers. These are relatively expensive so disabling them can provide a significant performance benefit. A pre-solve callback will call the [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md) for both shapes involved if they implement [PhysicsCallbacks.IPreSolveCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/ipresolvecallback.md). | | [profile](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/profile.md) | Get the world timing profile. | | [simulationSubSteps](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationsubsteps.md) | Get/Set the simulation sub-steps to use during simulation. See [PhysicsWorld.Simulate](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulate.md). | | [simulationType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationtype-1.md) | Get/Set the simulation type which controls when or if the simulation will be automatically simulated. See [PhysicsWorld.SimulationType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationtype.md). | | [simulationWorkers](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationworkers.md) | Get/Set the simulation worker count for the world. A single simulation worker is always used for simulation therefore a worker count of one means single thread simulation only. The actual quantity of workers used will always be capped to those available on the current device and reading the property will return the number of workers actually being used by the device. Changing the worker count continuously is not recommend and will impact performance as it requires the task queue be recreated. See [\_simulationWorkers](/engine/6000.5/script-reference/unity/u2d/physics/physicsworlddefinition/simulationworkers.md). | | [sleepingAllowed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sleepingallowed.md) | Controls if bodies go to sleep when not moving and not interacting. Sleeping can provide a significant performance improvement when many Dynamic or Kinematic bodies are in the world. | | [syncInterpolation](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/syncinterpolation.md) | Controls if an extra write pass prior to the script fixed-update callback is made for any interpolation tweens to ensure that transforms are synchronized to the final body pose. Because this is an extra write pass, it has an impact on overall performance so only enable if you require transforms synchronized this way. | | [transformPlane](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplane-1.md) | Controls the transform plane that the world uses when writing transforms. See \_transformWriteMode. | | [transformPlaneCustom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplanecustom-1.md) | Controls the transformation for the [PhysicsWorld.TransformPlane.Custom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplane/custom.md) to allow transformation writing and reading to/from a custom 2D plane. See [PhysicsWorld.TransformPlaneCustom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplanecustom.md). | | [transformTweenMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformtweenmode-1.md) | Controls if and how Transform tweens are calculated and/or written. Transform tweening is where bodies that have their [\_transformObject](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/transformobject.md) set, write to the [Transform](/engine/6000.5/script-reference/unityengine/transform.md) each frame depending on the specific body [PhysicsBody.TransformWriteMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/transformwritemode.md) set. Regardless of this setting, Transform tweening is never used if the \_simulationType is [PhysicsWorld.SimulationType.Update](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationtype/update.md) or \_transformWriteMode is [PhysicsWorld.TransformWriteMode.Off](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritemode/off.md). | | [transformWriteCallbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritecallbacktarget.md) | Get/Set the custom [Object](/engine/6000.5/script-reference/unityengine/object.md) that implements the [PhysicsCallbacks.ITransformWriteCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/itransformwritecallback.md) to which [PhysicsEvents.TransformWriteEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformwriteevent.md) and [PhysicsEvents.TransformTweenWriteEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformtweenwriteevent.md) will be sent. The callback will only occur if \_transformWriteMode is set to [PhysicsWorld.TransformWriteMode.Custom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritemode/custom.md) and there are [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md) available. The object assigned here will be kept alive, not allowing the GC to dispose of it. To remove the object assigned here, set the callback target to NULL. | | [transformWriteMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritemode-1.md) | Controls how transform writing is handled. Only bodies that have their \_transformWriteMode active and produce a [PhysicsEvents.BodyUpdateEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/bodyupdateevent.md) will write to a transform. See [PhysicsWorld.TransformWriteMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritemode.md). | | [triggerBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerbeginevents.md) | Get the trigger begin events from the last simulation. The [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)). Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.TriggerBeginEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/triggerbeginevent.md). | | [triggerEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerendevents.md) | Get the trigger end events from the last simulation. The [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) objects returned should be checked to see if they are valid before accessing as they may have been deleted since this event was produced (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)). Any change to the world state can invalidate this data so referring to this data afterwards may cause an unavoidable crash! You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. See [PhysicsEvents.TriggerEndEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/triggerendevent.md). | | [userData](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/userdata.md) | Get/Set [PhysicsUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsuserdata.md) that can be used for any purpose. This cannot be set on the [\_defaultWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/defaultworld.md) and will always be at the default. The physics system doesn't use this data, it is entirely for custom use. | | [warmStartingAllowed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/warmstartingallowed.md) | Is warm-starting allowed in the world? Disabling warming-starting will severely impact stability. This is typically used for testing only! | ## Static Properties | Property | Description | | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [aabbMargin](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/aabbmargin.md) | Get the distance used to expand AABBs in the broadphase dynamic tree, in meters. This allows broadphase proxies to move by a small amount without triggering a tree adjustment. This value is 0.05f \* [\_lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lengthunitspermeter.md). Normally this is 5cm. | | [alwaysDrawWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/alwaysdrawworlds.md) | Get if worlds are always drawn independent of whether rendering is currently active or not as specified by \_renderingMode. When true, world drawing is always active and a [PhysicsEvents.WorldDrawResults](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/worlddrawresults.md) event is produced containing the [PhysicsWorld.DrawResults](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawresults.md). When false, world drawing only occurs depending on the \_renderingMode setting. This can be controlled via [\_alwaysDrawWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/alwaysdrawworlds.md). | | [bodyMaxRotation](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodymaxrotation.md) | Get the maximum rotation of a body per time step, in degrees. This limit is very large and is used to prevent numerical problems. This value is approximately 45-degrees or 0.25f \* [PhysicsMath.PI](/engine/6000.5/script-reference/unity/u2d/physics/physicsmath/pi.md) radians. | | [bodyTimeToSleep](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodytimetosleep.md) | Get the time that a body must be still before it will go to sleep, in seconds. This value is 0.5 seconds. | | [concurrentSimulations](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/concurrentsimulations.md) | Gets how many simulations can be started in parallel. | | [contactFilterGroupMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactfiltergroupmode.md) | Get the current value of [\_contactFilterGroupMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/contactfiltergroupmode.md). | | [contactFilterMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactfiltermode.md) | Get the current value of [\_contactFilterMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/contactfiltermode.md). | | [defaultWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/defaultworld.md) | Get the default world created at start-up. This world cannot be destroyed as it is permanently owned by Unity itself. See [PhysicsWorld.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md) and [\_isOwned](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isowned.md). | | [disableSimulation](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/disablesimulation.md) | Get if the automatic simulation of any [PhysicsWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld.md) is temporarily disabled. When true, no automatic simulation will occur. When false, normal operation occurs with automatic simulation. This can be controlled via [\_disableSimulation](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/disablesimulation.md). | | [globalCounters](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/globalcounters.md) | Get the world counters, summed for all the active worlds. | | [globalProfile](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/globalprofile.md) | Get the world timing profile, summed for all the active worlds. | | [hugeWorldExtent](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/hugeworldextent.md) | Gets what physics considers a large extent in the world. Positions greater than approximately 16km will have precision problems, so 100km as a limit should be fine in all cases. This is used to detect bad values. This value is 100000.0f \* [\_lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lengthunitspermeter.md). | | [isRenderingAllowed](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/isrenderingallowed.md) | Get if rendering is currently allowed. Rendering is always allowed in the Editor however it is only allowed elsewhere depending on [\_renderingMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/renderingmode.md). | | [lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lengthunitspermeter.md) | Get the internal length units per meter. Changes won't take effect until exiting play mode. The physics system relates all length units on meters but you may need different units for your project. You can set this value to use different units but it should only be modified before any other calls to the physics system occur and only modified once. Changing this value after any physics object has been created can result in severe simulation instabilities. | | [linearSlop](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/linearslop.md) | Get the small length used as a collision and constraint tolerance, in meters. Usually it is chosen to be numerically significant, but visually insignificant. This value is 0.005f \* [\_lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lengthunitspermeter.md). Normally this is 0.5cm. | | [maximumWorldsAllocated](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/maximumworldsallocated.md) | Get the actual allocated maximum worlds available. This can differ at runtime from [\_maximumWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/maximumworlds.md) if it was changed and the physics system has not been restarted. Another reason this can differ would be if there was not available memory to allocate the requested maximum worlds. | | [renderingMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/renderingmode-1.md) | Get the current value of [\_renderingMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/renderingmode.md). | | [safetyLocksEnabled](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/safetylocksenabled.md) | Get/Set whether safety threading locks are enabled or not. Locks are enabled by default however on platforms that do not support threading, locks are not used. Disabling locks can result in a small performance boost however, please note the following EXTREME CAUTIONS. | | [speculativeContactDistance](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/speculativecontactdistance.md) | Get the distance at which speculative contacts will be calculated. This reduces jitter. This value is 4.0f \* [\_lengthUnitsPerMeter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/lengthunitspermeter.md). Normally this is 2cm. | | [transformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformchangemode-1.md) | Get the current value of [\_transformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/transformchangemode.md). See [PhysicsWorld.TransformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformchangemode.md). | | [usePhysicsLayers](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/usephysicslayers.md) | Get if the option of [\_usePhysicsLayers](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/usephysicslayers.md) is active or not. If no [PhysicsCoreSettings2D](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d.md) asset is assigned, this option will return false (inactive). When active, the physics 64-bit layers are used (see [\_physicsLayerNames](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/physicslayernames.md)) for property drawers and [PhysicsLayers.GetLayerMask](/engine/6000.5/script-reference/unity/u2d/physics/physicslayers/getlayermask.md). When inactive, the 32-bit layers are used (see [LayerMask](/engine/6000.5/script-reference/unityengine/layermask.md)) for property drawers and [PhysicsLayers.GetLayerMask](/engine/6000.5/script-reference/unity/u2d/physics/physicslayers/getlayermask.md). In all cases, the physics system itself will always use the full 64-bit layers assigned, however when using 32-bit layers, the top 32-bits will be set to zero. | | [worldCount](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/worldcount.md) | Get the number of created worlds. This will be a value in the range of 1 to [\_maximumWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/maximumworlds.md). | ## Methods | Method | Description | | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [CastGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castgeometry.md) | Returns the shape(s) that intersect the specified Capsule geometry as it is cast through the world. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldCastMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastmode.md), [PhysicsQuery.WorldCastResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [CastMover](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castmover.md) | Cast a "Mover" which is geometry designed to collide with the world and solve its movement. Everything is specified via the [PhysicsQuery.WorldMoverInput](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldmoverinput.md) with results returned in [PhysicsQuery.WorldMoverResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldmoverresult.md). | | [CastRay](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castray.md) | Returns the shape(s) that intersect the specified Ray. Technically this is a line-segment and not an infinite ray. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldCastMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastmode.md), [PhysicsQuery.WorldCastResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [CastShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castshape.md) | Returns the shape(s) that intersect the specified shape as it is cast through the world. The selected shape is excluded from any results and must be in this world otherwise a warning will be produced. Neither [PhysicsShape.ShapeType.Segment](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/shapetype/segment.md) or [PhysicsShape.ShapeType.ChainSegment](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/shapetype/chainsegment.md) shape types are supported. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldCastMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastmode.md), [PhysicsQuery.WorldCastResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [CastShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castshapeproxy.md) | Returns the shape(s) that intersect the specified Circle geometry as it is cast through the world. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldCastMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastmode.md), [PhysicsQuery.WorldCastResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldcastresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [ClearDraw](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/cleardraw.md) | Clear all the custom drawn items. | | [CreateBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/createbody.md) | Create a body using the [\_defaultDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsbodydefinition/defaultdefinition.md) in the world. See [PhysicsBody.Create](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/create.md). | | [CreateBodyBatch](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/createbodybatch.md) | Create a batch of bodies in the world. | | [CreateJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/createjoint.md) | Create a PhysicsDistanceJoint in the world. See [PhysicsDistanceJoint.Create](/engine/6000.5/script-reference/unity/u2d/physics/physicsdistancejoint/create.md). | | [Destroy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/destroy.md) | Destroy a world, destroying all objects contained within it such as all [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) and attached [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) and [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md). If the object is owned with [PhysicsWorld.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md) then you must provide the owner key it returned. Failing to do so will return a warning and the world will not be destroyed. You cannot destroy the [\_defaultWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/defaultworld.md) as it is permanently owned by Unity itself. | | [DrawAABB](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawaabb.md) | Draw an AABB. | | [DrawBox](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawbox.md) | Draw a Box. | | [DrawCapsule](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcapsule.md) | Draw a Capsule outline. For further information on the parameters, see [CapsuleGeometry](/engine/6000.5/script-reference/unity/u2d/physics/capsulegeometry.md). | | [DrawCircle](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcircle.md) | Draw a Circle outline. For further information on the parameters, see [CircleGeometry](/engine/6000.5/script-reference/unity/u2d/physics/circlegeometry.md). | | [DrawGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawgeometry.md) | Draw the specified span of Capsule geometry. | | [DrawLine](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawline.md) | Draw a Line. | | [DrawLineStrip](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawlinestrip.md) | Draw a set of vertices as lines joined to each other. | | [DrawPoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawpoint.md) | Draw a Point. A Point is similar to a filled Circle except the radius here is specified in pixels rather than world units. | | [DrawQueryCastGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawquerycastgeometry.md) | Draw the [PhysicsWorld.CastGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castgeometry.md) query input. | | [DrawQueryCastRay](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawquerycastray.md) | Draw the [PhysicsWorld.CastRay](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castray.md) query inputs. | | [DrawQueryCastShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawquerycastshape.md) | Draw the [PhysicsWorld.CastShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castshape.md) query input. | | [DrawQueryCastShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawquerycastshapeproxy.md) | Draw the [PhysicsWorld.CastShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/castshapeproxy.md) query input. | | [DrawQueryResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawqueryresult.md) | Draw the [PhysicsQuery.CastResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/castresult.md) returned from multiple queries. Only a result where \_hit is true is drawn. | | [DrawShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawshapeproxy.md) | Draw the specified span of [PhysicsShape.ShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/shapeproxy.md). | | [DrawTransformAxis](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawtransformaxis.md) | Draw a Transform axis. | | [Explode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/explode.md) | Apply a radial explosion applying impulses away from the position to all bodies found within in the radius. | | [GetBodies](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getbodies.md) | Get all the active [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) in the specified world. | | [GetBodyUpdateCallbackTargets](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getbodyupdatecallbacktargets.md) | Get all current [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md) where either of the [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/callbacktarget.md)). | | [GetBodyUpdateOwnerUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getbodyupdateowneruserdata.md) | Get all [\_ownerUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/owneruserdata.md) assigned to each [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) returned with [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md). The Native Array returned will be of the same length and be ordered the same as the [PhysicsEvents.BodyUpdateEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/bodyupdateevent.md) returned with [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md). Any [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) that are not valid will return a default [PhysicsUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsuserdata.md). | | [GetBodyUpdateUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getbodyupdateuserdata.md) | Get all [\_userData](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/userdata.md) assigned to each [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) returned with [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md). The Native Array returned will be of the same length and be ordered the same as the [PhysicsEvents.BodyUpdateEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/bodyupdateevent.md) returned with [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md). Any [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) that are not valid will return a default [PhysicsUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsuserdata.md). | | [GetContactCallbackTargets](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getcontactcallbacktargets.md) | Get all current [\_contactBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactbeginevents.md) and [\_contactEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactendevents.md) where either of the [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md)). | | [GetJoints](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getjoints.md) | Get all the active [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) in the specified world. | | [GetJointThresholdCallbackTargets](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getjointthresholdcallbacktargets.md) | Get all current [\_jointThresholdEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/jointthresholdevents.md) where either of the [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/callbacktarget.md)). | | [GetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getowner.md) | Get the owner object associated with this world as specified using [PhysicsWorld.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md). | | [GetTransformWriteTweens](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/gettransformwritetweens.md) | Gets all the existing Transform Write Tweens that are handled per-frame. If the \_transformTweenMode is [PhysicsWorld.TransformTweenMode.Sequential](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformtweenmode/sequential.md) then the tweens are sorted into ascending transform depth allowing writing to the Transform hierarchy by simply iterating the tweens . If the \_transformTweenMode is [PhysicsWorld.TransformTweenMode.Sequential](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformtweenmode/sequential.md) then the tweens are unsorted as a [TransformAccessArray](/engine/6000.5/script-reference/unityengine/jobs/transformaccessarray.md) is used to write them. See [PhysicsBody.TransformWriteTween](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/transformwritetween.md) and [PhysicsBody.TransformWriteMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/transformwritemode.md). | | [GetTriggerCallbackTargets](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/gettriggercallbacktargets.md) | Get all current [\_triggerBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerbeginevents.md) and [\_triggerEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerendevents.md) where either of the [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md)). | | [OverlapAABB](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/overlapaabb.md) | Returns all shapes that potentially overlap the provided AABBs. The overlap is between AABB of shapes in the world therefore it may not result in an exact overlap of the shape itself. See [PhysicsAABB](/engine/6000.5/script-reference/unity/u2d/physics/physicsaabb.md), [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldOverlapResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldoverlapresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [OverlapGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/overlapgeometry.md) | Returns all shapes that overlap the provided Capsule geometry. See [CapsuleGeometry](/engine/6000.5/script-reference/unity/u2d/physics/capsulegeometry.md), [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldOverlapResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldoverlapresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [OverlapPoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/overlappoint.md) | Returns all shapes that overlap the provided point(s). This first converts the shape to a [PhysicsShape.ShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/shapeproxy.md) and uses [PhysicsWorld.TestOverlapShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlapshapeproxy.md). See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md), [PhysicsQuery.WorldOverlapResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldoverlapresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [OverlapShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/overlapshape.md) | Returns all shapes that overlap the provided shape. The selected shape is excluded from any results and must be in this world otherwise a warning will be produced. | | [OverlapShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/overlapshapeproxy.md) | Returns all shapes that overlap the shape proxies. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md). [PhysicsQuery.WorldOverlapResult](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/worldoverlapresult.md) and [Allocator](/engine/6000.5/script-reference/unity/collections/allocator.md). | | [Reset](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/reset.md) | Reset the world to a canonical state so that it will reproduce identical results each time. The world must be empty for this to be called otherwise a warning is produced. | | [SendAllCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendallcallbacks.md) | Send all callbacks to targets: | | [SendBodyUpdateCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendbodyupdatecallbacks.md) | Send all current [\_bodyUpdateEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/bodyupdateevents.md) where the [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/callbacktarget.md)). Only callback targets that implement [PhysicsCallbacks.IBodyUpdateCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/ibodyupdatecallback.md) will be called. This will be called automatically if [\_autoBodyUpdateCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autobodyupdatecallbacks.md) is true. This must be called on the main thread. | | [SendContactCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendcontactcallbacks.md) | Send all current [\_contactBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactbeginevents.md) and [\_contactEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/contactendevents.md) where either of the [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md)). These events will only be created if both of the shape pairs has [\_contactEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactevents.md) set to true. Only callback targets that implement [PhysicsCallbacks.IContactCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/icontactcallback.md) will be called. This will be called automatically if [\_autoContactCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autocontactcallbacks.md) is true. This must be called on the main thread. | | [SendJointThresholdCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendjointthresholdcallbacks.md) | Send all current [\_jointThresholdEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/jointthresholdevents.md) where the [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/callbacktarget.md)). These events will only be created if the joint exceeds its [\_forceThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/forcethreshold.md) or [\_torqueThreshold](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/torquethreshold.md). Only callback targets that implement [PhysicsCallbacks.IJointThresholdCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/ijointthresholdcallback.md) will be called. This will be called automatically if [\_autoJointThresholdCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autojointthresholdcallbacks.md) is true. This must be called on the main thread. | | [SendTriggerCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/sendtriggercallbacks.md) | Send all current [\_triggerBeginEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerbeginevents.md) and [\_triggerEndEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/triggerendevents.md) where either of the [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md) involved are valid (see [\_isValid](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/isvalid.md)) and have a callback target assigned (see [\_callbackTarget](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/callbacktarget.md)). These events will only be created if one of the shape pairs has [\_triggerEvents](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/triggerevents.md) set to true. Only callback targets that implement [PhysicsCallbacks.ITriggerCallback](/engine/6000.5/script-reference/unity/u2d/physics/physicscallbacks/itriggercallback.md) will be called. This will be called automatically if [\_autoTriggerCallbacks](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/autotriggercallbacks.md) is true. This must be called on the main thread. | | [SetElementDepth3D](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setelementdepth3d.md) | Set the element depth using the specified 3D position. The relevant axis will be extracted using the current \_transformPlane. If [PhysicsWorld.TransformPlane.Custom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplane/custom.md) is used, the element depth is always set to zero. | | [SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md) | Set the owner object using the specified owner key. You can only set the owner once, multiple attempts will produce a warning. This call does not bind the lifetime of the specified owner object, it is simply a reference. It is also valid to not specify an owner object (NULL) to simply gain an owner key however it can be useful, if simply for debugging purposes and discovery, to know which object is the owner. | | [SetOwnerUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowneruserdata.md) | Set [PhysicsUserData](/engine/6000.5/script-reference/unity/u2d/physics/physicsuserdata.md) that can be used for any purpose, typically by the owner only. | | [Simulate](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulate.md) | Simulate the world. If `deltaTime` is zero then only contact and trigger events will be updated and no velocity or position integration or constraint updates will occur. | | [TestOverlapAABB](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlapaabb.md) | Tests if the provided AABBs potentially overlap any shapes. The overlap is between AABB of shapes in the world therefore it may not result in an exact overlap of any shape itself. See [PhysicsAABB](/engine/6000.5/script-reference/unity/u2d/physics/physicsaabb.md) and [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md). | | [TestOverlapGeometry](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlapgeometry.md) | Tests if the provided Capsule geometry overlaps any shapes. See [CapsuleGeometry](/engine/6000.5/script-reference/unity/u2d/physics/capsulegeometry.md) and [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md). | | [TestOverlapPoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlappoint.md) | Tests if the provided point(s) overlap any shapes. See [PhysicsQuery.QueryFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsquery/queryfilter.md). | | [TestOverlapShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlapshape.md) | Tests if the provided shape overlaps any shapes. The selected shape is excluded from any results and must be in this world otherwise a warning will be produced. | | [TestOverlapShapeProxy](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/testoverlapshapeproxy.md) | Test if the provided shape proxies overlaps any shapes. | ## Static Methods | Method | Description | | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [CheckTransformChanges](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/checktransformchanges.md) | Checks for any transform changes. Anything using [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md) will immediately be notified of any changes. This should be used sparingly otherwise it may impact performance. The preference should be not using this but instead control transform changes to be monitored with \_transformChangeMode. | | [Create](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/create.md) | Create a PhysicsWorld using the [\_defaultDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsworlddefinition/defaultdefinition.md). | | [CreateOwnerKey](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/createownerkey.md) | Create an owner key. | | [DestroyBodyBatch](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/destroybodybatch.md) | Destroy a batch of bodies. Any invalid bodies will be ignored. Owned bodies will produce a warning and will not be destroyed (See [PhysicsBody.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/setowner.md)). | | [DestroyJointBatch](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/destroyjointbatch.md) | Destroy a batch of joints. Any invalid joints will be ignored. Owned joints will produce a warning and will not be destroyed ([PhysicsJoint.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint/setowner.md)). | | [DestroyShapeBatch](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/destroyshapebatch.md) | Destroy a batch of shapes, destroying all [PhysicsShape.Contact](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contact.md) the shapes are involved in. Any invalid shapes will be ignored including chain segment shapes created via a [PhysicsChain](/engine/6000.5/script-reference/unity/u2d/physics/physicschain.md) (the chain must be destroyed)." Owned shapes will produce a warning and will not be destroyed ([PhysicsShape.SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/setowner.md)). See [PhysicsBody.MassConfiguration](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody/massconfiguration.md). | | [GetWorlds](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/getworlds.md) | Get all the active [PhysicsWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld.md). This includes the [\_defaultWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/defaultworld.md) so will always contain at least a single world. | | [RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md) | Register a transform watcher to call the specified callback when a transform changes. See [PhysicsEvents.TransformChangeEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformchangeevent.md) for the types of transform changes that are watched for. | | [SetOwner](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/setowner.md) | Set the owner object using the specified owner key. You can only set the owner once, multiple attempts will produce a warning. This call does not bind the lifetime of the specified owner object, it is simply a reference. Whilst it is valid to not specify an owner object (NULL), it is recommended for debugging purposes. | | [SetTransform](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/settransform.md) | Set the [Transform](/engine/6000.5/script-reference/unityengine/transform.md) position without causing a [PhysicsEvents.TransformChangeEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformchangeevent.md) to be generated by default. See [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md). | | [SetTransformAccess](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/settransformaccess.md) | Set the [TransformAccess](/engine/6000.5/script-reference/unityengine/jobs/transformaccess.md) position without causing a [PhysicsEvents.TransformChangeEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformchangeevent.md) to be generated. See [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md). | | [Simulate](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulate.md) | Simulate a batch of worlds. If `deltaTime` is zero then only contact and trigger events will be updated and no velocity or position integration or constraint updates will occur. The worlds can be simulated concurrently depending on the setting of [\_concurrentSimulations](/engine/6000.5/script-reference/unity/u2d/physics/physicscoresettings2d/concurrentsimulations.md). | | [UnregisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/unregistertransformchange.md) | Unregister a transform watched to stop calling the specified callback when a transform changes. See [PhysicsEvents.TransformChangeEvent](/engine/6000.5/script-reference/unity/u2d/physics/physicsevents/transformchangeevent.md) for the types of transform changes that are watched for. | ## Structs | Struct | Description | | --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [PhysicsWorld.DrawColors](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcolors.md) | The colors used to draw [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md), [PhysicsShape](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape.md), [PhysicsJoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsjoint.md) etc. | | [PhysicsWorld.DrawResults](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawresults.md) | The draw results retrieved from the world. You must immediately extract what information you need and not directly reference the returned data as it will be cleared immediately after being provided. | | [PhysicsWorld.ExplosionDefinition](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/explosiondefinition.md) | Used to define the parameters when using [PhysicsWorld.Explode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/explode.md). | | [PhysicsWorld.TransformPlaneCustom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplanecustom.md) | A transformation applied to the transform write if \_transformPlane is set to [PhysicsWorld.TransformPlane.Custom](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplane/custom.md). | | [PhysicsWorld.WorldCapacity](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/worldcapacity.md) | Describes the expected world capacities used to presize internal allocations when a [PhysicsWorld](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld.md) is created. All counts default to zero, in which case the engine uses its own minimum defaults. Every count is in the range zero to 65535 and any value outside that range is clamped into it. | | [PhysicsWorld.WorldCounters](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/worldcounters.md) | PhysicsWorld counters that give details of the world simulation size. | | [PhysicsWorld.WorldProfile](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/worldprofile.md) | PhysicsWorld profile that contains the timings of specific world simulation stages. All times are in milliseconds. | ## Enums | Enum | Description | | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [PhysicsWorld.DrawContactType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawcontacttype.md) | Controls which properties of a [PhysicsShape.ContactManifold.ManifoldPoint](/engine/6000.5/script-reference/unity/u2d/physics/physicsshape/contactmanifoldmanifoldpoint.md) are drawn when drawing contact points. | | [PhysicsWorld.DrawFillOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawfilloptions.md) | Controls how shape geometry is filled when drawing. | | [PhysicsWorld.DrawOptions](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/drawoptions.md) | Draw Options limits what gets drawn to a broad selection. | | [PhysicsWorld.IgnoreFilter](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/ignorefilter.md) | A ignore flags are a narrow selection of objects/types in the world which needs to be ignored. | | [PhysicsWorld.RenderingMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/renderingmode.md) | Controls drawing and rendering is allowed. | | [PhysicsWorld.SimulationType](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/simulationtype.md) | Defines when the simulation will run. | | [PhysicsWorld.TransformChangeMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformchangemode.md) | Defines when changes to [Transform](/engine/6000.5/script-reference/unityengine/transform.md) that are registered with [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md) are called. | | [PhysicsWorld.TransformChangeReason](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformchangereason.md) | Defines the reason why a [Transform](/engine/6000.5/script-reference/unityengine/transform.md) changed. Register and unregister for transform changes with [PhysicsWorld.RegisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/registertransformchange.md) and [PhysicsWorld.UnregisterTransformChange](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/unregistertransformchange.md). | | [PhysicsWorld.TransformPlane](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformplane.md) | Defines the 2D Transform plane where Transform writes will occur. This also defines the rotation axis which will automatically be perpendicular to the selected plane. See \_transformPlane. | | [PhysicsWorld.TransformTweenMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformtweenmode.md) | Defines if and how Transform tweens are calculated and/or written. | | [PhysicsWorld.TransformWriteMode](/engine/6000.5/script-reference/unity/u2d/physics/physicsworld/transformwritemode.md) | Defines how the 2D Transforms from each [PhysicsBody](/engine/6000.5/script-reference/unity/u2d/physics/physicsbody.md) are written to the 3D Transform system. |