Skip to content

Menu Reference

All items found in the Ragdoll menu at the top of Maya's main window.

Add menu items to your shelf with Ctrl + Shift + Click


Overview

Item Description
Show Messages Display warnings and errors in the Message Board
Active Rigid Customise the creation of a new rigid body.
Active Chain Create a series of connected rigid bodies.
Passive Rigid Customise the creation of a new passive rigid body.
Muscle Make a muscle from the selected anchor points.
Constraint Constrain one rigid to another.
Point Constrain the position of two rigid bodies.
Orient Constrain the orientation of two rigid bodies.
Parent Constrain both the position and orientation of two rigid bodies.
Hinge A special kind of Socket Constraint
Socket Constrain the position and limit the orientation between two rigid bodies.
Ignore Contacts Ignore contacts between the two selected rigids.
Animation Constraint Convert translate/rotate channels into a target guide.
Hard Pin Pin a rigid body in worldspace.
Soft Pin Pin a rigid body in worldspace, with a spring-like softness.
Mimic Generate a target control hierarchy for the simulation to follow.
Push Push rigids away from a point in space.
Pull Pull rigids towards a point in space.
Directional Like gravity, except in any arbitrary direction.
Wind Create a force similar to wind, with editable turbulence.
Visualiser Visualise 3D forces with a 2D slice, much like an MRI.

Assign Force to Selected Rigid(s)
Assign force to the selected rigids.
Character Generate a character from the selected joint hierarchy.
Create Dynamic Control Create a new dynamic control from the currently selected regular control(s).
Multiply Selected Multiply keyable attributes on multiple physics objects at once.
Multiply Selected Rigids Multiply keyable attributes on multiple rigid at once.
Multiply Selected Constraints Multiply keyable attributes on multiple constraints at once.
Bake Simulation Convert a live simulation into editable keyframes.
Export Physics Save physics to disk.
Import Physics Load physics from disk.
Combine Scenes Combine two or more scenes into one.
Extract Rigids Extract rigids into new scene.
Move Rigids Move rigids into existing scene.
Replace Mesh Replace input of the 'Mesh' shape type with another polygonal or NURBS mesh.
Freeze Exclude selected node from Maya's Parallel Evaluation.
Unfreeze Undo the effect of freezing evaluation.
Edit Constraint Pivots Edit the parent and child pivots using native Maya transforms
Edit Shape Edit the shape offset and shape rotation attributes with a native Maya transform.
Duplicate Selected Create a new rigid, using the selected rigid as a template for position, orientation and shape.
Transfer Attributes Copy attributes from one rigid body to another.
Convert to Polygons Convert selected rigids and controls into polygons.

Normalise Shapes
Resize shapes within a hierarchy to avoid some being too different.
Set Initial State Re-establish the starting position and orientation of selected rigids.
Clear Initial State Set initial state to creation state.
Delete Physics Clear the Maya scene of anything related to Ragdoll.
Ragdoll Explorer Explore the internals of the solver.
Ragdoll Preferences Edit global Ragdoll preferences, like the scale at which Ragdoll draws things.
Select Invalid Constraints Select constraints without connected rigid bodies.
Save Preferences Save Ragdoll preferences to disk.
Reset Preferences Restore Ragdoll preferences to their default values.
Select Rigids Select all rigids, or filter rigids from selection.
Select Constraints Select all constraints, or filter constraints from selection.
Select Scenes Select all scenes, or filter scenes from selection.
Select Controls Select all controls, or filter controls from selection.
Ragdoll View your version, and eventually look for updates and tutorials. Not yet though.

More
Print all messages you can think of.

Default
Print only messages that may be interesting, but probably aren't.

Less
Don't print anything unless it's something I need to pay attention to.

Off
Stay quiet.





Create

The top part of the menu contain commands to create new rigids.


Active Rigid

The rigid body, this outputs the translate and rotate channels that typically plug into your animation control. It lives as a shape, underneath your control, and is accessible via the Channel Box.

Rigids either output or input a transform. The active rigid outputs a transform, passing information from solver into your Maya scene.

Basics

Basics

Turn any native Maya polygon or NURBS object into a rigid by selecting it and clicking 'Active Rigid'.

Multiple Selection

Multiple Selection

