Allow CollisionShape nodes to be indirect children of bodies

[aaronfranke]

EDIT: Note that when this PR was first opened there were some caveats, but those have been resolved now. It should now be fully working including supporting when any node in the tree updates its transform, and should be fast.

Implements and closes godotengine/godot-proposals#535

This PR allows CollisionShape2D and CollisionShape3D nodes to be indirect children of bodies (CollisionObject2D and CollisionObject3D). A shape can only be connected to one body.

This is a highly demanded feature, see the discussion in godotengine/godot-proposals#535, #2174, godotengine/godot-proposals#1049, godotengine/godot-proposals#4559, godotengine/godot-proposals#5746 and https://ask.godotengine.org/31701/possible-rigidbody-have-colliders-that-not-direct-children.

Recently, Eoin from Microsoft has convinced me here that this is a vital feature. While I did debate with him about whether that's something worth standardizing... in terms of just whether the feature is good, I agree with him full stop, I don't see any reason to not have this. It just seems like a universally good idea.

The current code has the CollisionShape(2D/3D) looking for the CollisionObject(2D/3D) by running get_parent() and casting it to CollisionObject(2D/3D). So I made this a loop in the case that this cast fails, continue going up the tree until a body is found. All the code in CollisionObject(2D/3D) already works with a cached body reference and notifies it when things about the shape change like the transform.

Production edit: closes godotengine/godot-roadmap#43

[fire]

What is the workaround for changing the transform of an intermediate node would not cause the shape to update we can document?

Recreate the node?

[aaronfranke]

@fire Changing the transform and changing it back would work. Or maybe we should expose _update_in_shape_owner? EDIT: I have updated this PR to expose update_in_shape_owner.

[fire]

Can't you use the NOTIFICATION_TRANSFORM_CHANGED?

[aaronfranke]

@fire Checking the global transform would cause it to update when the body moves, which would be every frame for some bodies.

[fire]

Was there a bandaid for changing the transform of an intermediate node would not cause the shape to update? What is the most popular behaviour for this case?

[aaronfranke]

@fire Bandaid is I exposed the update method.

Another option would be to have CollisionShape3D detect when it's not a direct child, and if so, listen for the global transform changed notification in addition to local transform changed.

[venilark]

Would this also work for a CharacterBody3D, with colliders inside bone attachments?

edit: also, could a NodePath or a signal be helpful to avoid making the recursive call if they are set up?

[aaronfranke]

@venilark Yes, it will work for shapes in bone attachments.

[venilark]

@aaronfranke
could I still add an Area3D with different layers just to detect other Area3Ds and that wouldn't interfere with the colliders? or would they be treated as part of the main CharacterBody3D and override their layers and masks?

[aaronfranke]

@venilark The shapes will use whatever CollisionObject3D node is their closest ancestor, so if an Area3D node is a closer ancestor than the CharacterBody3D, then the shape will be a part of the Area3D.

I agree with the improvements made since my review

[lyuma]

I think the change is looking much better, and I think most of the performance issues from our original changes have been largely mitigated.

@fire Since you quoted my old comment, Aaron added some mitigations to cache the shape in the owner during PARENTED and preserve the existing state in ENTER_TREE, which is good.

The one thing that is still possibly an issue is that this change is removing the shape from owner in EXIT_TREE, which will trigger during reparent. I understand that this might be necessary for indirect children, but for direct child, I think we should skip the EXIT_TREE logic and perform the remove_shape_from_owner in UNPARENTED, since that is guaranteed to be called for the direct child case

Regarding reduz's comment, the cache should largely reduce the performance impact of the moving nodes. Furthermore, another mitigation was added to subscribe to local transform for direct children and only use NOTIFICATION_TRANSFORM_CHANGE for indirect children, so it is much safer than before, and I think we have done the best we can do for addressing reduz's feedback.

I think overall other than my concern about the direct child case for EXIT_TREE, I'm pretty happy with this and I think most of the performance impact has been mitigated. What can we do to get the necessary reviews in place and unblock this PR?

[venilark]

Feature freeze for 4.6 is around the corner, is there still a chance this will be implemented soon now the performance issues have been resolved?

[mikest]

Sigh. I started working on this, and forgot to check if there is a PR outstanding.

Anything I can do to help move this one along?

[akien-mga]

Anything I can do to help move this one along?

You can help test and review the implementation to confirm that it's the best implementation we can get.

[funkysandwich]

This PR has been extremely useful for me when working with inherited CollisionObject3D scenes.
Using my draft PR #106048 with this, It's possible to import models with collisionshapes only, and reuse them by instancing the imported scenes under different collision body types.

It also helps keep the hierarchy much more organized visually where some models may have a ton of collisionshapes.

I really hope that this PR will be merged.