Escenas, nodos y recursos en Godot: componer comportamiento con una pertenencia bien definida

Tres relaciones que conviene mantener separadas

Una escena reutilizable tiene una jerarquía viva, una definición guardada y referencias a datos. Estas relaciones se solapan, pero responden a preguntas distintas. ¿Qué objetos deben desaparecer juntos? ¿Qué hijos forman parte de la escena guardada? ¿Qué materiales o ajustes pueden compartir varias instancias? Responder a estas preguntas de forma explícita evita que una escena que funciona bien por sí sola se vuelva frágil al integrarse en un juego más grande.

Los nodos organizan el comportamiento en ejecución

Los nodos forman árboles de padres e hijos, y al liberar un padre también se liberan sus hijos. La propiedad owner tiene otra finalidad: identifica quién es el propietario a efectos de guardar la escena y debe apuntar a un ancestro. [1] No uses esa propiedad como sustituto de elegir un padre en tiempo de ejecución. Al escribir herramientas que añaden nodos, define ambas relaciones en lugar de suponer que añadir un hijo completa la configuración de guardado.

Las escenas se instancian; los recursos pueden seguir compartidos

Una PackedScene almacena los datos de la escena y puede instanciar su jerarquía de nodos. [2] Los recursos a los que se hace referencia, como mallas e imágenes, pueden seguir compartidos entre esas instancias. [3] Por lo tanto, un conjunto nuevo de nodos no demuestra que el grafo de objetos sea totalmente independiente. Antes de modificar un recurso, pregúntate si el cambio debe afectar a una sola instancia o a todas las que lo referencian.

Ejemplo: balizas de navegación reparables

Imagina una escena de baliza que contiene una carcasa visible, un área de interacción y un script que lleva el control de la carga de la batería. Coloca tres instancias alrededor de un puerto. Pueden compartir la malla de la carcasa y un recurso de descripción común, mientras que cada script mantiene su propia carga y su estado de reparación. Si dañar una baliza debe cambiar solo el aspecto de su material, crea un material que pertenezca únicamente a esa baliza antes de editar el valor correspondiente. Si una tormenta global cambia deliberadamente el color común de todas las balizas, puede ser adecuado un recurso compartido. Si una herramienta de creación de escenas genera el área de interacción, define también su propietario de escena previsto para que, al guardar y volver a abrir, se conserve el hijo generado.

Límites y verificación

Prueba la escena por sí sola y bajo dos padres distintos. Evita dependencias ocultas de una ruta de ancestros concreta: expón las referencias necesarias o deja que las proporcione la raíz de composición. Instancia dos copias y cambia primero un valor de ejecución y después un valor de un recurso, comprobando si cada efecto se ajusta a la política de pertenencia. Libera una instancia y confirma que la otra sigue funcionando. En las escenas generadas, guarda, vuelve a cargar e inspecciona la jerarquía. La duplicación de recursos y el uso compartido anidado requieren revisión en el nivel correspondiente; duplicar un contenedor externo no garantiza, en general, que cada dependencia referenciada pase a ser única.

Fuentes

1. Node class reference — Godot Engine contributors.
2. PackedScene class reference — Godot Engine contributors.
3. Resources — Godot Engine contributors.