Custom Nodes

This section explains how to work with custom Godot nodes in godot-bevy and the important distinction between automatic markers for built-in Godot types versus custom nodes.

AttachableComponent uses a leaf child node to configure its parent's Bevy entity. The child is consumed after conversion. Choose BevyComponents when the authored node should remain in the scene and receive components on its own entity.

Summary

• Built-in Godot types get automatic markers (e.g., Sprite2DMarker)
• Custom nodes do NOT get automatic markers for their type, but DO inherit base class markers
• Use GodotNode (component-first) to define a Bevy component that generates the Godot class
• Use BevyComponents (Godot-first) to attach Bevy components to a class you write yourself
• Prefer semantic components over generic markers
• Combine base class markers with custom components for powerful queries

This design gives you full control over your ECS architecture while maintaining performance and clarity.