Auto Ragdoll is an editor plugin for Godot 4 that streamlines the creation of 3D physical ragdolls (PhysicalBone3D nodes and constraints) from any Skeleton3D node.

The plugin is designed to work best with humanoid character skeletons, automating the tedious manual setup of physical bones, collision shapes, mass calculations, and joint rotation limits.

Features

• Automated Humanoid Rig Detection: Automatically identifies, parses, and maps bones from common naming conventions without manual configuration:
  • Mixamo: Standard prefixes (mixamorig:Hips, mixamorig:LeftUpLeg, etc.).
  • Blender (Standard): Suffix-based naming (.L/.R, _L/_R, e.g. thigh.L, upper_arm.L).
  • Blender (Rigify / metarig): Deformation bones (DEF-thigh.L, def_arm.L, etc.).
  • Other Humanoid Standards: Character Creator (cc_base_), Valve Biped (bip01_), VRM.
• Interactive Setup Wizard: Visual dialog interface inspired by classic ragdoll tools for inspecting, assigning, and overriding bone slots with a searchable bone picker.
• Biomechanical Mass Distribution: Distributes total body mass realistically across body segments based on published biomechanical data (Plagenhoef et al., 1983).
• Preconfigured Joint Constraints: Automatically generates Generic6DOFJoint3D constraints for complex articulation (spine, shoulders, hips, neck, wrists) and HingeJoint3D constraints with realistic limits for elbows and knees.
• Synchronized Mirror Shapes: Left and right limb collision shape resources are linked, so adjusting dimensions in the Inspector updates both sides simultaneously.

How to Enable

1. Place the addons/ragdoll_generator folder into your project's addons/ directory.
2. In the Godot Editor, navigate to Project -> Project Settings... -> Plugins.
3. Locate Ragdoll Generator and check Enable.

How to Use

1. Select any character Skeleton3D node in the Scene dock.
2. Click the Skeleton3D context menu in the top 3D Viewport toolbar and choose Create Ragdoll.
3. Verify or adjust the assigned bone slots in the wizard.
4. Set your desired Total Mass (kg) and options, then click Create Ragdoll.