Система Ragdoll


Начиная с версии 3.1, Godot поддерживает физику тряпичных кукол(ragdolls). Куклы зависят от симуляции физики для создания реалистичной процедурной анимации. Они используются для анимаций смерти во многих играх.

В этом руководстве, мы будем использовать пример Platformer3D для установки ragdoll.


Вы можете скачать пример Platformer3D с GitHub или использовать Библиотеку Ассетов.

Настройка куклы

Создание физических костей

Как во многих других возможностях в движке, существует узел для установки рэгдолла: узел PhysicalBone. Для упрощения настройки, вы можете создать узлы PhysicalBone через возможность "Создать физический скелет" в узле скелетона.

Open the platformer demo in Godot, and then the Robi scene. Select the Skeleton node. A skeleton button appears on the top bar menu:


Click it and select the Create physical skeleton option. Godot will generate PhysicalBone nodes and collision shapes for each bone in the skeleton and pin joints to connect them together:


Some of the generated bones aren't necessary: the MASTER bone for example. So we're going to clean up the skeleton by removing them.

Cleaning up the skeleton

Each PhysicalBone the engine needs to simulate has a performance cost, so you want to remove every bone that is too small to make a difference in the simulation, as well as all utility bones.

For example, if we take a humanoid, you do not want to have physical bones for each finger. You can use a single bone for the entire hand instead, or one for the palm, one for the thumb, and a last one for the other four fingers.

Remove these physical bones: MASTER, waist, neck, headtracker. This gives us an optimized skeleton and makes it easier to control the ragdoll.

Collision shape adjustment

The next task is adjusting the collision shape and the size of physical bones to match the part of the body that each bone should simulate.


Joints adjustment

Once you adjusted the collision shapes, your ragdoll is almost ready. You just want to adjust the pin joints to get a better simulation. PhysicalBone nodes have an unconstrained pin joint assigned to them by default. To change the pin joint, select the PhysicalBone and change the constraint type in the Joint section. There, you can change the constraint's orientation and its limits.


Это и есть финальный результат:


Simulating the ragdoll

The ragdoll is now ready to use. To start the simulation and play the ragdoll animation, you need to call the physical_bones_start_simulation method. Attach a script to the skeleton node and call the method in the _ready method:

func _ready():

To stop the simulation, call the physical_bones_stop_simulation() method.


You can also limit the simulation to only a few bones. To do so, pass the bone names as a parameter. Here's an example of partial ragdoll simulation:


Collision layer and mask

Make sure to set up your collision layers and masks properly so the KinematicBody's capsule doesn't get in the way of the physics simulation:


For more information, read Collision layers and masks.