When two or more objects are selected - whether it be polygons, NURBS or joints - they'll all be turned into rigids.

Blend Existing Animation

Blend Existing Animation

If the selected node(s) are animated, the animation can be used as a target for the subsequent simulation using the 'Blend' option.

Blend and Edit

Blend and Edit

Once turned into rigids, your original animation remains intact and can be edited just like before. You can also blend between the original input and final simulation via the blendSimulation node.


Passive Rigid

The passive rigid body feeds data from your animation control to Ragdoll, rather than the other way around like the Active Rigid. It's used to pass animation straight into the solver, without modifying it with forces or contacts. That also means passive rigids can travel straight through other rigids if not careful. You can think of a Passive Rigid as a physical object of infinite mass; nothing gets in its way.

Basics

Basics

Turn any polygonal, NURBS surface or joint into a rigid which can be animated but isn't affected by the simulation.


Muscle

The muscle is a regular Active Rigid with two additional Point Constraints added to either end. The benefit is simply less clicks required.

Option Description Default
Aim Axis Which axis to treat as aim for the resulting muscle.
Up Axis Which axis to treat as the up-axis for the resulting muscle. 1
Flex How much to allow the muscle to contract, from not-at-all to all-the-way. 0.75
Radius Capsule radius, how thick of a muscle to make. 1.0



Constraint

Like normal Maya constraints, these limit the motion of one rigid relative another. For example, the Parent Constraint will make one rigid move as though it was a child of the other, whereas the Point Constraint will only limit position whilst letting orientation roam free.

Option Description Default
Constraint Type The type of constraint created.
Outliner Style Where to put the new constraint, either as (1) a new transform at the root of your Maya scene like nCloth/nHair, (2) a child of the rigid parent like Maya's native constraints or (3) as a shape next to the rdRigid node. 2
Maintain Offset Keep rigids where they are, or snap them together. Offsets can be manipulated with the Edit Constraint Frames menu item. True
Auto Orient Orient constraint automatically by aiming towards the immediate child. Otherwise use the local orientation of the node. True
Guide Strength Include some guide strength with this constraint. 1.0


Point

Constrain the position of two rigid bodies.


Orient

Constrain the orientation of two rigid bodies. This doesn't have a physical equivalent, as you can't have something rotate the same as another object without also having some sort of positional relationship.


Parent

Constrain both the position and orientation of two rigid bodies. Useful for when you need multiple shapes for a single rigid.


Socket

Constrain the position and limit the orientation between two rigid bodies. Useful for things like shoulder and hip joints.


Hinge

A special kind of Socket Constraint where the X-axis (a.k.a. 'twist') is rotated 90 degrees. This constraint is especially well suited for hinge-like appendages, like elbows and knees.


Control

High-level control, either direct (Hard Pin) or indirect (Soft Pin).


Hard Pin

Pin the selected rigid body at its current worldspace position. The pin may be animated and disabled/enabled at run-time.

Option Description Default
No Options


Soft Pin

Guide the selected rigid body towards its current worldspace position. The guide may be animated and disabled/enabled at run-time.

Option Description Default
No Options


Forces

Apply an external force to rigids. Kind of like constraints, except rigids are effected independently instead of relative another rigid.


Push Force

This forces applies a force facing away from a point in space. It can be used for things like explosions.

Option Description Default
No Options


Pull Force

This is technically the same as 'Push', except the opposite. Instead of pushing rigids away from a point in space, rigids are pull towards it. This can be used for effects like black holes, or to simply nudge a rigid in some specific direction.

Option Description Default
No Options


Directional Force

Gravity is computed deep within the solver and isn't technically applied as an external force, but apart form that this force replicates gravity in addition to letting you control the direction.

Option Description Default
No Options


Wind Force

Wind is a complex phenomena. This force applies an iterative, 3D Perlin noise field to rigid bodies and is a great representation of how wind looks and acts in the real world. Use 'Visualiser' to get a sense of how it looks.

Option Description Default
No Options


Visualiser

This creates a 2-dimensonal representation of either all or selected 3-dimensional forces. The slice can be moved and scaled just like any normal Maya transform, and the amount and length of samples can be manipulated (and even animated) interactively to get a fine-grained understanding of what your forces do to each rigid. Hint: Create multiple slices at various strategic locations in your scene to get an even greater understanding at specific areas.

