Cenas, nós e recursos no Godot: compor comportamento com responsabilidades bem definidas

Três relações que devem ficar separadas

Uma cena reutilizável tem uma hierarquia viva, uma definição gravada e referências a dados. Essas relações se sobrepõem, mas respondem a perguntas diferentes. Quais objetos devem desaparecer juntos? Quais filhos pertencem à cena gravada? Quais materiais ou configurações várias instâncias podem compartilhar? Responder a essas perguntas de forma explícita evita que uma cena que funciona isoladamente se torne frágil quando é composta dentro de um jogo maior.

Os nós organizam o comportamento em execução

Os nós formam árvores de pai e filho, e liberar um pai também libera seus filhos. A propriedade owner tem outra finalidade: ela identifica a quem pertence o nó para efeitos de gravação da cena e deve referenciar um ancestral. [1] Não use essa propriedade como substituta da escolha do pai em tempo de execução. Ao escrever ferramentas que adicionam nós, defina as duas relações, em vez de supor que adicionar um filho já conclui a configuração de gravação.

Cenas instanciam; recursos podem continuar compartilhados

Um PackedScene armazena os dados da cena e pode instanciar sua hierarquia de nós. [2] Recursos referenciados, como malhas e imagens, podem continuar compartilhados entre essas instâncias. [3] Portanto, um conjunto novo de nós não prova que o grafo de objetos seja totalmente independente. Antes de modificar um recurso, pergunte se a alteração deve afetar uma única instância ou todas as que o referenciam.

Exemplo: balizas de navegação reparáveis

Imagine uma cena de baliza com uma carcaça visível, uma área de interação e um script que controla a carga da bateria. Coloque três instâncias em volta de um porto. Elas podem compartilhar a malha da carcaça e um recurso de descrição comum, enquanto cada script mantém sua própria carga e seu próprio estado de reparo. Se o dano a uma baliza deve alterar apenas a aparência do material dela, crie um material de propriedade exclusiva dessa baliza antes de editar o valor em questão. Se uma tempestade global muda de propósito a cor comum de todas as balizas, um recurso compartilhado pode ser adequado. No caso de uma ferramenta de criação de cenas que gera a área de interação, defina também o dono pretendido da cena, para que o filho gerado seja preservado ao gravar e reabrir.

Limites e verificação

Teste a cena isoladamente e sob dois pais diferentes. Evite dependências ocultas de um caminho de ancestral específico: exponha as referências necessárias ou deixe que a raiz de composição as forneça. Instancie duas cópias e altere um valor de tempo de execução e, depois, um valor de recurso, verificando se cada efeito corresponde à política de propriedade. Libere uma instância e confirme que a outra continua funcionando. Para cenas geradas, grave, recarregue e inspecione a hierarquia. A duplicação de recursos e o compartilhamento aninhado exigem revisão no nível correspondente; duplicar um contêiner externo não é uma garantia geral de que todas as dependências referenciadas se tornem únicas.

Fontes

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