Hinge Joint component reference
Switch to ScriptingThe Hinge Joint groups together two RigidbodiesA component that allows a GameObject to be affected by simulated gravity and other forces. More info
See in Glossary, constraining them to move like they are connected by a hinge. It is perfect for doors, but can also be used to model chains, pendulums, etc.
Properties
| Property: | Function: |
|---|---|
| Connected Body | Optional reference to the Rigidbody that the jointA physics component allowing a dynamic connection between Rigidbody components, usually allowing some degree of movement such as a hinge. More info See in Glossary is dependent upon. If not set, the joint connects to the world. |
| AnchorA UI layout tool that fixes a UI element to a parent element. Anchors are shown as four small triangular handles in the Scene View and anchor information is also shown in the Inspector. More info See in Glossary |
The position of the axis around which the body swings. The position is defined in local space. |
| Axis | The direction of the axis around which the body swings. The direction is defined in local space. |
| Auto Configure Connected Anchor | If this is enabled, then the Connected Anchor position will be calculated automatically to match the global position of the anchor property. This is the default behavior. If this is disabled, you can configure the position of the connected anchor manually. |
| Connected Anchor | Manual configuration of the connected anchor position. |
| Use Spring | Spring makes the Rigidbody reach for a specific angle compared to its connected body. |
| Spring | Properties of the Spring that are used if Use Spring is enabled. |
| Spring | The force the object asserts to move into the position. |
| Damper | The higher this value, the more the object will slow down. |
| Target PositionA joint property to set the target position that the joint’s drive force should move it to. More info See in Glossary |
Target angle of the spring. The spring pulls towards this angle measured in degrees. |
| Use Motor | The motor makes the object spin around. |
| Motor | Properties of the Motor that are used if Use Motor is enabled. |
| Target VelocityA joint property to set the desired velocity with which the joint should move to the Target Position under the drive force. More info See in Glossary |
The speed the object tries to attain. |
| Force | The force applied in order to attain the speed. |
| Free Spin | If enabled, the motor is never used to brake the spinning, only accelerate it. |
| Use Limits | If enabled, the angle of the hinge will be restricted within the Min & Max values. |
| Limits | Properties of the Limits that are used if Use Limits is enabled. |
| Min | The lowest angle the rotation can go. |
| Max | The highest angle the rotation can go. |
| Bounciness | How much the object bounces when it hits the minimum or maximum stop limit. |
| Contact DistanceA joint limit property that sets the minimum distance tolerance between the joint position and the limit at which the limit will be enforced. More info See in Glossary |
Within the contact distance from the limit contacts will persist in order to avoid jitter. |
| Break Force | The force that needs to be applied for this joint to break. |
| Break Torque | The torque that needs to be applied for this joint to break. |
| Enable Collision | When checked, this enables collisionsA collision occurs when the physics engine detects that the colliders of two GameObjects make contact or overlap, when at least one has a Rigidbody component and is in motion. More info See in Glossary between bodies connected with a joint. |
| Enable Preprocessing | Disabling preprocessing helps to stabilize impossible-to-fulfil configurations. |
Details
A single Hinge Joint should be applied to a GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary. The hinge will rotate at the point specified by the Anchor property, moving around the specified Axis property. You do not need to assign a GameObject to the joint’s Connected Body property. You should only assign a GameObject to the Connected Body property if you want the joint’s Transform to be dependent on the attached object’s Transform.
Think about how the hinge of a door works. The Axis in this case is up, positive along the Y axis. The Anchor is placed somewhere at the intersection between door and wall. You would not need to assign the wall to the Connected Body, because the joint will be connected to the world by default.
Now think about a doggy door hinge. The doggy door’s Axis would be sideways, positive along the relative X axis. The main door should be assigned as the Connected Body, so the doggy door’s hinge is dependent on the main door’s Rigidbody.
Chains
Multiple Hinge Joints can also be strung together to create a chain. Add a joint to each link in the chain, and attach the next link as the Connected Body.
Hints
- You do not need to assign a Connected Body to your joint for it to work.
- Use Break Force in order to make dynamic damage systems. You can use this to allow the player to damage the environment (for example, break a door off its hinges by blasting it with a rocket launcher or running into it with a car).
- The Spring, Motor, and Limits properties allow you to fine-tune your joint’s behaviors.
- Use of Spring, Motor are intended to be mutually exclusive. Using both at the same time leads to unpredictable results.
HingeJoint