Option Description Default
No Options


Assign To Selected

Forces are typically assigned to all existing rigids when created, or to the currently selected rigids. This command lets you add forces to rigids manually. Forces can be removed by breaking their connection to each other.

Option Description Default
No Options


Utilities

High-level tools for animators and riggers that build upon the lower-level concepts above. Everything here can be created manually using a combination of the above commands or by making the connections yourself.


Character

An auto-rigger, designed to automatically generate an animatable character from a skeletal hierarchy.

Option Description Default
Copy Turn a copy of the selected hierarchy into a character, rather than the hierarchy itself. True
Control Create an additional control hierarchy from generated character. True
Normalise Shapes Make sure shapes are relatively evenly sized. This can help prevent 'stick-figures' which are tougher to control.
Stop Behaviour Whether to include the joint with a 'Stop' label in the generated character or not.


Dynamic Control

Turn your regular character animation control into a rigid body, where the input animation is used as a dynamic guide for the simulation. The animation remains editable and the final result can be switched or blended between.

Option Description Default
Basics

Basics

Turn any FK hierarchy into a dynamic chain.

Every other control

Every other control

Skip some FK controls, for a simplified dynamic hierarchy.


Global Preferences

Edit the scale of manipulators and visual elements of Ragdoll, especially constriants. If you work at a scale other than Maya's currently set units, this command is your friend.

Option Description Default
Draw Scale Scale at which to draw viewport widgets, like constraints. 1.0
Scene Scale (Requires plug-in reload) Internal tolerances to use when computing convex meshes and some forces, default is 0.1 meaning things are assumed 10x smaller than real-world scale e.g. a character is 17 cm tall. 10.0
Cache Media Cache clips in the timeline, for immediate feedback when scroll.
- Off Fast, interactive but no scrubbing.
- On Slow scrubbing support.
- All Interactive scrubbing at the expense of RAM.
Frameskip Handling What should Ragdoll do when one or more frames are skipped? Should Ragdoll pause simulation until you revisit the last-known frame? Or just pretend everything is OK, and produce garbage values? 1
Auto Initial State (Requires scene reopen) Whether or not to use the pose of a rigid at the start time as the active initial state. This feature records the pose from frame 1 at frame 2, by inserting itself in between finished evaluation of frame 1 and yet-to-begin evaluation of frame 2. True
Auto Return To Start Automatically return to the start frame whenever creating new rigid bodies. True
Cycle Protection Protect against accidental cycles. True
DG Viewport Fix Improve viewport robustness when simulating in DG Evaluation mode, by calling ogs -reset on the start frame. Bear in mind this action is global to Maya and may negatively (or positively) affect other nodes in your scene.
Maya 2018 Consolidate World Fix Work around a limitation in Maya 2018 to better support rigid textures and sleep rendering. True
Fix right-click menu on joints with a rigid When joints have a shape, such as a rigid body, the right-click menu breaks when wanting to 'Select Influence'. This fixes that, but may cause issues elsewhere since it modifies the Maya native context menu for joints. Disable this if it causes any other inconvenience. True
Validate Evaluation Mode Check whether Maya is evaluating in Parallel or Serial whenever creating a new scene, as DG is slow and error-prone. True
Validate Caching Mode Check whether Maya is caching dynamics, which is required in order for Cached Playback to work with Ragdoll. True
Validate Legacy OpenGL Check whether Viewport 2.0 is set to render using Legacy OpenGL. That isn't supported. True
Validate Scale Pivot Check whether the selected transform has a non-zero scalePivot; they are unsupported and will be zeroed out.
Validate Playback Speed Make sure Maya's playback speed is set to 'Play every frame'. True



Help

The Ragdoll user interfaces double as a place for help.

The information is generated from the same source as this website, so as to be available wherever you are; without breaking your flow.

Help Page

ragdollhelp4

The page can also be accessed by clicking on the top description.

ragdollhelpclick

You can find hints about each option by hovering over it.

ragdolllabelhints

Timeline

Available videos regarding any menu item is visible in the UI, to shed more light onto how things work.

ragdolltimeline

Hints

Hovering over the currently playing video displays a description of what it is about.

ragdolltimelinehint


Last update: 2021-07-10