@export<\/code> para notar que unha variable poda ser modificada dende o editor de maneira visual. De entrada pode valer para equipos grandes nos compa\u00f1eiros que non programan podan modificar o comportamento do xogo, pero ten moitas outras capacidades para dese\u00f1ar a arquitectura dun videoxogo.<\/p>\n\n\n\nEn todos os casos o recomendado \u00e9 consultar a documentaci\u00f3n de Godot<\/a>, pero en resumo, podemos exportar variables do seguitne modo:<\/p>\n\n\n\n@export var velocidade: int = 5\n@export var outro_nodo: Node<\/code><\/pre>\n\n\n\nComo no exemplo anterior, na maior parte dos casos neces\u00edtase definir o tipo de variable e, opcionalmente, inclu\u00edr un valor por defecto.<\/p>\n\n\n\n
Definir relaci\u00f3ns entre nodos<\/h2>\n\n\n\n
Un uso sinxelo para esta funcionalidade que me axudou enormemente a estruturar o noso proxecto foi usar @export<\/code> para definir relaci\u00f3ns entre distintos nodos.<\/p>\n\n\n\nMetarcade, como calquera xogo non trivial, ten diferentes “estados de xogo” como explorar, xogar \u00e1s m\u00e1quinas ou dialogar con outros NPC. No noso caso temos definidos os estados como nodos simples que comparten un pai na xerarqu\u00eda. Como cada estado est\u00e1 asociado a unha interface de usuario distinta, ao principio model\u00e1ramolo como na seguinte imaxe:<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-2.png\")
<\/figure>\n\n\n\nDir\u00eda que se hai un manual de boas pr\u00e1cticas de Godot, mesturar deste xeito na xerarqu\u00eda nodos de distinto tipo estar\u00eda desaconsellado en letras grandes e vermellas. No caso dos nodos de control (en verde) que te\u00f1en propiedades semellantes, como neste caso que todos ocupan a mesma porci\u00f3n de pantalla, o mellor \u00e9 que todos herden do mesmo nodo de control, para as\u00ed s\u00f3 definir estas propiedades com\u00fans unha vez.<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-3.png\")
<\/figure>\n\n\n\nDeste xeito a xerarqu\u00eda ten m\u00e1is sentido, pero a conexi\u00f3n entre o estado “Exploring” e os controis “walking_controls” non me resultaba doado de modelar. De entrada trato de non usar variables globais (autoload en Godot) e facer as conexi\u00f3ns nun script do nodo pai do seguinte modo:<\/p>\n\n\n\n
$StateMachine\/Exploring.control_node = $gui_main\/walking_controls<\/code><\/pre>\n\n\n\nNon s\u00f3 \u00e9 engorroso sen\u00f3n que \u00e9 moi fraxil ao estragarse xa s\u00f3 se os nodos cambian de nome.<\/p>\n\n\n\n
Ata que me percatei de que pod\u00eda facilmente conectar os diferentes nodos con variables exportadas:<\/p>\n\n\n\n
@export var state_controls: Control = null;<\/code><\/pre>\n\n\n\nDeste xeito, basta con arrastrar cada un dos nodos \u00e1 propiedade state_controls<\/code> do estado.<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-4.png\")
<\/figure>\n\n\n\nTipos complexos<\/h2>\n\n\n\n
Unha maneira que temos de simplificar o traballo de dese\u00f1o dos niveis \u00e9 utilizando variables exportadas en nodos xen\u00e9ricos como os das m\u00e1quinas de arcade.<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-5-1024x507.png\")
<\/figure>\n\n\n\nHai un \u00fanico nodo que define a m\u00e1quina e logo exporta variables como o modelo 3D espec\u00edfico, a cor da luz que emite ou a descrici\u00f3n e nome para mostrar nos men\u00fas do xogo.<\/p>\n\n\n\n
Para isto, no canto de exportar todas as variables por separado, creei un tipo de datos novo que as cont\u00e9n e se ve do seguinte modo no editor:<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-6.png\")
<\/figure>\n\n\n\nNon s\u00f3 axuda a organizar as propiedades no men\u00fa (que tam\u00e9n se poder\u00eda facer con @export_subgroup), sen\u00f3n que me permite enviar a outros nodos a informaci\u00f3n en conxunto. Un exemplo \u00e9 o men\u00fa que aparece antes de xogar, que indica t\u00edtulo, descrici\u00f3n e unha imaxe coa m\u00e1quina.<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-7.png\")
<\/figure>\n\n\n\nPara facer isto basta con crear un novo script, definir un class_name<\/strong> e inclu\u00edr todas as variables necesarias. Como consello, no canto de herdar de Node<\/code> recomendar\u00eda usar Resource<\/code> como a clase base, xa que non se utilizar\u00e1 ningunha funcionalidade que non a conte\u00f1a. Hai m\u00e1is informaci\u00f3n sobre esto \u00faltimo na documentaci\u00f3n<\/a>.<\/p>\n\n\n\nNo meu caso, e para o exemplo das m\u00e1quinas de arcade, o script final quedou as\u00ed:<\/p>\n\n\n\n
extends Resource\nclass_name ArcadeMachineData\n@export var machine_name: String = \"Machine Name\"\n@export_multiline var machine_desc: String = \"Empty description\"\n@export var machine_difficulty: int = 10\n@export var machine_mesh: PackedScene = null\n@export var machine_color: Color = Color.WHITE<\/code><\/pre>\n\n\n\n\u00c9 importante destacar deste c\u00f3digo que t\u00f3dalas variables te\u00f1en un valor por defecto. Isto pode ocorrer unha funci\u00f3n _init ou, como enriba, na declaraci\u00f3n das variables. De existir algunha vari\u00e1bel sen valor por defecto, a pesar de ser un recurso totalmente v\u00e1lido, o editor de Godot non ser\u00e1 capaz de mostralo na interface.<\/p>\n\n\n\n
Modificar a escena dende un script<\/h2>\n\n\n\n
Nalg\u00fans casos vai ser c\u00f3modo que os cambios que introducimos a trav\u00e9s dun @export<\/code> se vexan reflexados na escena no momento de cambialos. Para isto podemos marcar o noso script como @tool<\/code>, como explica a documentaci\u00f3n<\/a>.<\/p>\n\n\n\nDeste xeito, se a cor dunha fonte de luz ven definida por unha variable exportada e a cambiamos, poderemos velo directamente na escena mentres a estamos a editar.<\/p>\n\n\n\n
Existe un pequeno problema \u00e1 hora de usar isto para instanciar novas escenas. Cando queremos instanciar unha escena nova, a pesar de facelo na funci\u00f3n _ready<\/code>, os cambios non ser\u00e1n reflectidos directamente no editor, para iso haber\u00e1 que modificar a instancia do seguinte xeito:<\/p>\n\n\n\nnode.owner = get_tree().edited_scene_root<\/code><\/pre>\n\n\n\nNo meu caso, o c\u00f3digo final quedar\u00eda as\u00ed:<\/p>\n\n\n\n
@export var data: ArcadeMachineData = ArcadeMachineData.new()\n\nconst MESH_NODE_NAME = \"arcade-machine\"\n\nfunc _ready():\n if Engine.is_editor_hint():\n instantiate_configured_mesh()\n\nfunc instantiate_configured_mesh():\n var existing_machine = get_node(MESH_NODE_NAME)\n if existing_machine:\n existing_machine.queue_free()\n var instanced_mesh = data.machine_mesh.instantiate()\n add_child(instanced_mesh)\n instanced_mesh.name = MESH_NODE_NAME\n instanced_mesh.owner = get_tree().edited_scene_root<\/code><\/pre>\n\n\n\nE deste xeito podo facilmente configurar c\u00f3mo se ver\u00e1 a escena final.<\/p>\n\n\n\n![\"\"](\"https:\/\/blogs.amarinha.gal\/metarcade_bitacora\/wp-content\/uploads\/sites\/8\/2025\/04\/image-8-1024x526.png\")
<\/figure>\n\n\n\n
\n\n\n\n